xml/structure.h マニュアル

(The documentation of xml/structure.h)
Last Update: 2023/2/21


xml/structure.hでは xmlヘッダファイルパッケージで主に用いる構造体が定義されている。 各構造体の定義を以下に示す。
Structures mainly used in xml header file package are defined in xml/structure.h. Definitions of individual structures are shown below.

◆目次(Table of contents)


◆struct XMLdata型構造体 (A struct XMLdata-type structure)

1つのXMLファイル内のデータ全体を表現するための構造体である。 以下のメンバから成る。
A structure to represent an entire data in an XML file. This structure is composed of the following members.
型
Type 		メンバ名
Name of member 		メンバの意味
Meaning of member
int Nelements XML要素の総数。
The total number of XML elements.
struct XMLelements ∗ elements XML要素のリスト。 Nelements個の成分から成る配列で、 elements[0]がroot要素を表す。
A list of XML elements, which is an array composed of Nelements components; elements[0] represents the root element.

◆struct XMLelement型構造体 (A struct XMLelement-type structure)

XMLデータを構成する1つの要素の中身および他要素との関係を 表現するための構造体である。 以下のメンバから成る。 この構造体は専らstruct XMLdata型構造体のメンバelementsを構成する 配列要素として用いられ、 以下の説明中で要素の「番号」とは その配列要素の番号を表す。
A structure to represent the content of an XML element, including its relation to other elements. This structure is composed of the following members. This structure is used solely as an array component of the member elements of a struct XMLdata-type structure, and the “index” of an element in the description below points to the index of the array component.
型
Type 		メンバ名
Name of member 		メンバの意味
Meaning of member
int parentElement 親要素の番号。 親要素が無い場合(root要素の場合)は-1とする。
The index of the parent element. For an element that does not have a parent element, which occurs in case of the root element, use -1.
int NchildElements 子要素の個数。
The number of child elements.
int ∗ childElements 子要素の番号のリスト(NchildElements個の成分から成る配列)。
A list of the indices of child elements, given as an array composed of NchildElements components.
int depth 要素の深さ。 root要素を0、root要素の子要素を1、root要素の孫要素を2、… というように定義される。
The depth of the element, defined as 0 for the root element, 1 for the child elements of the root element, 2 for the groundchild elements of the root element, ….
int ∗ forefathers 先祖要素の番号(近親順)のリスト。
A list of the indices of forefather elements from closer to farther.
int Ndescendants 子孫要素の個数。
The number of descendant components.
int ∗ descendants 子孫要素の番号のリスト。
A list of the indices of descendant elements.
char ∗tagName タグ名。
The tag name.
int Nattributes 属性の個数。
The number of attributes.
char ∗∗ attributeNames 属性の名前のリスト。 Nattributes個の文字列から成る配列として与える。
A list of the names of attributes, given as an array composed of Nattribute components.
char ∗∗ attributeValues 属性の値のリスト。 Nattributes個の文字列から成る配列として与える。
A list of the values of attributes, given as an array composed of Nattribute components.
char ∗ content <タグ名>と</タグ名>に囲まれた部分の文字列 (タグは含まない)。 実際の文字列の長さに応じて配列長が決まる。
The string in the part bounded by <tag name> and </tag name> (not including the tags). The length of the array is determined based on the actual length of the string.