/*

* Copyright (c) 2006-2007 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 NATFWUNSAFUTILS_H

#define NATFWUNSAFUTILS_H

// INCLUDES

#include <e32base.h>

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**

* Utility functions

*

*  @lib natfwunsafprotocols.lib

*/

NONSHARABLE_CLASS(NATFWUNSAFUtils)

    {

    public: // New functions

        inline static TUint8 HighByte(TUint16 aValue)

            {

            return aValue >> 8;

            }

        inline static TUint8 LowByte(TUint16 aValue)

            {

            return aValue & 0xff;

            }

        inline static TUint16 HighWord(TUint32 aValue)

            {

            return aValue >> 16;

            }

        inline static TUint16 LowWord(TUint32 aValue)

            {

            return aValue & 0xffff;

            }

        inline static TUint32 HighDWord(TUint64 aValue)

            {

            return aValue >> 32;

            }

        inline static TUint32 LowDWord(TUint64 aValue)

            {

            return aValue & 0xffffffff;

            }

        /**

        * Writes an unsigned 16 bit value in network byte order (big-endian)

        * into aPtr, at the given position.

        * @param aPtr Buffer where the aValue is written, must have enough

        *             space

        * @param aOffset Position inside the buffer pointed by aPtr, where the

        *                value is written.

        * @param aValue 16 bit unsigned value to write

        * @leave KErrArgument if aPtr is too short to contain enough data

        */

        static void WriteNetworkOrder16L(TDes8& aPtr,

                                         TInt aOffset,

                                         TUint16 aValue);

        /**

        * Writes an unsigned 32 bit value in network byte order (big-endian)

        * into aPtr, at the given position.

        * @param aPtr Buffer where the aValue is written, must have enough

        *             space

        * @param aOffset Position inside the buffer pointed by aPtr, where the

        *                value is written.

        * @param aValue 32 bit unsigned value to write

        * @leave KErrArgument if aPtr is too short to contain enough data

        */

        static void WriteNetworkOrder32L(TDes8& aPtr,

                                         TInt aOffset,

                                         TUint32 aValue);

        /**

        * Writes an unsigned 64 bit value in network byte order (big-endian)

        * into aPtr, at the given position.

        * @param aPtr Buffer where the aValue is written, must have enough

        *             space

        * @param aOffset Position inside the buffer pointed by aPtr, where the

        *                value is written.

        * @param aValue 64 bit unsigned value to write

        * @leave KErrArgument if aPtr is too short to contain enough data

        */

        static void WriteNetworkOrder64L(TDes8& aPtr,

                                         TInt aOffset,

                                         TUint64 aValue);

        /**

        * Gets a quadruple word from a byte stream in big-endian format.

        * @param aPtr Pointer to a byte stream buffer

        * @return A 64-bit integer in big-endian format

        */

        static TUint64 GetQuadWordL(const TUint8* aPtr);

        /**

        * Utility functions for string and character handling

        */

        static TBool IsQuotedPairChar(const TChar& aCharacter);

        static TBool IsQdTextChar(const TChar& aCharacter);

        static TBool IsQuotedString(const TDesC8& aString);

        static TPtrC8 RealmValueFromQuotedStringL(const TDesC8& aString );

        static TBool QuotedStringValue (const TDesC8& aValue);

        static TBool StartsAndEndsWithQuotes (const TDesC8& aString);

        static TBool SkipAndCheckNonAscii (const TChar& aChr, TLex8& aLex);

        static TBool IsUTF8NonAsciiStartChar (const TChar& aChar);

        static TBool SkipAndCheckContChars (TLex8& aLex, TInt aCount);

        static TBool IsUTF8ContChar (const TChar& aChar);

    };

#endif // NATFWUNSAFUTILS_H