関数remove_comments_from_XMLdata マニュアル

(The documentation of function remove_comments_from_XMLdata)

Last Update: 2023/2/20

◆機能・用途(Purpose)

XMLデータを表す文字列からコメントなど不要なものを取り除いて処理しやすく整形する。
Reformat a text that represents an XML data to be easier to treat, by removing unnecessary components (e.g., comments).

◆形式(Format)

#include <xml/reformat.h>
inline char ∗remove_comments_from_XMLdata
(const int data_length,const char ∗XMLdata_original)

◆引数(Arguments)

data_length	コメントを取り除く前のXMLデータの長さ(バイト数)。 The length (the number of bytes) of an XML data that consists of comments.
XMLdata_original	コメントを取り除く前のXMLデータが格納された文字列。 A text that represents the XML data that consists of comments.

◆戻り値(Return value)

XMLdata_originalから以下のものを取り除き、末尾に′\0′を追加した文字列。
A text that consists of the XML data in XMLdata_original except for the components below. A character ′\0′ is added at the end.

コメント (に囲まれた部分)
Comments bounded by
CDATA区間 (<![CDATA[と ]]>に囲まれた部分)
Comments bounded by <![CDATA[ and ]]>
タブ
Tabs
<, </, >, />, の直前や直後に登場する改行や空白
Linebreaks and blanks immediately before or after <, </, >, or />
\r
連続する改行や空白の2文字目以降
2nd and later characters of continuous linebreaks or blanks

◆使用例(Example)

char XMLdata_original[]="<?xml ?><dataset><data1></data1></dataset>";

char ∗XMLdata_noComments=remove_commnets_from_XMLdata(strlen(XMLdata_original),XMLdata_original);

この例では紫色の部分が取り除かれて
XMLdata_noComments="<?xml ?><dataset><data1></data1></dataset>"
となる。
In this example, the purple parts are removed, resulting in:
XMLdata_noComments="<?xml ?><dataset><data1></data1></dataset>"