/*
* Copyright (c) 2008-2008 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:  Header file of central repository database property class
*
*/


#ifndef C_CENREPDATABASEPROPERTY_H
#define C_CENREPDATABASEPROPERTY_H

#include <e32base.h>

/**
 *  central repository property class
 *
 *  This class represent one property in central repository
 *
 *  @lib cenrepdatabase.lib
 *  @since S60 V3.2
 */
NONSHARABLE_CLASS( CCenRepDatabaseProperty ): public CBase
    {
	public: // Constructor and destructor

	    /**
	    * Two-phased constructor.
	    */
	    IMPORT_C static CCenRepDatabaseProperty* NewL();

	    /**
	    * Two-phased constructor.
	    */
	    IMPORT_C static CCenRepDatabaseProperty* NewLC();

	    /**
	    * Destructors.
	    */
	    IMPORT_C virtual ~CCenRepDatabaseProperty();

	public: // member functions
	    /**
	     * Returns the name of this property
	     *
	     * @since S60 V3.2
	     * @return Name of property
	     */
	    IMPORT_C TUint32 GetName() const;

	    /**
	     * Sets the name for this property
	     *
	     * @since S60 V3.2
	     * @param aPropertyname new property name
	     */
	    IMPORT_C void SetName( TUint32 aPropertyname );

	    /**
	     * Returns value of property
	     *
	     * @since S60 V3.2
	     * @param aValue on return, TInt value
	     * @return Error code
	     */
	    IMPORT_C TInt GetValue( TInt& aValue ) const;

	    /**
	     * Sets value of property. Value must match to datatype.
	     *
	     * @since S60 V3.2
	     * @param aValue new TInt value to be set
	     * @return Error code
	     */
	    IMPORT_C TInt SetValue( TInt aValue );

	    /**
	     * Returns value of property
	     *
	     * @since S60 V3.2
	     * @param aValue on return, descriptor value
	     * @return Error code
	     */
	    IMPORT_C const TDesC& GetDesValue() const;

	    /**
	     * Sets the value of property. Value must match to datatype.
	     *
	     * @since S60 V3.2
	     * @param aValue new descriptor
	     * @return Error code
	     */
	    IMPORT_C TInt SetValue( const TDesC& aValue );


	    /**
	     * Compares data of this property to another.
	     *
	     * @since S60 V3.2
	     * @param aProperty property to be compared
	     * @return ETrue if properties have same data
	     */
	    IMPORT_C TBool CCenRepDatabaseProperty::operator==( 
	                const CCenRepDatabaseProperty& aProperty ) const;

	private:

	    /**
	    * C++ default constructor.
	    */
	    CCenRepDatabaseProperty();
	    
	    /**
	    * By default Symbian 2nd phase constructor is private.
	    */
	    void ConstructL();

	private: // data

	    /**
	     * Descriptor of property value
	     * Own.
	     */
	    RBuf iPropertyValue;

	    /**
	     * Name of property
	     */
	    TUint32 iPropertyName;


    private: // For testing
        #ifdef TEST_EUNIT
            friend class UT_CCenRepDatabaseProperty;
        #endif

    };
    
typedef RPointerArray<CCenRepDatabaseProperty> RIpAppPropArray;    
typedef RArray<TUint32> RKeyArray;

const TInt KCenRepMaxDesLength = 512;


#endif // C_CENREPDATABASEPROPERTY_H