/*
* 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 <e32base.h>

/**
 * 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