1.1 --- a/epoc32/include/xmlengelement.inl Tue Nov 24 13:55:44 2009 +0000
1.2 +++ b/epoc32/include/xmlengelement.inl Tue Mar 16 16:12:26 2010 +0000
1.3 @@ -1,1 +1,113 @@
1.4 -xmlengelement.inl
1.5 +/*
1.6 +* Copyright (c) 2004-2006 Nokia Corporation and/or its subsidiary(-ies).
1.7 +* All rights reserved.
1.8 +* This component and the accompanying materials are made available
1.9 +* 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
1.10 +* which accompanies this distribution, and is available
1.11 +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
1.12 +*
1.13 +* Initial Contributors:
1.14 +* Nokia Corporation - initial contribution.
1.15 +*
1.16 +* Contributors:
1.17 +*
1.18 +* Description: Inline functions specyfic for element node
1.19 +*
1.20 +*/
1.21 +
1.22 +
1.23 +
1.24 +
1.25 +
1.26 +
1.27 +
1.28 +
1.29 +// -------------------------------------------------------------------------------------
1.30 +// Default constructor
1.31 +// -------------------------------------------------------------------------------------
1.32 +//
1.33 +inline TXmlEngElement::TXmlEngElement():TXmlEngNode(NULL) {}
1.34 +
1.35 +// -------------------------------------------------------------------------------------
1.36 +// Constructor
1.37 +// -------------------------------------------------------------------------------------
1.38 +//
1.39 +inline TXmlEngElement::TXmlEngElement(void* aInternal): TXmlEngNode(aInternal) {}
1.40 +
1.41 +
1.42 +// -------------------------------------------------------------------------------------
1.43 +// Creates new attribute node using namespace of its parent element (this element),
1.44 +// sets attribute's value and links it as the last attribute of the element
1.45 +//
1.46 +// @param aName - Local name of attribute
1.47 +// @param aValue - Value to set for new attribute or NULL (sets value to "")
1.48 +// @return A handler to the newly created attribute node;
1.49 +//
1.50 +// For more hints how to use it refer to AddNewAttributeL(const TDesC8&,const TDesC8&)
1.51 +//
1.52 +// @note
1.53 +// - No checks are made that attribute with such name exists
1.54 +// - if namespace of the parent element is default (i.e. bound prefix is NULL),
1.55 +// then temporary prefix will be used and bound to the same namespace URI as elements
1.56 +// (It is due to the fact that default namespaces do not spread on unprefixed attributes,
1.57 +// see http://w3.org/TR/REC-xml-names/#defaulting)
1.58 +// -------------------------------------------------------------------------------------
1.59 +//
1.60 +inline TXmlEngAttr TXmlEngElement::AddNewAttributeSameNsL(const TDesC8& aName, const TDesC8& aValue)
1.61 + {
1.62 + return AddNewAttributeL(aName, aValue, NamespaceDeclaration());
1.63 + }
1.64 +
1.65 +// -------------------------------------------------------------------------------------
1.66 +// @return Default namespace in the scope of the element
1.67 +//
1.68 +// NULL TXmlEngNamespace means that element with no prefix have no namespace associated
1.69 +// because no default namespace was declared or default namespace was undeclared with <b>xmlns=""</b>
1.70 +//
1.71 +// Equivalent to LookupNamespaceByPrefixL() with NULL (or "") prefix provided
1.72 +// -------------------------------------------------------------------------------------
1.73 +//
1.74 +inline TXmlEngNamespace TXmlEngElement::DefaultNamespaceL() const
1.75 + {
1.76 + return LookupNamespaceByPrefixL(KNullDesC8);
1.77 + }
1.78 +
1.79 +// -------------------------------------------------------------------------------------
1.80 +// Specialized version of TXmlEngNode::CopyL()
1.81 +//
1.82 +// @return Deep copy of the element.
1.83 +// -------------------------------------------------------------------------------------
1.84 +//
1.85 +inline TXmlEngElement TXmlEngElement::CopyL() const
1.86 + {return TXmlEngNode::CopyL().AsElement();}
1.87 +
1.88 +// -------------------------------------------------------------------------------------
1.89 +// Removes all element contents: child nodes, attributes and namespace declarations
1.90 +//
1.91 +// @see RemoveChildren(), RemoveAttributes(), RemoveNamespaceDeclarations();
1.92 +// -------------------------------------------------------------------------------------
1.93 +//
1.94 +inline void TXmlEngElement::ClearElement()
1.95 + {
1.96 + RemoveChildren();
1.97 + RemoveAttributes();
1.98 + RemoveNamespaceDeclarations();
1.99 + }
1.100 +
1.101 +// -------------------------------------------------------------------------------------
1.102 +// -------------------------------------------------------------------------------------
1.103 +//
1.104 +
1.105 +
1.106 +// -------------------------------------------------------------------------------------
1.107 +// Returns TRUE if the element holds an attribute with such namespace URI and name.
1.108 +//
1.109 +// Same result gives AttributeNodeL(uri,name).NotNull()
1.110 +// -------------------------------------------------------------------------------------
1.111 +//
1.112 +inline TBool TXmlEngElement::HasAttributeL(const TDesC8& aLocalName, const TDesC8& aNamespaceUri) const
1.113 + {return AttributeNodeL(aLocalName, aNamespaceUri).NotNull();}
1.114 +
1.115 +
1.116 +
1.117 +