/*

* Copyright (c) 2008-2009 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:    Array of attribute retrieval errors

*

*/

#ifndef C_GLXFETCHERROR_H

#define C_GLXFETCHERROR_H

#include <e32base.h>

#include "glxfetcherror.h"

/**

 * CGlxFetchErrorArray

 *

 * Ordered array of attribute retrieval errors

 * @see TGlxFetchError

 *

 * @lib glxmedialists.lib

 */

NONSHARABLE_CLASS(CGlxFetchErrorArray) : public CBase

    {

public:

   /**

     * Constructor

     */

    CGlxFetchErrorArray();

    /**

     * Two-phase copy constructor

     * @param aErrorArray The existing CGlxFetchErrorArray to copy

     */

    static CGlxFetchErrorArray* NewL(const CGlxFetchErrorArray* aErrorArray);

    /**

     * Two-phase copy constructor

     * @param aErrorArray The existing CGlxFetchErrorArray to copy

     */

    static CGlxFetchErrorArray* NewLC(const CGlxFetchErrorArray* aErrorArray);

    /**

     * Destructor

     */    

    ~CGlxFetchErrorArray();

    /**

     * Number of errors stored in array

     * @return Number of errors stored in array

     */

    TInt ErrorCount() const;

    /**

     * The error at a particular index

     * @param aIndex The index for the error

     * @return The error

     */

    TGlxFetchError Error(TInt aIndex) const;

    /**

     * Add an error to the array

     * @param aError Error to add

     */

    void AddErrorL(TGlxFetchError aError);

    /**

     * Remove an error from the array

     * @param aIndex index of the error to remove

     */

    void Remove( TInt aIndex );

    /**

     * Find an error given the attribute

     * @param aAttr The attribute to look for

     * @return The error code, or KErrNone if none

     */

    TInt FindError(TMPXAttribute aAttr) const;

    /**

     * Find an error given the content id

     * @param aContentId The content id to look for

     * @return The error code, or KErrNone if none

     */

    TInt FindError(TInt aContentId) const;

private:

    /**

     * Second-phase copy constructor

     * @param aErrorArray The existing CGlxFetchErrorArray to copy

     */

    void CopyConstructL(const CGlxFetchErrorArray* aErrorArray);

    /**

     * Ordering function for array

     * @see TLinearOrder

     */

    static TInt ErrorOrderByKey(const TMPXAttribute* aAttr, const TGlxFetchError& aItem2);

    /**

     * Ordering function for array

     * @see TLinearOrder

     */

    static TInt ErrorOrderById(const TGlxFetchError& aItem1, const TGlxFetchError& aItem2); 

private:

    /// Ordered array of errors

    RArray<TGlxFetchError> iFetchErrors;

    };

#endif // C_GLXFETCHERROR_H