指定のノードに子ノードを追加します。

構文

XML_Node *XML_AddChildNode(
  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] 追加する子ノードの値を指定する文字列を指すポインタ。値を持たない空ノードを追加するときはNULLを設定します。
ErrCode
[out] エラーコードを返す変数を指すポインタ。エラーコードが不要のときはNULLを指定します。

戻り値

 関数が成功したら追加したノードのXML_Node構造体を指すポインタを、それ以外はNULLを返します。  

解説

 指定されたノードに指定された名前と値を持つ子ノードを追加し、追加されたノードのXML_Node構造体を指すポインタを返します。

 指定されたノードが値を持っている場合は子ノードを追加できません。この場合、関数は失敗し、ErrCodeにXML_CHILD_NODE_DISALLOWED_ERRORを返します。

 関数が失敗したときは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_CHILD_NODE_DISALLOWED_ERRORノードが値が持っているため子ノードを追加できなかった。

必要条件

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

関連事項

最終更新日:2021/10/21