1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/ossrv/lowlevellibsandfws/apputils/src/BAMATCH.CPP Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,268 @@
1.4 +// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +// Started by Brendan, January 1996
1.18 +// Descended from HCIMATCH.CPP
1.19 +// Incremental matcher class
1.20 +//
1.21 +//
1.22 +
1.23 +#include <bamatch.h>
1.24 +#include <baflpan.h>
1.25 +#include <bamdesca.h>
1.26 +
1.27 +
1.28 +
1.29 +EXPORT_C RTextBuf::RTextBuf()
1.30 + : iPtr(NULL,0), iText(NULL)
1.31 +/** Default constructor. */
1.32 + {}
1.33 +
1.34 +
1.35 +EXPORT_C RTextBuf::~RTextBuf()
1.36 +/** Destructor. */
1.37 + {
1.38 + Close();
1.39 + }
1.40 +
1.41 +
1.42 +EXPORT_C void RTextBuf::SetMaxLengthL(TInt aMaxLength)
1.43 +/** Sets the maximum length of the text that the object can store.
1.44 +
1.45 +Attempts to store text beyond the maximum length cause a panic, as
1.46 +with descriptors. */
1.47 + {
1.48 + __ASSERT_ALWAYS(aMaxLength>0,Panic(EBafPanicTextBufOutOfRange));
1.49 + Close();
1.50 + iText=new(ELeave) TText[aMaxLength+1];
1.51 + iPtr.Set(iText,0,aMaxLength);
1.52 + }
1.53 +
1.54 +EXPORT_C void RTextBuf::Close()
1.55 + {
1.56 + delete [] iText;
1.57 + iText=NULL;
1.58 + iPtr.Set(NULL,0,0);
1.59 + }
1.60 +
1.61 +// class RIncrMatcherBase
1.62 +
1.63 +EXPORT_C RIncrMatcherBase::~RIncrMatcherBase()
1.64 +/** Virtual destructor, for reimplementation by derived classes. */
1.65 + {}
1.66 +
1.67 +TBool RIncrMatcherBase::DoIsMatch(const TDesC& aQuery,TCompareFunc aCompare) const
1.68 + {
1.69 + const TDes& des=MatchDes();
1.70 + TInt l=des.Length();
1.71 + return l>aQuery.Length() ? EFalse : aCompare(aQuery.Ptr(),l,des.Ptr(),l)==0;
1.72 + }
1.73 +
1.74 +TInt RIncrMatcherBase::DoFirstMatchingIndex(TInt& aIndex,const MDesCArray& aDesArray,TCompareFunc aCompare) const
1.75 + {
1.76 + TInt noElements=aDesArray.MdcaCount();
1.77 + __ASSERT_ALWAYS(aIndex>=0 && aIndex<noElements,Panic(EBafPanicMatcherOutOfRange));
1.78 + do
1.79 + {
1.80 + if (DoIsMatch(aDesArray.MdcaPoint(aIndex),aCompare))
1.81 + return KErrNone;
1.82 + } while (++aIndex<noElements);
1.83 + return KErrNotFound;
1.84 + }
1.85 +
1.86 +void RIncrMatcherBase::DoSetBestMatch(const TDesC& aBuf,TCompareFunc aCompare)
1.87 + {
1.88 + TDes& des=MatchDes();
1.89 + des.SetLength(Min(des.Length(),aBuf.Length()));
1.90 + while (!DoIsMatch(aBuf,aCompare))
1.91 + DeleteLastChar();
1.92 + }
1.93 +
1.94 +
1.95 +EXPORT_C TBool RIncrMatcherBase::IsMatch(const TDesC& aQuery) const
1.96 +/**Tests for match, using a binary comparison.
1.97 +
1.98 +@param aQuery Text to match
1.99 +@return ETrue if match found, else EFalse */
1.100 + {
1.101 + return DoIsMatch(aQuery,Mem::Compare);
1.102 + }
1.103 +
1.104 +
1.105 +EXPORT_C TBool RIncrMatcherBase::IsMatchC(const TDesC& aQuery) const
1.106 +/** Tests for match, using locale collation rules.
1.107 +
1.108 +@param aQuery Text to match
1.109 +@return ETrue if match found, else EFalse */
1.110 + {
1.111 + return DoIsMatch(aQuery,Mem::CompareC);
1.112 + }
1.113 +
1.114 +EXPORT_C TBool RIncrMatcherBase::IsMatchF(const TDesC& aQuery) const
1.115 +/** Tests for match, using locale folding rules.
1.116 +
1.117 +@param aQuery Text to match
1.118 +@return ETrue if match found, else EFalse */
1.119 + {
1.120 + return DoIsMatch(aQuery,Mem::CompareF);
1.121 + }
1.122 +
1.123 +EXPORT_C TInt RIncrMatcherBase::FirstMatchingIndex(TInt& aResultIndex,const MDesCArray& aDesArray,TInt aStartIndex) const
1.124 +/** Finds the first match in an array, using a binary comparison.
1.125 +
1.126 +@param aResult On return, index of the first match in aDesArray
1.127 +@param aDesArray Array of descriptors to search
1.128 +@param aStartIndex Index of aDesArray at which to begin search
1.129 +@return KErrNone if success or KErrNotFound if no match is found */
1.130 + {
1.131 + aResultIndex=aStartIndex;
1.132 + return DoFirstMatchingIndex(aResultIndex,aDesArray,Mem::Compare);
1.133 + }
1.134 +
1.135 +EXPORT_C TInt RIncrMatcherBase::FirstMatchingIndexC(TInt& aResultIndex,const MDesCArray& aDesArray,TInt aStartIndex) const
1.136 +/** Finds the first match in an array, using locale collation rules.
1.137 +
1.138 +@param aResult On return, index of the first match in aDesArray
1.139 +@param aDesArray Array of descriptors to search
1.140 +@param aStartIndex Index of aDesArray at which to begin search
1.141 +@return KErrNone if success or KErrNotFound if no match is found */
1.142 + {
1.143 + aResultIndex=aStartIndex;
1.144 + return DoFirstMatchingIndex(aResultIndex,aDesArray,Mem::CompareC);
1.145 + }
1.146 +
1.147 +EXPORT_C TInt RIncrMatcherBase::FirstMatchingIndexF(TInt& aResultIndex,const MDesCArray& aDesArray,TInt aStartIndex) const
1.148 +/** Finds the first match in an array, using locale folding rules.
1.149 +
1.150 +@param aResult On return, index of the first match in aDesArray
1.151 +@param aDesArray Array of descriptors to search
1.152 +@param aStartIndex Index of aDesArray at which to begin search
1.153 +@return KErrNone if success or KErrNotFound if no match is found */
1.154 + {
1.155 + aResultIndex=aStartIndex;
1.156 + return DoFirstMatchingIndex(aResultIndex,aDesArray,Mem::CompareF);
1.157 + }
1.158 +
1.159 +EXPORT_C void RIncrMatcherBase::SetBestMatch(const TDesC& aBuf)
1.160 +/** Sets the match text to the best match between the match text and the passed
1.161 +buffer, using a binary comparision.
1.162 +
1.163 +For example, if the original match text is "goose" and the passed buffer is
1.164 +"gooSE", the match text would be changed to "goo".
1.165 +
1.166 +@param aBuf Text to match */
1.167 + {
1.168 + DoSetBestMatch(aBuf,Mem::Compare);
1.169 + }
1.170 +
1.171 +EXPORT_C void RIncrMatcherBase::SetBestMatchC(const TDesC& aBuf)
1.172 +/** Sets the match text to the best match between the match text and the passed
1.173 +buffer, using locale collation rules.
1.174 +
1.175 +@param aBuf Text to match */
1.176 + {
1.177 + DoSetBestMatch(aBuf,Mem::CompareC);
1.178 + }
1.179 +
1.180 +EXPORT_C void RIncrMatcherBase::SetBestMatchF(const TDesC& aBuf)
1.181 +/** Sets the match text to the best match between the match text and the passed
1.182 +buffer, using locale folding rules.
1.183 +
1.184 +@param aBuf Text to match */
1.185 + {
1.186 + DoSetBestMatch(aBuf,Mem::CompareF);
1.187 + }
1.188 +
1.189 +EXPORT_C void RIncrMatcherBase::AppendChar(TChar aLetter)
1.190 +/** Appends a character to the end of the match text.
1.191 +
1.192 +@param aLetter Character to append */
1.193 + {
1.194 + TDes& des=MatchDes();
1.195 + __ASSERT_ALWAYS(des.Length()<des.MaxLength(),Panic(EBafPanicMatcherOutOfRange));
1.196 + des.Append(aLetter);
1.197 + }
1.198 +
1.199 +EXPORT_C void RIncrMatcherBase::DeleteLastChar()
1.200 +/** Deletes the final character in the match text. */
1.201 + {
1.202 + TDes& des=MatchDes();
1.203 + TInt l=des.Length();
1.204 + if (--l>=0)
1.205 + {
1.206 + des[l]=0;
1.207 + des.SetLength(l);
1.208 + }
1.209 + }
1.210 +
1.211 +EXPORT_C RIncrMatcherPtr::RIncrMatcherPtr()
1.212 + : iDesPtr(NULL)
1.213 +/** Default constructor. */
1.214 + {
1.215 + }
1.216 +
1.217 +EXPORT_C RIncrMatcherPtr::RIncrMatcherPtr(TDes& aDes)
1.218 + : iDesPtr(&aDes)
1.219 +/** Constructor that initialises the object with the text to be matched against.
1.220 +
1.221 +@param aDes Text to be matched against */
1.222 + {
1.223 + }
1.224 +
1.225 +EXPORT_C RIncrMatcherPtr::~RIncrMatcherPtr()
1.226 +/** Destructor. */
1.227 + {
1.228 + }
1.229 +
1.230 +EXPORT_C TDes& RIncrMatcherPtr::MatchDes()
1.231 +/** Gets the match text.
1.232 +
1.233 +@return Match text */
1.234 + {
1.235 + return(*iDesPtr);
1.236 + }
1.237 +
1.238 +EXPORT_C const TDes& RIncrMatcherPtr::MatchDes() const
1.239 +/** Gets the match text.
1.240 +
1.241 +@return Match text */
1.242 + {
1.243 + return(*iDesPtr);
1.244 + }
1.245 +
1.246 +
1.247 +EXPORT_C RIncrMatcherTextBuf::RIncrMatcherTextBuf()
1.248 +/** Default constructor. */
1.249 + {
1.250 + }
1.251 +
1.252 +EXPORT_C RIncrMatcherTextBuf::~RIncrMatcherTextBuf()
1.253 +/** Destructor.*/
1.254 + {
1.255 + }
1.256 +
1.257 +EXPORT_C TDes& RIncrMatcherTextBuf::MatchDes()
1.258 +/** Gets the match text.
1.259 +
1.260 +@return Match text */
1.261 + {
1.262 + return(iTextBuf.Text());
1.263 + }
1.264 +
1.265 +EXPORT_C const TDes& RIncrMatcherTextBuf::MatchDes() const
1.266 +/** Gets the match text.
1.267 +
1.268 +@return Match text */
1.269 + {
1.270 + return(iTextBuf.Text());
1.271 + }