構文
char *XML_GetChildNodeValueByPath(
XML_HANDLE hXml,
XML_Node *parentNode,
const char *childNodePath,
int *ErrCode
);
パラメータ
- hXml
- [in] XMLハンドル
- parentNode
- [in] 親ノードのXML_Node構造体を指すポインタ。
- childNodePath
- [in] 相対パスを指定する文字列を指すポインタ。
- ErrCode
- [out] エラーコードを返す変数を指すポインタ。エラーコードが不要のときはNULLを指定します。
戻り値
関数が成功したら指定のノードの値の文字列を指すポインタを、それ以外はNULLを返します。解説
親ノードと相対パスの指定に従ってノードを検索します。
ノードが見つかったときは、そのノードの値の文字列を指すポインタを返します。
見つかったノードが値を持たないときは、空文字("")を指すポインタを返します。
複数のノードが見つかったときは関数が失敗し、ErrCodeに XML_NOT_UNIQUE_NODE を返します。
見つかったノードが中間ノードだったときは関数が失敗し、ErrCodeに XML_NO_VALUE_IN_INTERMEDIATE_NODE を返します。
関数が失敗したときはNULLを返し、ErrCodeに次のエラーコードを返します。
エラーコード | 説明 |
---|---|
XML_INVALID_PARAMETER_ERROR | パラメーターエラー |
XML_MEMORY_ALLOCATION_ERROR | メモリーアロケーションエラー |
XML_INVALID_XML_OBJECT_ERROR | 不正なXMLハンドルが指定された。 |
XML_INVALID_NODE_OBJECT_ERROR | 不正なノードが指定された。 |
XML_NOT_FOUND | 指定した名前のノードが見つからなかった。 |
XML_NOT_UNIQUE_INTERMEDIATE_NODE | ノードパスの途中の階層で、指定された名前のノードが複数検出された。 |
XML_NOT_UNIQUE_NODE | 同じ名前のノードが複数ある。 |
XML_NO_VALUE_IN_INTERMEDIATE_NODE | 中間ノードは値を持たない。 |
必要条件
- ヘッダファイル:
-
XML.h
CodeConversion.h : ver.1.1.1以降 - ライブラリファイル:
-
libXML.a
libCodeConversion.a : ver.1.1.1以降
libSTARTUPOPH5000.a
関連事項
最終更新日:2021/10/21