関数read_sequence_file_マニュアル

(The documentation of function read_sequence_file_)
Last Update: 2023/9/25


◆機能・用途(Purpose)

時系列データをファイルから読み込む。
Read a time series data from a file.

◆形式(Format)

#include <sequence/readwrite.h>
inline struct sequence read_sequence_file_
(const char ∗inputfile,const char ∗mode)


◆引数(Arguments)

inputfile 入力ファイル名。 拡張子はymaeda_opentoolsの時系列データの入出力ファイル形式 (独自のファイル形式参照) のいずれかとする。
The input file name. The extension must be one of the file formats of a time series data (see special file format).
mode 以下のいずれかの文字列。
One of the strings below.
  • "strict"
    入力ファイルが所定の書式を満たしているかチェックしながら読み込む。
    Check if the input file satisfies the format requirements while reading.

  • "fast"
    入力ファイルの書式チェックを省いて読み込みを高速化する。
    Quickly read the file by skipping the format checks.



◆戻り値(Return value)

読み込んだ時系列データ。
The time series data read.

◆使用例(Example)

struct sequence seq=read_sequence_file_ ("data.seq1","strict");


◆補足(Additional notes)

従来、read_sequence_fileという名前の関数(末尾の「_」無し)を使用しており、 そこには第2引数(mode)は存在せず常に"strict"モードで読み込んでいた。 read_sequence_fileを使った既存のプログラムを書き換えなくても済むように、 関数を現在のものに変更した際に 関数形式マクロread_sequence_fileを用意した。
Originally, a function read_sequence_file (without “_” at the end) has been used, which did not consist of the 2nd argument (“mode”) and has always been operated with the "strict" mode. To avoid rewriting existing programs that have used the function read_sequence_file, a function-type macro with the same name was made available.