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


#ifndef NcdPROTOCOLUTILS_H
#define NcdPROTOCOLUTILS_H

#include <e32base.h>
#include "ncdprotocoltypes.h"

class NcdProtocolUtils
    {
public:
    static void AssignEmptyDesL( HBufC16*& aDes );
    static void AssignEmptyDesL( HBufC8*& aDes );
    static void AssignDesL( HBufC16*& aDes, const TDesC16& aSource );
    // Does UTF8->unicode conversion:
    static void AssignDesL( HBufC16*& aDes, const TDesC8& aSource );
    static void AssignDesL( HBufC8*& aDes, const TDesC8& aSource );
    static HBufC16* ConvertUtf8ToUnicodeL( const TDesC8& aUtfText );
    static HBufC16* ConvertUtf8ToUnicodeLC( const TDesC8& aUtfText );
    static HBufC8* ConvertUnicodeToUtf8L( const TDesC16& aUnicodeText );
    static TBool IsWhitespace( const TDesC8& aUtfText );
    static TInt DesDecToIntL( const TDesC8& aDes );
    static TInt DesDecToIntL( const TDesC16& aDes );
    static TInt DesDecToInt( const TDesC8& aDes, TInt& aValue );
    static TInt DesDecToInt( const TDesC16& aDes, TInt& aValue );

    static TReal32 DesDecToRealL( const TDesC8& aDes );
    
    static void DesToBool( TBool& aBool, const TDesC8& aDes );
    static void DesToBool( TBool& aBool, const TDesC16& aDes );
    static void DesToNcdBool( TNcdBool& aBool, const TDesC8& aDes );
    static void DesToNcdBool( TNcdBool& aBool, const TDesC16& aDes );
    /**
     * Parses xs:dateTime. If KNullDesC8 parameter is given,
     * the returned TTime value will be zero. Malformed input
     * will cause a leave.
     * @param aDes xs:dateTime format string
     */
//     static TTime TimeStampL( const TDesC8& aDes );

    static void BoolToStringL(TXmlEngString& aString, const TBool aValue);
    static void NcdBoolToStringL(TXmlEngString& aString, const TNcdBool aValue);
    static const TDesC8& BoolToDes( TBool aValue );
    static const TDesC8& NcdBoolToDes( TNcdBool aValue );
    static void DesToStringL(TXmlEngString& aString, const TDesC& aValue);
    static void DesToStringL(TXmlEngString& aString, const TDesC8& aValue);
    static void IntToStringL(TXmlEngString& aString, TInt aValue);

    static void NewAttributeL(
        TXmlEngElement& aParent, const TDesC8& aKey, const TDesC8& aValue);
    static void NewAttributeL(
        TXmlEngElement& aParent, const TDesC8& aKey, const TDesC& aValue);
    static void NewBoolAttributeL(
        TXmlEngElement& aParent, const TDesC8& aKey, const TBool aValue);
    static void NewNcdBoolAttributeL(
        TXmlEngElement& aParent, const TDesC8& aKey, const TNcdBool aValue);
    static void NewAttributeL(
        TXmlEngElement& aParent, const TDesC8& aKey, const TInt aValue);
    static void NewAttributeL(
        TXmlEngElement& aParent, const TDesC8& aKey, const TXmlEngString& aValue);
    
    static TXmlEngElement NewElementL( RXmlEngDocument& aDocument, 
        TXmlEngElement& aParent, const TDesC8& aName, const TXmlEngString& aPrefix);
    static TXmlEngElement NewElementL( RXmlEngDocument& aDocument, 
        TXmlEngElement& aParent, const TDesC8& aName, 
        const TDesC8& aPrefix = KNullDesC8);

    static TXmlEngElement NewElementL(
        RXmlEngDocument& aDocument, const TDesC8& aName, const TXmlEngString& aPrefix);
    static TXmlEngElement NewElementL(
        RXmlEngDocument& aDocument, const TDesC8& aName, 
        const TDesC8& aPrefix = KNullDesC8);
    /**
     * Decodes base64 encoded data into a descriptor.
     * @param Base64 data
     * @return HBufC8* Decoded data
     */
    static HBufC8* DecodeBase64L( const TDesC8& aData );
    /**
     * Decodes base64 encoded data into a descriptor.
     * @param Base64 data
     * @return HBufC8* Decoded data
     */
    static HBufC8* DecodeBase64LC( const TDesC8& aData );

    static TTime DesToTimeL(const TDesC8& aDes);
    static TTime DesToTimeL(const TDesC16& aDes);
    static void TimeToDesL(const TTime aTime, HBufC16*& aDes);
    
private:
    NcdProtocolUtils();
    ~NcdProtocolUtils();

        /**
     * Decodes data.
     * @param aData Input buffer
     * @param aOutput Output buffer
     * @param aCalculateLength ETrue to only calculate decoded length
     * @return TInt Decoded length 
     */
    static TInt DecodeBase64L( const TDesC8& aData, 
                         TDes8& aOutput,
                         TBool aCalculateLength );
    /**
     * Decodes a character
     * @param c
     * @return TInt
     */
    static TInt DecodeBase64L( TInt c );

    };

#endif