/*

* 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 CMcnTopicArray class.

*

*                CMcnTopicArray represents a list containing the numbers of CB topics which

*                a MCN client to CbsServer has subscribed.

*

*/

#ifndef CMCNTOPICARRAY_H

#define CMCNTOPICARRAY_H

//  INCLUDES

#include "e32base.h"

//  CLASS DECLARATION

/**

*      CMcnTopicArray represents a list containing the numbers of CB topics which

*      a MCN client to CbsServer has subscribed.

*/

class CMcnTopicArray 

    : public CBase

    {

public:     // New functions

    /**

    *   Returns a new instance of CMcnTopicArray, initially empty.

    */

    IMPORT_C static CMcnTopicArray* NewL();

    /** 

    *   Destructor. 

    */

    ~CMcnTopicArray();

    /**

    *   Adds a single CB topic to the topic list.

    *   Leaves with KErrArgument if the topic number is not in

    *   valid range. In this implementation, all values

    *   are accepted.

    *

    *   Leave reasons:

    *       KErrArgument, aTopicNumber not in valid range..

    *       KErrNoMemory, Out-of-memory occured.

    *

    *   @param aTopicNumber Number of subscribed CB topic.

    */

    IMPORT_C void AddCbTopicL( TUint16 aTopicNumber );

    /**

    *   Returns the number of topic entries in parameter aEntries.

    *   

    *   @param aEntries  The number of topic entires

    */

    void EnumerateEntries( TUint& aEntries ) const;

    /**

    *   Returns the number of topic in aTopicNumber corresponding to the index

    *   given in aIndex.

    *

    *   @param aIndex   Index of the topic number.

    *   @param aTopicNumber   Topic number corresponding to the given index. 

    */

    IMPORT_C void GetTopicNumber( const TUint& aIndex, TUint& aTopicNumber ) const;

private:

    /// Prohibited copy constructor (not implemented).

    CMcnTopicArray( const CMcnTopicArray& aArray );

    /// Prohibited assignment operator (not implemented).

    CMcnTopicArray& operator=( const CMcnTopicArray& aArray );

    /**

    *   Default constructor.

    */

    CMcnTopicArray();

    /**

    *   2nd-phase constructor.

    */

    void ConstructL();

private:    // data

    /// Own: contains the list of subscribed topics.

    CArrayFixFlat< TUint >* iTopicList;

    };

#endif      // __CMCNTOPICARRAY_H

// End of File