/*

* Copyright (c) 2006 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:  String conversion utility functions

*

*/

#ifndef AISTRCNV_H

#define AISTRCNV_H

#include <e32std.h>

namespace AiUtility

    {

    /**

	 * Parses an integer value from string. The string may contain

	 * the integer value either in hexadecimal or decimal format.

	 *

	 * @param aResult the result integer value

	 * @param aSourceString the source string

	 * @return KErrNone if aStringValue is parsed to aValue.

	 */	 

	IMPORT_C TInt ParseInt( TInt32& aResult, const TDesC8& aSourceString );

    /**

	 * Parses an integer value from string. The string may contain

	 * the integer value either in hexadecimal or decimal format.

	 *

	 * @param aResult the result integer value

	 * @param aSourceString the source string

	 * @return KErrNone if aStringValue is parsed to aValue.

	 */	 

	IMPORT_C TInt ParseInt( TInt32& aResult, const TDesC16& aSourceString );

	/**

	 * Copies aText to aBuffer.

	 *

	 * @param aTargetBuffer a buffer to hold text. If aBuffer is NULL or

	 * insufficient, the function allocates a buffer.

	 * @param aSourceText the text to copy.

	 * @return pointer to result buffer.

	 */ 	

	IMPORT_C HBufC16* CopyToBufferL(HBufC16* aTargetBuffer, const TDesC16& aSourceText);

    /**

	 * Copies and converts aText to aBuffer. UTF-8 to UCS-2 conversion

	 * is applied to aText.

	 *

	 * @param aTargetBuffer a buffer to hold text. If aBuffer is NULL or

	 * insufficient, the function allocates a buffer.

	 * @param aSourceText the text to copy.

	 * @return pointer to result buffer.

 	 */ 

    IMPORT_C HBufC16* CopyToBufferL(HBufC16* aTargetBuffer, const TDesC8& aSourceText);

    /**

	 * Copies aText to aBuffer.

	 *

	 * @param aTargetBuffer a buffer to hold text. If aBuffer is NULL or

	 * insufficient, the function allocates a buffer.

	 * @param aSourceText the text to copy.

	 * @return pointer to result buffer.

	 */ 

    IMPORT_C HBufC8* CopyToBufferL(HBufC8* aTargetBuffer, const TDesC8& aSourceText);

    /**

	 * Copies and converts aText to aBuffer. UCS-2 to UTF-8 conversion

	 * is applied to aText.

	 *

	 * @param aTargetBuffer a buffer to hold text. If aBuffer is NULL or

	 * insufficient, the function allocates a buffer.

	 * @param aSourceText the text to copy.

	 * @return pointer to result buffer.

	 */ 

    IMPORT_C HBufC8* CopyToBufferL(HBufC8* aTargetBuffer, const TDesC16& aSourceText);

    /**

     * Ensures the buffer maximum length to be at least given number of characters.

     * This function checks the maximum length of given buffer and reallocates a

     * new buffer if the maximum length is not at least given number of characters.

     *

     * @param aBuffer refence to pointer to buffer to be checked.

     * @param aMaxLength new maximum length

     * @return modifiable pointer descriptor to the buffer

     *

     */

    IMPORT_C TPtr16 EnsureBufMaxLengthL(HBufC16*& aBuffer, TInt aMaxLength );

    }

#endif // AISTRCNV_H