/*

* Copyright (c) 2003 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:  This file contains the header file of the CCbsRecDecoder class

*

*/

#ifndef CCBSRECDECODER_H

#define CCBSRECDECODER_H

//  INCLUDES

#include <e32base.h>

#include <f32file.h>

// FORWARD DECLARATIONS

class CCnvCharacterSetConverter;

class CCbsRecMessage;

class CCbsRecWcdmaMessage;

class CCbsMessage;

// CLASS DECLARATION

/**

*   CCbsRecDecoder handles decoding of message contents.

*

*   CbsServer receives messages stored in 8-bit descriptors

*   from ETel. This class converts them into 16-bit descriptors

*   and decodes the message representation into UCS-2 (which

*   is used by Symbian OS internally). 

*  

*/

class CCbsRecDecoder : public CBase

    {

    public:  // Constructors and destructor

        /**

        *   Two-phased constructor.

        *

        *   @returns                    New instance of CCbsRecDecoder.

        */

         static CCbsRecDecoder* NewL();

        /**

        *   Destructor.

        */

        virtual ~CCbsRecDecoder();

    public:  // New functions

        /**

        *   Decodes message page into Unicode representation.

        *

        *   If the message has a language indication prefixed

        *   in the message body, the indication is removed.

        *

        *   Compressed messages are not supported.

        *   

        *   Leave reasons:

        *   KErrNotSupported    Message compressed or of unsupported character

        *                       coding.

        *   KErrNoMemory        OOM.

        *   KErrGeneral         Failed due to other reasons.

        *

        *   @param aMessage Message page.

        */

        void DecodeL( CCbsMessage& aMessage );

    private:  // New functions

        // Default constructor.

        CCbsRecDecoder();

        // Prohibited copy constructor.

        CCbsRecDecoder( const CCbsRecDecoder& );

        // Prohibited assignment operator.

        CCbsRecDecoder& operator=( const CCbsRecDecoder& );

        /**

        *   2nd-phase constructor. 

        */

        void ConstructL();

        /**

        *   Decodes the given message's content.

        *

        *   @param aMessage             CB message

        */

        void DoDecodeL( CCbsMessage& aMessage );

        /**

        *   Decodes 8-bit and Unicode message representations.

        *

        *   @param aMsg                 CB message encoded in UCS2

        */

        void UnicodeDecodeL( CCbsMessage& aMsg );

        /**

        *   Decodes 7-bit message representation.

        *

        *   @param aMsg                 CB message encoded in 7-bit

        */

        void DefaultAlphabetDecodeL( CCbsMessage& aMsg );

        /**

        *   Decodes 8-bit message representation.

        *

        *   @param aMsg                 CB message encoded in 8-bit

        */

        void EightbitAlphabetDecodeL( CCbsMessage& aMsg );

        /**

        *   Removes the trailing CRs from a message.

        *

        *   @param aText                Text from which the CR is to be removed

        */

        TPtrC RemoveTrailingCR( const TDesC& aText );

        /**

        *   Removes trailing CRs and LFs from a 7-bit Cell info message.

        *

        *   @param aText                Text from which the CR is to be removed

        *   @return                     Text with no CRs or LFs        

        */

        TPtrC8 RemoveTrailingControlChars( const TDesC8& aText );

   private:    // Data

        // Own: character converter for 8-bit and UCS2 encodings

        CCnvCharacterSetConverter* iConverter;

        // File server session

        RFs iFs;

    };

#endif      // CBSRECDECODER_H

// End of File