sl@0: // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Started by Brendan, January 1996
sl@0: // Descended from HCIMATCH.CPP
sl@0: // Incremental matcher class
sl@0: // 
sl@0: //
sl@0: 
sl@0: #include <bamatch.h>
sl@0: #include <baflpan.h>
sl@0: #include <bamdesca.h>
sl@0: 
sl@0: 
sl@0: 
sl@0: EXPORT_C RTextBuf::RTextBuf()
sl@0: 	: iPtr(NULL,0), iText(NULL)
sl@0: /** Default constructor. */
sl@0: 	{}
sl@0: 
sl@0: 
sl@0: EXPORT_C RTextBuf::~RTextBuf()
sl@0: /** Destructor. */
sl@0: 	{
sl@0: 	Close();
sl@0: 	}
sl@0: 
sl@0: 
sl@0: EXPORT_C void RTextBuf::SetMaxLengthL(TInt aMaxLength)
sl@0: /** Sets the maximum length of the text that the object can store.
sl@0: 
sl@0: Attempts to store text beyond the maximum length cause a panic, as
sl@0: with descriptors. */
sl@0:     {
sl@0:    	__ASSERT_ALWAYS(aMaxLength>0,Panic(EBafPanicTextBufOutOfRange));
sl@0: 	Close();
sl@0: 	iText=new(ELeave) TText[aMaxLength+1];
sl@0: 	iPtr.Set(iText,0,aMaxLength);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void RTextBuf::Close()
sl@0: 	{
sl@0: 	delete [] iText;
sl@0: 	iText=NULL;
sl@0: 	iPtr.Set(NULL,0,0);
sl@0:    	}
sl@0: 
sl@0: // class RIncrMatcherBase
sl@0: 
sl@0: EXPORT_C RIncrMatcherBase::~RIncrMatcherBase()
sl@0: /** Virtual destructor, for reimplementation by derived classes. */
sl@0: 	{}
sl@0: 
sl@0: TBool RIncrMatcherBase::DoIsMatch(const TDesC& aQuery,TCompareFunc aCompare) const
sl@0: 	{
sl@0: 	const TDes& des=MatchDes();
sl@0: 	TInt l=des.Length();
sl@0: 	return l>aQuery.Length() ? EFalse : aCompare(aQuery.Ptr(),l,des.Ptr(),l)==0;
sl@0: 	}
sl@0: 
sl@0: TInt RIncrMatcherBase::DoFirstMatchingIndex(TInt& aIndex,const MDesCArray& aDesArray,TCompareFunc aCompare) const
sl@0: 	{
sl@0: 	TInt noElements=aDesArray.MdcaCount();
sl@0: 	__ASSERT_ALWAYS(aIndex>=0 && aIndex<noElements,Panic(EBafPanicMatcherOutOfRange));
sl@0: 	do
sl@0: 		{
sl@0: 		if (DoIsMatch(aDesArray.MdcaPoint(aIndex),aCompare))
sl@0: 			return KErrNone;
sl@0: 		} while (++aIndex<noElements);
sl@0: 	return KErrNotFound;
sl@0: 	}
sl@0: 
sl@0: void RIncrMatcherBase::DoSetBestMatch(const TDesC& aBuf,TCompareFunc aCompare)
sl@0: 	{
sl@0: 	TDes& des=MatchDes();
sl@0: 	des.SetLength(Min(des.Length(),aBuf.Length()));
sl@0: 	while (!DoIsMatch(aBuf,aCompare))
sl@0: 		DeleteLastChar();
sl@0: 	}
sl@0: 
sl@0: 
sl@0: EXPORT_C TBool RIncrMatcherBase::IsMatch(const TDesC& aQuery) const
sl@0: /**Tests for match, using a binary comparison.
sl@0: 
sl@0: @param aQuery Text to match
sl@0: @return  ETrue if match found, else EFalse */
sl@0:     {
sl@0: 	return DoIsMatch(aQuery,Mem::Compare);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: EXPORT_C TBool RIncrMatcherBase::IsMatchC(const TDesC& aQuery) const
sl@0: /** Tests for match, using locale collation rules.
sl@0: 
sl@0: @param aQuery  Text to match
sl@0: @return ETrue if match found, else EFalse */
sl@0:     {
sl@0: 	return DoIsMatch(aQuery,Mem::CompareC);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TBool RIncrMatcherBase::IsMatchF(const TDesC& aQuery) const
sl@0: /** Tests for match, using locale folding rules.
sl@0: 
sl@0: @param    aQuery  Text to match
sl@0: @return  ETrue if match found, else EFalse */
sl@0: 	{
sl@0: 	return DoIsMatch(aQuery,Mem::CompareF);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt RIncrMatcherBase::FirstMatchingIndex(TInt& aResultIndex,const MDesCArray& aDesArray,TInt aStartIndex) const
sl@0: /** Finds the first match in an array, using a binary comparison.
sl@0: 
sl@0: @param aResult On return, index of the first match in aDesArray 
sl@0: @param aDesArray  Array of descriptors to search
sl@0: @param aStartIndex Index of aDesArray at which to begin  search
sl@0: @return  KErrNone if success or KErrNotFound if no match is found */
sl@0: 	{
sl@0: 	aResultIndex=aStartIndex;
sl@0: 	return DoFirstMatchingIndex(aResultIndex,aDesArray,Mem::Compare);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt RIncrMatcherBase::FirstMatchingIndexC(TInt& aResultIndex,const MDesCArray& aDesArray,TInt aStartIndex) const
sl@0: /** Finds the first match in an array, using locale collation rules.
sl@0: 
sl@0: @param aResult  On return, index of the first match in aDesArray 
sl@0: @param aDesArray Array of descriptors to search
sl@0: @param aStartIndex Index of aDesArray  at which to begin search
sl@0: @return  KErrNone if success or KErrNotFound if no match is found */
sl@0:     {
sl@0: 	aResultIndex=aStartIndex;
sl@0: 	return DoFirstMatchingIndex(aResultIndex,aDesArray,Mem::CompareC);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TInt RIncrMatcherBase::FirstMatchingIndexF(TInt& aResultIndex,const MDesCArray& aDesArray,TInt aStartIndex) const
sl@0: /** Finds the first match in an array, using locale folding rules.
sl@0: 
sl@0: @param aResult  On return, index of the first match in aDesArray
sl@0: @param     aDesArray Array of descriptors to search
sl@0: @param     aStartIndex Index of aDesArray at which to begin search
sl@0: @return  KErrNone if success or KErrNotFound if no match is found */
sl@0:     {
sl@0: 	aResultIndex=aStartIndex;
sl@0: 	return DoFirstMatchingIndex(aResultIndex,aDesArray,Mem::CompareF);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void RIncrMatcherBase::SetBestMatch(const TDesC& aBuf)
sl@0: /** Sets the match text to the best match between the match text and the passed 
sl@0: buffer, using a binary comparision.
sl@0: 
sl@0: For example, if the original match text is "goose" and the passed buffer is 
sl@0: "gooSE", the match text would be changed to "goo".
sl@0: 
sl@0: @param aBuf Text to match */
sl@0: 	{
sl@0: 	DoSetBestMatch(aBuf,Mem::Compare);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void RIncrMatcherBase::SetBestMatchC(const TDesC& aBuf)
sl@0: /** Sets the match text to the best match between the match text and the passed 
sl@0: buffer, using locale collation rules.
sl@0: 
sl@0: @param aBuf Text to match */
sl@0: 	{
sl@0: 	DoSetBestMatch(aBuf,Mem::CompareC);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void RIncrMatcherBase::SetBestMatchF(const TDesC& aBuf)
sl@0: /** Sets the match text to the best match between the match text and the passed 
sl@0: buffer, using locale folding rules.
sl@0: 
sl@0: @param aBuf Text to match */
sl@0: 	{
sl@0: 	DoSetBestMatch(aBuf,Mem::CompareF);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void RIncrMatcherBase::AppendChar(TChar aLetter)
sl@0: /** Appends a character to the end of the match text.
sl@0: 
sl@0: @param aLetter Character to append */
sl@0: 	{
sl@0: 	TDes& des=MatchDes();
sl@0: 	__ASSERT_ALWAYS(des.Length()<des.MaxLength(),Panic(EBafPanicMatcherOutOfRange));
sl@0: 	des.Append(aLetter);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C void RIncrMatcherBase::DeleteLastChar()
sl@0: /** Deletes the final character in the match text. */
sl@0: 	{
sl@0: 	TDes& des=MatchDes();
sl@0: 	TInt l=des.Length();
sl@0: 	if (--l>=0)
sl@0: 		{
sl@0: 		des[l]=0;
sl@0: 		des.SetLength(l);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: EXPORT_C RIncrMatcherPtr::RIncrMatcherPtr()
sl@0:     : iDesPtr(NULL)
sl@0: /** Default constructor. */
sl@0:     {
sl@0:     }
sl@0: 
sl@0: EXPORT_C RIncrMatcherPtr::RIncrMatcherPtr(TDes& aDes)
sl@0:     : iDesPtr(&aDes)
sl@0: /** Constructor that initialises the object with the text to be matched against.
sl@0: 
sl@0: @param aDes Text to be matched against */
sl@0:     {
sl@0:     }
sl@0: 
sl@0: EXPORT_C RIncrMatcherPtr::~RIncrMatcherPtr()
sl@0: /** Destructor. */
sl@0:     {
sl@0:     }
sl@0: 
sl@0: EXPORT_C TDes& RIncrMatcherPtr::MatchDes()
sl@0: /** Gets the match text.
sl@0: 
sl@0: @return Match text */
sl@0:     {
sl@0:     return(*iDesPtr);
sl@0:     }
sl@0: 
sl@0: EXPORT_C const TDes& RIncrMatcherPtr::MatchDes() const
sl@0: /** Gets the match text.
sl@0: 
sl@0: @return Match text */
sl@0:     {
sl@0:     return(*iDesPtr);
sl@0:     }
sl@0: 
sl@0: 
sl@0: EXPORT_C RIncrMatcherTextBuf::RIncrMatcherTextBuf()
sl@0: /** Default constructor. */
sl@0:     {
sl@0:     }
sl@0: 
sl@0: EXPORT_C RIncrMatcherTextBuf::~RIncrMatcherTextBuf()
sl@0: /** Destructor.*/
sl@0:     {
sl@0:     }
sl@0: 
sl@0: EXPORT_C TDes& RIncrMatcherTextBuf::MatchDes()
sl@0: /** Gets the match text.
sl@0: 
sl@0: @return Match text */
sl@0:     {
sl@0:     return(iTextBuf.Text());
sl@0:     }
sl@0: 
sl@0: EXPORT_C const TDes& RIncrMatcherTextBuf::MatchDes() const
sl@0: /** Gets the match text.
sl@0: 
sl@0: @return Match text */
sl@0:    {
sl@0:     return(iTextBuf.Text());
sl@0:     }