Search for a node attribute by name.

Syntax

XML_Attribute *XML_FindAttribute(
  XML_HANDLE hXml,
  XML_Node *node,
  const char *name,
  int *ErrCode
);

Parameters

hXml
[in] XML handle
node
[in] A pointer to the XML_Node structure of the node.
name
[in] A pointer to a string that specifies the name of the attribute.
ErrCode
[out] A pointer to a variable that returns an error code. Specify NULL when no error code is required.

Return value

Returns a pointer to the XML_Attribute structure if the function succeeds, otherwise NULL.

Remarks

If the specified node has an attribute with the specified name, a pointer to the XML_Attribute structure of the attribute is returned.

The value of the attribute is obtained from the value member of the XML_Attribute structure.

If the function fails, it returns NULL and ErrCode returns the following error code:

Error codeDescription
XML_INVALID_PARAMETER_ERRORParameter error
XML_INVALID_XML_OBJECT_ERRORInvalid XML handle
XML_INVALID_NODE_OBJECT_ERRORInvalid node is specified.
XML_NOT_FOUNDThe attribute with the specified name was not found.

Requirements

Header file:
XML.h
CodeConversion.h : ver. 1.1.1 or later.
Library file:
libXML.a
libCodeConversion.a : ver.1.1.1 or later
libSTARTUPOPH5000.a

See also

Last updated: 2021/10/21