関数read_and_decompose_line_csv マニュアル

(The documentation of function read_and_decompose_line_csv)

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, for a line separated by commas (,).


◆形式(Format)

#include <file.h>
inline char ∗∗read_and_decompose_line_csv
(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列の文字列、…、 というように並ぶ。 ファイルエンドに達した場合はNULLを返す。
An array composed of the strings that are in a line starting at the current position of fp, separated by commas (,). 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, …. NULL is returned if fp reached the file end.


◆使用例(Example)

FILE ∗fp;
char ∗∗linecontents_decomposed =read_and_decompose_line_csv(fp,3);


◆補足(Additional remarks)

この関数の目的と用途に関しては 関数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.