/*
* 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:       Inline functions specyfic for element node
*
*/








// -------------------------------------------------------------------------------------
// Default constructor
// -------------------------------------------------------------------------------------
//
inline TXmlEngElement::TXmlEngElement():TXmlEngNode(NULL) {}

// -------------------------------------------------------------------------------------
// Constructor
// -------------------------------------------------------------------------------------
//
inline TXmlEngElement::TXmlEngElement(void* aInternal): TXmlEngNode(aInternal) {}


// -------------------------------------------------------------------------------------
// Creates new attribute node using namespace of its parent element (this element),
// sets attribute's value and links it as the last attribute of the element
//
// @param aName	- Local name of attribute 
// @param aValue - Value to set for new attribute or NULL (sets value to "")
// @return A handler to the newly created attribute node;
//
// For more hints how to use it refer to AddNewAttributeL(const TDesC8&,const TDesC8&)
//		
// @note	
// 	- No checks are made that attribute with such name exists
// 	- if namespace of the parent element is default (i.e. bound prefix is NULL),
// 	  then temporary prefix will be used and bound to the same namespace URI as elements
// 	  (It is due to the fact that default namespaces do not spread on unprefixed attributes,
// 	   see http://w3.org/TR/REC-xml-names/#defaulting)
// -------------------------------------------------------------------------------------
//
inline TXmlEngAttr TXmlEngElement::AddNewAttributeSameNsL(const TDesC8& aName, const TDesC8& aValue)
    {
    return AddNewAttributeL(aName, aValue, NamespaceDeclaration());
    }

// -------------------------------------------------------------------------------------
// @return Default namespace in the scope of the element
//
// NULL TXmlEngNamespace means that element with no prefix have no namespace associated
// because no default namespace was declared or default namespace was undeclared with <b>xmlns=""</b>
//
// Equivalent to LookupNamespaceByPrefixL() with NULL (or "") prefix provided
// -------------------------------------------------------------------------------------
//
inline TXmlEngNamespace TXmlEngElement::DefaultNamespaceL() const
    {
    return LookupNamespaceByPrefixL(KNullDesC8);
    }

// -------------------------------------------------------------------------------------
// Specialized version of TXmlEngNode::CopyL()
//
// @return Deep copy of the element.
// -------------------------------------------------------------------------------------
//
inline TXmlEngElement TXmlEngElement::CopyL() const
    {return TXmlEngNode::CopyL().AsElement();}

// -------------------------------------------------------------------------------------
// Removes all element contents: child nodes, attributes and namespace declarations
//
// @see RemoveChildren(), RemoveAttributes(), RemoveNamespaceDeclarations();
// -------------------------------------------------------------------------------------
//
inline void TXmlEngElement::ClearElement()
    {
    RemoveChildren();
    RemoveAttributes();
    RemoveNamespaceDeclarations();
    }

// -------------------------------------------------------------------------------------
// -------------------------------------------------------------------------------------
//


// -------------------------------------------------------------------------------------
// Returns TRUE if the element holds an attribute with such namespace URI and name.
//
// Same result gives AttributeNodeL(uri,name).NotNull()
// -------------------------------------------------------------------------------------
//
inline TBool TXmlEngElement::HasAttributeL(const TDesC8& aLocalName, const TDesC8& aNamespaceUri) const
	{return AttributeNodeL(aLocalName, aNamespaceUri).NotNull();}