file.h マニュアル

(The documentation of file.h)

Last Update: 2022/12/1


file.hでは ファイルの状態のチェックやファイルに対する各種処理を行う関数が定義されている。 なお、ファイルのオープン・クローズを行う関数はこのヘッダファイルではなく functions_with_errcheck.h内にCKfopen, CKfcloseとして定義されている。
Functions to check the status and perform various processings for files are defined in file.h. However, functions to open and close a file are not included in this header file; opening and closing the files are implemented by functions CKfopen and CKfclose, respectively, in functions_with_errcheck.h.

このヘッダファイル内で定義されている関数を以下に示す。 各関数の詳細は関数名をクリックしてリンク先を参照のこと。
Functions defined in this header file are listed below. For details of individual functions, click the links.

関数名
Function name
機能・用途
Purpose
pathcheck ファイルのパス部分のディレクトリが存在するかをチェックする。
Check if the directory of a file path exists.
myflock ファイルを書き込み用のモード("w","a"など)で開いて 排他ロックを掛ける。
Open a file with a writing mode (e.g., "w" or "a") and apply an exclusive file lock.
survey_file_existance ファイルの存在の有無を調べる。 単に調べるだけで存在しなくてもエラーにはしない。
Survey whether a file exists. This function only surveys, without issuing errors.
file_existance_check ファイルの存在をチェックし、 ディレクトリ等ではなく通常のファイルであることを確認する。 ファイルが存在しない場合やディレクトリ等の場合はエラー終了する。
Check that a file exists and it is a regular file (i.e., not a directory, etc). The program finishes as an error if the file does not exist or is not a regular file.
file_overwrite_check ファイルを書き込みモードで開く前にファイルが存在するか確認し、 存在する場合には上書きしても良いかどうか尋ねる。
Check if a file exists before opening it by the writing mode, and consult to the user if the existing file should be overwritten.
countline ファイルの行数をカウントする。
Count the number of lines of a file.
countline_without_comment ファイルの行数をカウントする。 但し空行ならびにコメント行(#から始まる行)をカウントしない。
Count the number of lines of a file excluding empty lines and comment lines (i.e., lines starting with ‘#’).
countcolumn ファイルの列数をカウントする。
Count the number of columns of a file.
countcolumn_without_comment ファイルの列数をカウントする。 但し空行ならびにコメント(#から後ろの部分)を無視する。
Count the number of columns of a file, ignoring empty lines and comments (i.e., parts after ‘#’).
countstr ファイル中の文字数をカウントする。
Count the number of characters in a file.
readline ファイルから1行を読み込む。 各行の#から後の部分(コメント)および行末の空白を無視し、 空行は読み飛ばす。
Read a line from a file, skipping parts after ‘#’ (a comment) in each line, the blank at the end of each line, and empty lines.
fread_float バイナリファイルからfloat型のデータをdouble型変数に読み込む。
Read float-type data in a binary file to double-type variables.
fwrite_float double型変数をfloat型に変換してバイナリファイルに出力する。
Convert double-type variables to float-type and output to a binary file.
mymkdir ディレクトリを作成する。
Create a directory.
get_directory_filelist ディレクトリ内に存在するファイル名のリストを作成する。
Create a list of files that are in a directory.
read_and_decompose_line ファイルから1行を読み込んで列数が正しいかをチェックし、列に分解する。 タブで区切られた行の読み込み用。
Read a line from a file, check the number of columns, and decompose the line text to columns, for a line separated by tabs.
read_and_decompose_line_csv ファイルから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 (,).
read_and_decompose_line_without_comment ファイルから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.
read_and_decompose_line_without_comment_csv ファイルから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 commas (,).
mytmpnam 既存ファイルと重複しない一時ファイルを作成し、その名前を取得する。
Create a temporary file whose name is different from all the existing files, and get the newly created file name.