関数identify_XMLdeclaration マニュアル

(The documentation of function identify_XMLdeclaration)

Last Update: 2022/11/2

◆機能・用途(Purpose)

XMLデータを表す文字列におけるXML宣言の範囲の同定とチェックを行う。
Identify and check the extent of the XML declaration in a text that represents an XML data.

◆形式(Format)

#include <xml/info.h>
inline int identify_XMLdeclaration
(const int data_length,const char ∗XMLdata)

◆引数(Arguments)

data_length	XMLデータの長さ(バイト数)。 The length (the number of bytes) of an XML data.
XMLdata	XMLデータが格納された文字列。 A text that represents the XML data.

◆戻り値(Return value)

引数XMLdataにおけるXML宣言部の文字列長。
The string length for the XML declaration part of argument XMLdata.

XMLdataがXML宣言から始まっていない場合や XML宣言が閉じていない場合はプログラムをエラー終了する。
The program finishes as an error if XMLdata does not begin with an XML declaration, or the XML declaration does not close.

◆使用例(Example)

const char XMLdata[]="<?xml version="1.0"?><dataset><data1></data1></dataset>"

int declareLength=identify_XMLdeclaration(strlen(XMLdata),XMLdata);

この例では「<?xml version="1.0"?>」が21文字なので declareDength=21となる。
This example gives declareLength=21 because “<?xml version="1.0"?>” consists of 21 characters.