TXmlEngAttr Class Reference

Default constructor.

Since:

S60 v3.1

Constructor.

Since:

S60 v3.1

Parameters:

aInternal

attribute pointer

Clones attribute node.

Since:

S60 v3.1

Returns:

A copy of the attribute with its value

Note:

Namespace of the attribute is reset; use TXmlEngNode::CopyToL(TXmlEngNode), which finds appropriate or creates new namespace declaration on the new parent node (argument should be an TXmlEngElement handle)

See also:

CopyToL(TXmlEngNode)

Reimplemented from TXmlEngNode.

Check attribute name.

Since:

S60 v3.1

Returns:

Local name of the attribute

Note:

Equal to TXmlEngNode::Name(), but works faster.

See also:

TXmlEngNode::Name()

Reimplemented from TXmlEngNode.

Get owner element.

Since:

S60 v3.1

Returns:

TXmlEngElement that contains the attribute

Note:

Copies of attributes [TXmlEngAttr::CopyL()] and newly created attribute nodes [RXmlEngDocument::CreateAttributeL(..)] do not have parent element until they are attached to some element.

Sets new value from escaped XML character data that may contain entity references.

The value as if it is an escaped contents from XML file. If the value contains entity references, then the resulting content of the attribute is a list of TXmlEngTextNode and TXmlEngEntityRefeerence nodes. Predefined entities are converted into characters they represent.

Parameters:

aNewValue

is a new attribute value

Since:

S60 v3.1

See also:

TXmlEngAttr::SetValueL(const TDesC8&)

Sets new value of the attribute.

Provided new value will be escaped as needed.

@ since S60 v3.1

Parameters:

aNewValue

A string value for the attribute

See also:

SetEscapedValueL(const TDesC8&)

Reimplemented from TXmlEngNode.

Sets new attribute value exactly as presented in the string.

Predefined entities are not converted into characters they represent.

Parameters:

aNewValue

is a new attribute value

Since:

S60 v3.2

See also:

TXmlEngAttr::SetValueL(const TDesC8&)

Get element value.

Since:

S60 v3.1

Returns:

Attribute's contents

Note:

For values consisting of more then one TXmlEngTextNode node (as attribute's child) returns only the begining of the value; this happens when the value is represented by list of TXmlEngTextNode and TXmlEngEntityReference nodes.

See also:

IsSimpleContents(), WholeValueCopyL()

Reimplemented from TXmlEngNode.

Get copy of attribute content.

Since:

S60 v3.1

Returns:

Complex value of the attribute, probably consisting of text nodes and entity references

BE SURE TO FREE THE RESULT STRING!!!

Example usage of the API:

    RBuf8 value;
    attr.WholeValueCopyL(value);
    ...
    value.Close();

See also:

TXmlEngAttr::Value(), TXmlEngNode::Value(), TXmlEngNode::IsSimpleTextContents(), TXmlEngNode::WholeTextContentsCopyL()

Note:

In most cases using Value() is enough (and it needs no memory allocation). Use IsSimpleTextContents() if there doubts can Value() be used or not safely.