/*
* Copyright (c) 2002 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: 
*    vCard data field <-> UID mapping class.
*
*/


#ifndef __CBCARDFIELDUIDMAPPING_H__
#define __CBCARDFIELDUIDMAPPING_H__

//  INCLUDES
#include <e32base.h>    // CBase

// FORWARD DECLARATIONS
class TResourceReader;

// CLASS DECLARATION

/**
 * vCard data field <-> UID mapping.
 */
NONSHARABLE_CLASS(CBCardFieldUidMapping) : 
        public CBase
    {
    public:  // Constructors and destructor
        /**
         * Creates a new instance of this class and initializes it from 
         * a PBK_NAME_UID_MAPPING resource.
		 * @param aReader reference to resources
         */
        static CBCardFieldUidMapping* NewL(TResourceReader& aReader);

        /**
         * Destructor.
         */
        ~CBCardFieldUidMapping();

    public:  // Types
        /**
         * vCard data field structure.
         */
        struct TVcardField
            {
            /// vCard property name
            TPtrC8 iName;
            /// vCard property sub field index
            TInt  iFieldIndex;

            /// Default constructor
            TVcardField();
            /// Constructor
            TVcardField(const TDesC8& aName, TInt aFieldIndex=0);
            };

        /**
         * vCard data field <-> UID mapping.
         */
        struct TMapping
            {
            TVcardField iVcardField;
            TUid iUid;
            };

    public:  // Interface
        /**
         * Returns the number of mappings held by this object.
         */
        TInt Count() const;

        /**
         * Returns the aIndex:th mapping held by this object.
         */
        TMapping operator[](TInt aIndex) const;

        /**
         * Finds a mapping for a vCard field.
         *
         * @param aVcardField   vCard field to search a mapping for.
         * @return  index of the mapping (for operator[]) or KErrNotFound if
         *          not found.
         * @see operator[]
         */
        TInt Find(const TVcardField& aVcardField) const;

        /**
         * Finds a mapping with an UID.
         *
         * @param aUid  UID to search for.
         * @return  index of the mapping (for operator[]) or KErrNotFound if
         *          not found.
         * @see operator[]
         */
        TInt Find(const TUid& aUid) const;

        /**
         * Finds the name of the field with an UID.
         *
         * @param aUid  UID to search for.
         * @return  The name of the mapping or KNullDesC if
         *          not found.
         * @see operator[]
         */
        TPtrC8 FindName(const TUid& aUid) const;
        
        /**
         * Finds the index of the field with an UID.
         *
         * @param aUid  UID to search for.
         * @return  The index of the mapping or KErrNotFound if
         *          not found.
         * @see operator[]
         */
        TInt FindIndex(const TUid& aUid) const;


    private:  // Implementation
        CBCardFieldUidMapping();
        void ConstructL(TResourceReader& aReader);


    private:  // Data
        struct TMappingImpl;
		/// Own: array of mappings
        RArray<TMappingImpl> iMappings;
    };


// INLINE FUNCTIONS
inline CBCardFieldUidMapping::TVcardField::TVcardField()
    {
    }

inline CBCardFieldUidMapping::TVcardField::TVcardField
        (const TDesC8& aName, TInt aFieldIndex/*=0*/) :
    iName(aName), iFieldIndex(aFieldIndex)
    {
    }

#endif // __CBCARDFIELDUIDMAPPING_H__

// End of File