関数identify_XMLparentElement マニュアル

(The documentation of function identify_XMLparentElement)

Last Update: 2022/11/9

◆機能・用途(Purpose)

XML要素の親要素を同定する。
Identify the parent element of an XML element.

◆形式(Format)

#include <xml/parent_child.h>
inline int identify_XMLparentElement
(const int i, const int ∗startTag_startPos,const int ∗endTag_startPos)

◆引数(Arguments)

i	処理対象のXML子要素の番号。 The index of the XML child element to process.
startTag_startPos	XMLデータ中のXML要素の開始タグの先頭位置(配列要素番号)のリスト。関数list_XMLstartTag_startPosの戻り値を渡す。 A list of the start positions (array indices) of the start-tags of the XML elements in XMLdata. Use the return value of function list_XMLstartTag_startPos.
endTag_startPos	XMLデータ中のXML要素の終了タグの先頭位置(配列要素番号)のリスト。関数list_XMLendTag_startPosの戻り値を渡す。 A list of the start positions (array indices) of the end-tags of the XML elements in XMLdata. Use the return value of function list_XMLendTag_startPos.

◆戻り値(Return value)

i番目のXML要素の親要素の番号。root要素では-1を返す。
The index of the parent element of ith XML element. For a root tag, -1 is returned.

◆使用例(Example)

int startTag_startPos[]={0,9,16,39,70,77,100,123};
int endTag_startPos[]={154,62,27,50,146,88,111,134};

int parentElement =identify_XMLparentElement(6,startTag_startPos,endTag_startPos);

この例では配列startTag_startPos, endTag_startPosにより、 XMLデータが以下の構造を持つことが示されている。
In this example, arrays startTag_startPos and endTag_startPos indicate that the XML data has the following structure.

要素0: 0-154文字目
Element 0: 0-154th characters
- 要素1: 9-62文字目
  Element 1: 9-62th characters
  - 要素2: 16-27文字目
    Element 2: 16-27th characters
  - 要素3: 39-50文字目
    Element 3: 39-50th characters
- 要素4: 70-146文字目
  Element 4: 70-146th characters
  - 要素5: 77-88文字目
    Element 5: 77-88th characters
  - 要素6: 100-111文字目
    Element 6: 100-111th characters
  - 要素7: 123-134文字目
    Element 7: 123-134th characters

したがって要素6の親要素は要素4であり、上のコードを実行するとparentElement=4となる。
Therefore the parent element of the 6th element is the 4th element, and thus the code above results in parentElement=4.