(The documentation of function
read_and_decompose_line_without_comment)
Last Update: 2021/12/1
◆機能・用途(Purpose)
ファイルから1行を読み込んで列数が正しいかをチェックし、列に分解する。
各行の#から後の部分(コメント)および行末の空白を無視し、空行は読み飛ばす。
タブで区切られた行の読み込み用。
Read a line from a file, check the number of columns,
and decompose the line text to columns.
Parts after “#” (a comment) in each line,
the blank at the end of each line,
and empty lines are skipped.
This function is for a line separated by tabs.
◆形式(Format)
#include <file.h>
inline char ∗∗read_and_decompose_line_without_comment
(FILE ∗fp,const int correct_number_of_column)
◆引数(Arguments)
fp
読み込むファイルのファイルポインタ。
The file pointer of a file to read.
correct_number_of_column
読み込む行の正しい列数。
The correct number of columns for the line to read.
◆戻り値(Return value)
fpの現在の位置から1行読み込んでタブで分解した文字列を並べた配列。
配列の先頭要素は第1列の文字列、配列の2番目の要素は第2列の文字列、…、
というように並ぶ。
1行の末尾の「#」から後の部分と空白、および空行を
コメントとして読み飛ばす。
ファイルエンドに達した場合はNULLを返す。
An array composed of the strings
that are in a line starting at the current position of fp,
separated by tabs.
The string in the 1st column is inserted to the 1st array component,
that in the 2nd column is inserted to the 2nd array component, ….
A part after “#” and a blank at the end of each line,
as well as blank lines, are skipped as comments.
NULL is returned if fp reached the file end.
この関数の目的と用途に関しては
関数read_and_decompose_lineのマニュアルの「補足」参照。
See “Additional remarks”
of the documentation of function read_and_decompose_line
to understand the purpose and situation of using this function.