/*

 * Copyright (c) 2004-2006 Nokia Corporation and/or its subsidiary(-ies). 

 * All rights reserved.

 * This component and the accompanying materials are made available

 * under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 * which accompanies this distribution, and is available

 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 *

 * Initial Contributors:

 * Nokia Corporation - initial contribution.

 *

 * Contributors:

 *

 * Description:       Node list implementation functions

 *

 */

 #ifndef XMLENGINE_NODELIST_IMPL_H_INCLUDED

 #define XMLENGINE_NODELIST_IMPL_H_INCLUDED

 #include <e32def.h>

 #include "xmlengnode.h"

 /** 

  * Class implements list container.

  * 

  * @lib XmlEngineDOM.lib

  * @since S60 v3.2

  */

 class RXmlEngNodeListImpl

 {

 public:

     /**

      *  Default constructor

      *

      * @since S60 v3.2

      */

     IMPORT_C RXmlEngNodeListImpl();

     /** 

      * Closes node list

      *

      * @since S60 v3.2

      */

     IMPORT_C void Close();

     /** 

      * Get list length.

      *

      * @since S60 v3.2

      * @return Number of nodes in a node list

      */

     IMPORT_C TInt  Count() const;

     /** 

      * Checks whether next node exists in a node list

      *

      * @since S60 v3.2

      * @return TRUE if next node exists, FALSE otherwise

      */

     IMPORT_C TBool HasNext() const;

     /** 

      * Retrieves next node from a node list

      *

      * @since S60 v3.2

      * @return Next node 

      */

     IMPORT_C TXmlEngNode Next();

     /** 

      * Opens node.

      *

      * @since S60 v3.2

      * @param aHead node pointer to the node from which the searching 

             of list elements is started

      * @param aType type of list elements

      * @param aName name of list elements 

      * @param aNs namespace of list elements

      *

      * @note If aType is NULL, aName and aNs are ignored

      */

     void OpenL( 

 			void* aHead,

 			TXmlEngNode::TXmlEngDOMNodeType aType,

 			const TDesC8&	aName = KNullDesC8,

 			const TDesC8&	aNs = KNullDesC8);

     /** 

      * Opens node.

      *

      * @since S60 v3.2

      * @param aHead node pointer to the node from which the searching 

             of list elements is started

      * @param aType type of list elements

      */

     void Open( 

 			void* aHead,

 			TXmlEngNode::TXmlEngDOMNodeType aType);

 private:

     void* FindNextNode(void* aCurrentNode) const;

     void*	        iCurrentNode;

 	TInt		    iType;  // NodeType:4 bits (0-3) & MatchName flag (bit 4)

 	unsigned char*	iName;

 	unsigned char*	iNsUri;

 };

 TBool StrEqualOrNull(const void* aStr1, const void* aStr2);

 #endif /* XMLENGINE_NODELIST_IMPL_H_INCLUDED */