関数identify_XMLchildElements マニュアル

(The documentation of function identify_XMLchildElements)

Last Update: 2022/11/9


◆機能・用途(Purpose)

XML要素の子要素を同定する。
Identify the child elements of an XML element.


◆形式(Format)

#include <xml/parent_child.h>
inline int identify_XMLchildElements
(const int Nelements,const int i,const int ∗parentElements,
 int ∗∗childElements)


◆引数(Arguments)

Nelements XML要素の個数。
The number of XML elements.
i 処理対象のXML親要素の番号。
The index of the XML parent element to process.
parentElements 各XML要素の親要素の番号を並べた配列。
An array composed of the index of the parent element of each XML element.
childElements i番目のXML要素の子要素の番号のリストの代入先。 宣言しただけのint ∗型変数に&を付けて与える。
Memory into which a list of the indices of the child elements of ith XML element will be inserted within the function. Give an empty int ∗-type variable with &.


◆戻り値(Return value)

i番目のXML要素の子要素の個数。
The number of the child elements of ith XML element. For a root tag, -1 is returned.


◆使用例(Example)

int parentElements[]={-1,0,1,1,0,4,4,4};
int ∗childElements;

int NchildElements =identify_XMLchildElements(8,1,parentElements,&childElements);

この例では配列parentElementsの値により 各XML要素の親要素が以下のように設定されている。
In this example, the array parentElements defines the parent element of each XML element as follows.

XML要素
An XML element
親要素
The parent element
0 無し
None
1 0
2 1
3 1
4 0
5 4
6 4
7 4

したがって要素1の子要素は2,3であり、関数を実行すると NchildElements=2, childElements[]={2,3}となる。
Therefore the child elements of element 1 are 2 and 3; executing the function thus gives NchildElements=2 and childElements[]={2,3}.