Gets the value of a node specified by a full path.

Syntax

char *XML_GetNodeValueByPath(
  XML_HANDLE hXml,
  const char *nodePath,
  int *ErrCode
);

Parameters

hXml: [in] XML handle
nodePath: [in] A pointer to a string that specifies the full path.
ErrCode: [out] A pointer to a variable that returns an error code. Specify NULL when no error code is required.

Returns a pointer to a string of values for the specified node if the function succeeds, or NULL otherwise.

Finds a node according to the specified full path.

If a node is found, returns a pointer to the string of the value for the node.

If the node found has no value, returns a pointer to the empty string ("").

If multiple nodes are found, the function fails and returns XML_NOT_UNIQUE_NODE in ErrCode.

If the node found is an intermediate node, the function fails and returns XML_NO_VALUE_IN_INTERMEDIATE_NODE in ErrCode.

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

Error code	Description
XML_INVALID_PARAMETER_ERROR	Parameter error
XML_MEMORY_ALLOCATION_ERROR	Memory allocation error
XML_INVALID_XML_OBJECT_ERROR	Invalid XML handle
XML_INVALID_NODE_OBJECT_ERROR	Invalid node is specified.
XML_NOT_FOUND	The node with the specified name was not found.
XML_NOT_UNIQUE_INTERMEDIATE_NODE	Multiple nodes with the specified name were found in the middle of the node path.
XML_NOT_UNIQUE_NODE	There are multiple nodes with the same name.
XML_NO_VALUE_IN_INTERMEDIATE_NODE	Intermediate nodes are not allowed to have a value.

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