XMLTools - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Connectivity : Web Features : XMLTools : XMLTools/AttributeValue

XMLTools

  

AttributeValue

  

retrieve the value of an attribute of an XML element

  

AttributeValueWithDefault

  

retrieve the value of an attribute of an XML element, or a specified default value if the attribute is not present

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

AttributeValue(xmlTree, attrName)

AttributeValueWithDefault(xmlTree, attrName, defValue)

Parameters

xmlTree

-

Maple XML tree; XML element

attrName

-

string; attribute name

defValue

-

string; default value

Description

• 

The AttributeValue(xmlTree, attrName) command extracts the value of an attribute from the XML element xmlTree. The attribute, whose value is sought, must be specified by its name attrName.

  

If the attribute attrName is not present in the XML element xmlTree, an error is returned.

  

Note: Only the attributes that belong to the XML element xmlTree are examined. This function does not examine attributes of any subelements.

• 

The AttributeValueWithDefault(xmlTree, attrName, defValue) command is similar to AttributeValue, except that it takes a third argument defValue. The defValue parameter is a string that specifies a default value for the named attribute attrName if it is not present in the element represented by xmlTree.

  

Note: Only the attributes that belong to the XML element xmlTree are examined. As in the case of AttributeValue, this function does not examine attributes of any subelements.

Examples

withXMLTools:

xmlTreeXMLElementa,colour=red,some text,XMLElementb,colour=blue,more text

xmlTree:=_XML_Element_XML_ElementTypea,_XML_Attribute_XML_AttrNamecolour,_XML_AttrValuered,_XML_Textsome text,_XML_Element_XML_ElementTypeb,_XML_Attribute_XML_AttrNamecolour,_XML_AttrValueblue,_XML_Textmore text

(1)

AttributeValuexmlTree,colour

red

(2)

AttributeValuexmlTree,color

Error, (in XMLTools:-AttributeValue) there is no attribute `color' in the given element

AttributeValueWithDefaultxmlTree,colour,color

red

(3)

See Also

XMLTools

XMLTools[Attributes]

XMLTools[HasAttributes]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam