diff -r 000000000000 -r 2f259fa3e83a uiutils/Findutil/inc/FindUtilKorean.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/uiutils/Findutil/inc/FindUtilKorean.h Tue Feb 02 01:00:49 2010 +0200 @@ -0,0 +1,173 @@ +/* +* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Korean Find Utilities header file. +* +*/ + + + +#ifndef __FINDUTILKOREAN__ +#define __FINDUTILKOREAN__ + +#include + +#include "FindUtilBase.h" + +/** + * CFindUtilKorean utils class + * + * This class is Korean find utils class. It handle Korean variant find + * in PhoneBook, LandMark, Clock and so on. + * + * @lib FindUtil.dll + * @since S60 v3.2 + */ +NONSHARABLE_CLASS(CFindUtilKorean) + { + public: // Constructors and destructor + + /** + * Symbian constructor + * + * @since S60 v3.2 + * @return Pointer to created CFindUtilKorean object + */ + static CFindUtilKorean* NewL(); + + /** + * Destructor + * + * @since S60 v3.2 + */ + virtual ~CFindUtilKorean(); + + public: + TBool IsKoreanLanguage( const TDesC& aDes ); + + private: + + CFindUtilKorean(); + + void ConstructL(); + + /** + * Compares two strings against others. + * + * @since S60 v3.2 + * @param aItemString for string to being compared + * @param aSearchText for text to be used in searching + * @return ETrue if match found, EFalse otherwise + */ + TBool IsFindMatchL( + const TDesC& aItemString, + const TDesC& aSearchText ); + + /** + * Decomposes given string to plain jamos. + * + * @since S60 v3.2 + * @param aString for string where decomposition is made + * @param aDecomposedString for plain jamos + */ + void DecomposeToPlainJamos( + const TDesC& aString, + HBufC* aDecomposedString ); + + /** + * Decomposes hangul syllables to single jamos. + * + * @since S60 v3.2 + * @param aChar for char to be decomposed + * @param aDecomposedString for chars where jamos are gathered + */ + void Decompose( TChar aChar, TDes& aDecomposedString ); + + /** + * Checks that is given character hangul syllable or not. + * + * @since S60 v3.2 + * @param aChar for char to be checked + * @return ETrue if given input is hangul syllable, EFalse otherwise + */ + TBool IsHangulSyllable( TChar aChar ); + + /** + * Checks that is given character word separator or not. + * + * @since S60 v3.2 + * @param aChar for char to be checked + * @return ETrue if given character is word separator, EFalse otherwise + */ + TBool IsFindWordSeparator( TChar aChar ); + + /** + * Checks that is given character hangul compatibility jamo or not. + * + * @since S60 v3.2 + * @param aChar for char to be checked + * @return ETrue if given input is hangul syllable, EFalse otherwise + */ + TBool IsHangulCompatibilityJamo( TChar aChar ); + + public: + /** + * + * @since 3.2 + * @param aContactsField is a contact field string. + * @param aWord is a search string. + * @return If aWord has been matched with aContactsField, + * ETrue is returned. + */ + TBool Match( const TDesC& aContactsField, const TDesC& aWord ); + + /** + * + * @since 3.2 + * @param aItemString is a Contact field string + * @param aSearchText is a search string + * @return If aSearchText has been found in aItemString, + * ETrue is returned. + */ + TBool MatchRefineL( + const TDesC& aItemString, + const TDesC &aSearchText ); + + /** + * + * @since 3.2 + * @param aWord + * @return ETrue is returned always. + */ + TBool IsWordValidForMatching(const TDesC& aWord); + + /** + * @since 5.0 + * @param aItemString is a field string + * @param aSearchText is a search string + * @param aNextChars is a reference to buffer where next possible characters are saved. + * The HBufC buffer may be re-allocated by this method. + * In that case the pointer reference is modified to point to the re-allocated object. + * @return If aSearchText has been found in aItemString, + * ETrue is returned. + * NOT IMPLMENTED + */ + TBool MatchAdaptiveRefineL( const TDesC& aItemString, + const TDesC& aSearchText, + HBufC*& aNextChars); + + }; + +#endif // __FINDUTILKOREAN__ + +// End of File