/*

* Copyright (c) 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 DHCPLOCATIONINFORMATIONPARSER_H

#define DHCPLOCATIONINFORMATIONPARSER_H

#include <e32base.h>

/**

 *  Parses location information from DHCP message to LCI

 *

 *  @lib sspcontroller

 *  @since S60 3,0

 */

class TDhcpLocationInformationParser

    {

    public:

        /** Location information parsing type */

        enum TParsingType

            {

            EDHCPCoordinates,

            EDHCPCivicAddress

            };

    public:

        /**

         * Constructor

        */

        TDhcpLocationInformationParser();

        /**

         * Parses location information

         *

         * @since S60 3.2

         * @param aInput Input data

         * @param aParsingType Parsing type

         * @param aOutput Result

         * @return None

         */

        void ParseLocationInformation( const TDesC8& aInput,

                const TParsingType aParsingType, TDes8& aOutput );

    private:

        /**

         * Parses coordinate parameters from the input data

         *

         * @since S60 3.2

         * @param aInput Input data

         * @param aOutput Result

         * @return None

         */

        void ParseLCI( const TDesC8& aInput, TDes8& aOutput );

        /**

         * Parses datum from the input data

         *

         * @since S60 3.2

         * @param aInput Input data

         * @param aOutput Result

         * @return Error code

         */

        TInt ParseDatum(const TDesC8& aInput, TDes8& aOutput );

        /**

         * Parses the input to the DMS coordinate form

         *

         * @since S60 3.2

         * @param aIsLatitude latitude if ETrue, otherwise longitude

         * @param aResolution Resolution, i.e. the amount of significant bits

         * @param aInteger Integer part of coordinate, or degree

         * @param aFraction Fraction part of coordinate

         * @param aOutput Result

         * @return None

         */

        void ParseDMS(TBool aIsLatitude, TUint8 aResolution,

            TUint16 aInteger, TUint32 aFraction, TDes8& aOutput  );

        /**

         * Parses the civic address elements into the XML description

         *

         * @since S60 3.2

         * @param aInput Input data

         * @param aOutput Result

         * @return None

         */

        void ParseCivicAddressElements( const TDesC8& aInput, TDes8& aOutput );

        /**

         * Extract a single civic address element from the input

         *

         * @since S60 3.2

         * @param aInput Input data

         * @param aOutput Result

         * @return None

         */

        void ExtractCivicAddressElement( TLex8& aInput, TDes8& aOutput );

        /**

         * Parses the timestamp

         *

         * @since S60 3.2

         * @param aTimeStamp Resulting timestamp

         * @return None

         */

        void ParseTimeStamp( TDes8& aTimeStamp );

        /**

         * Parses the retenrion-expiry

         *

         * @since S60 3.2

         * @param aTimeStamp Resulting timestamp

         * @return None

         */

        void ParseRetentionExpiry( TDes8& aTimeStamp );

    private: // data

        /**

         * Timestamp

         */

        TTime iTimeStamp;

    };

#endif // DHCPLOCATIONINFORMATIONPARSER_H