名前を指定してノードの属性を検索します。

構文

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

パラメータ

hXml
[in] XMLハンドル
node
[in] ノードのXML_Node構造体を指すポインタ。
name
[in] 属性の名前を指定する文字列を指すポインタ。
ErrCode
[out] エラーコードを返す変数を指すポインタ。エラーコードが不要のときはNULLを指定します。

戻り値

 関数が成功したらXML_Attribute構造体を指すポインタを、それ以外はNULLを返します。

解説

 指定されたノードに指定された名前の属性があれば、その属性のXML_Attribute構造体を指すポインタを返します。

 属性の値は、XML_Attribute構造体valueメンバから取得します。

 関数が失敗したときはNULLを返し、ErrCodeには次のエラーコードを返します。

エラーコード説明
XML_INVALID_PARAMETER_ERRORパラメーターエラー
XML_INVALID_XML_OBJECT_ERROR不正なXMLハンドルが指定された。
XML_INVALID_NODE_OBJECT_ERROR不正なノードが指定された。
XML_NOT_FOUND指定した名前の属性が見つからなかった。

必要条件

ヘッダファイル:
XML.h
CodeConversion.h : ver.1.1.1以降
ライブラリファイル:
libXML.a
libCodeConversion.a : ver.1.1.1以降
libSTARTUPOPH5000.a

関連事項

最終更新日:2021/10/21