diff -r 000000000000 -r f72a12da539e menufw/hierarchynavigator/hnutilities/inc/hnconvutils.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/menufw/hierarchynavigator/hnutilities/inc/hnconvutils.h Thu Dec 17 08:40:49 2009 +0200 @@ -0,0 +1,158 @@ +/* +* Copyright (c) 2007-2008 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: +* +*/ + + + +#ifndef HNCONVUTILS_H +#define HNCONVUTILS_H + +#include + +/** + * Provides static methods for converting numbers to + * descriptors and vice versa. + * + * @lib hnutilities.lib + * @since S60 v5.0 + * @ingroup group_hnutilities + */ +NONSHARABLE_CLASS( HnConvUtils ) + { +public: + + /** + * Converts narrow string descriptor to default width string descriptor. + * + * @since S60 v5.0 + * @param aStr Narrow string descriptor. + * @return Default wide string descriptor. + */ + IMPORT_C static HBufC* Str8ToStr( const TDesC8& aStr ); + + /** + * Converts narrow string descriptor to default width string descriptor. + * Does not handle special characters. + * + * @since S60 v5.0 + * @param aStr Narrow string descriptor. + * @return Default wide string descriptor. + */ + static HBufC* Str8ToStrFastLC( const TDesC8& aStr ); + + /** + * Converts wide string descriptor to narrow string descriptor. + * Does not handle special characters. + * + * @since S60 v5.0 + * @param aStr Wide string descriptor input. + * @return Narrow string. + */ + static HBufC8* StrToStr8FastLC( const TDesC16& aStr ); + + /** + * Converts narrow string descriptor to default width string descriptor. + * Handles special characters. + * + * @since S60 v5.0 + * @param aStr Narrow string descriptor. + * @return Default wide string descriptor. + */ + IMPORT_C static HBufC* Str8ToStrLC( const TDesC8& aStr ); + + /** + * Converts wide string descriptor to narrow string descriptor. + * Handles special characters. + * + * @since S60 v5.0 + * @param aStr Wide string descriptor input. + * @return Narrow string. + */ + IMPORT_C static HBufC8* StrToStr8LC( const TDesC16& aStr ); + + /** + * Converts wide string descriptor to narrow string descriptor. + * + * @since S60 v5.0 + * @param aStr Wide string descriptor input. + * @return Narrow string. + */ + IMPORT_C static HBufC8* StrToStr8L( const TDesC16& aStr ); + + /** + * Converts integer to narrow string descriptor. + * + * @since S60 v5.0 + * @param aNum Number. + * @return Narrow string. + */ + IMPORT_C static HBufC8* NumToStr8LC( const TInt& aNum ); + + /** + * Converts narrow string descriptor to integer value. + * + * @since S60 v5.0 + * @param aValue Input descriptor. + * @param aResult Result integer. + * @return Error code. + */ + IMPORT_C static TInt Str8ToInt( const TDesC8& aValue, TInt& aResult ); + + /** + * Converts string descriptor to integer value. + * + * @since S60 v5.0 + * @param aValue Input descriptor. + * @param aResult Result integer. + * @return Error code. + */ + IMPORT_C static TInt StrToInt( const TDesC& aValue, TInt& aResult ); + + /** + * Converts narrow string descriptor to integer value. + * + * @since S60 v5.0 + * @param aValue Input descriptor. + * @param aResult Result integer. + * @return Error code. + */ + IMPORT_C static TInt Str8ToInt( const TDesC8& aValue, TInt32& aResult ); + + /** + * Converts narrow string descriptor to integer value. + * + * @since S60 v5.0 + * @param aValue Input descriptor. + * @param aResult Result integer. + * @return Error code. + */ + IMPORT_C static TInt StrToInt( const TDesC& aValue, TInt32& aResult ); + + /** + * Converts narrow string descriptor to integer value. + * + * @since S60 v5.0 + * @param aValue Input descriptor. + * @param aResult Result integer. + * @return Error code. + */ + IMPORT_C static TInt Str8ToUint( const TDesC8& aValue, TUint& aResult ); + }; + +#include "hnconvutils.inl" + +#endif // HNCONVUTILS_H +