関数check_XMLemptyElementList マニュアル

(The documentation of function check_XMLemptyElementList)
Last Update: 2022/11/30


◆機能・用途(Purpose)

XML空要素の識別結果が正しく設定されているか否かをチェックする。
Check if the identification results of XML empty-elements are correctly configured.

◆形式(Format)

#include <xml/check.h>
inline void check_XMLemptyElementList
(const int Nelements,const int NemptyElements,
 const _Bool ∗emptyElementFlag)


◆引数(Arguments)

Nelements XML要素数。 関数count_XMLelements_in_textの戻り値を渡す。
The number of XML elements. Use the return value of function count_XMLelements_in_text.
NemptyElements XML空要素の個数。 関数count_XMLemptyElementsの戻り値を渡す。
The number of XML empty-elements. Use the return value of function count_XMLemptyElements.
emptyElementFlag 各XML要素が空要素か否かを示す真偽値(空要素の場合にtrue) を並べた配列。 関数identify_XMLemptyElementsの戻り値を渡す。
An array composed of logical values that indicate whether individual XML elements are empty-elements (true for empty-elements). Use the return value of function identify_XMLemptyElements.


◆動作(Behaviour)

以下の条件が満たされているかをチェックし、 いずれかが満たされていない場合にはプログラムをエラー終了する。
Check if the requirements below are satisfied. If one of them is not satisfied, finish the program as an error.

◆使用例(Example)

const char XMLdata[]="<dataset><data1><subdata1a></s ubdata1a><subdata1b></subdata1b><empty1c/></data1>& lt;data2>< subdata2a></subdata2a><subdata2b></subdata2b><subdata2 c></subdata2c></data2></dataset>"

int Nelements=count_XMLelements_in_text(strlen(XMLdata),XMLdata);

int ∗startTags_st =list_XMLstartTag_startPos(strlen(XMLdata),XMLdata,Nelements);

int ∗startTags_en =list_XMLstartTag_endPos(strlen(XMLdata),XMLdata,Nelements,startTags_st);

_Bool ∗emptyElementFlag=identify_XMLemptyElements (strlen(XMLdata),XMLdata,Nelements,startTags_st,startTags_en);

int NemptyElements=count_XMLemptyElements(Nelements,emptyElementFlag);

check_XMLemptyElements(Nelements,NemptyElements,emptyElementFlag);