指定のノードに属性を設定します。

構文

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

パラメータ

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

戻り値

 属性の設定が成功したらその属性のXML_Attribute構造体を指すポインタを、それ以外はNULLを返します。

解説

 指定されたノードにnamevalueで指定された属性を設定し、その属性のXML_Attribute構造体を指すポインタを返します。

 nameで指定された名前の属性がすでにあるときは、その属性の値を指定した値に書き換えます。

 nameで指定された名前の属性が存在しないときは、新しい属性を追加します。

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

エラーコード説明
XML_INVALID_PARAMETER_ERRORパラメーターエラー
XML_MEMORY_ALLOCATION_ERRORメモリーアロケーションエラー
XML_INVALID_XML_OBJECT_ERROR不正なXMLハンドルが指定された。
XML_INVALID_NODE_OBJECT_ERROR不正なノードが指定された。
XML_UNICODE_CONVERSION_ERRORユニコードに変換できないローカルコードの文字が検出された。

必要条件

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

関連事項

最終更新日:2021/10/21