[ 前へ | 目次 | 次へ ]

汎用ファイル入出力

ここでは、テキストCSV/TSV形式などの、より高度なファイル入出力を扱います。

スポンサーリンク


より汎用的な入出力
( テキストCSV/TSV ファイル )

前回扱った標準ファイル入出力は、高速ですが、非常に単純な挙動のものです。

例えばCSV/TSV ファイルは数値データを想定したもので、単純に数値をカンマなどで区切って書き込み、 同様に区切って読み込むだけです。 しかし、数値に限らずより汎用的な内容、つまりテキストをCSV/TSV で書き込むには、複雑な処理が必要です。

まずは、基本的な項目について説明します。

デリミタ

CSVならカンマ記号、TSVならタブ記号などのように、 値を区切る文字の事をデリミタと呼びます。 デリミタには、他にも半角スペースやセミコロンなどがよく使われます。

エンクロージャ

例えばCSV 形式で、書き込む値がカンマ記号を含む場合、そのまま書き込んだのでは、 それが「 区切り文字(デリミタ) 」としてのカンマ記号なのか、 それとも 「 値の一部 」 としてのカンマ記号なのか、区別のつかない曖昧なファイルになってしまいます:

あいう,えお,かきくけこ,さしすせそ
ABC,DE,FGHIJ,KL,MNO

上の例では、「 あいう,えお 」 という値を書き込んだとしても、それは区切りのカンマと区別できません。 そのため、テキストを扱うCSV 形式では、そのような場合に値をダブルクォーテーションなどで区切ります。 このように囲む記号をエンクロージャと呼びます。

"あいう,えお",かきくけこ,さしすせそ
ABC,DE,FGHIJ,"KL,MNO"

こうすると、最初の値は 「 あいう,えお 」 という意味なのだと区別できます。改行を含む場合も 同様に:

"あいう
えお",かきくけこ,さしすせそ
ABC,DE,FGHIJ,"KL
MNO"

こうすると最初の値は 「 あいう(改行)えお 」 という意味であると区別できます。 なお、値がエンクロージャと同じ文字が含む場合、エンクロージャを2 つ並べるなどして区別します。

コメント行

コメント行など、特定の文字で始まる行は無視して読み込ませたい場合もあります。

"あいう,えお",かきくけこ,さしすせそ
#この行はコメント行なので無視する
ABC,DE,FGHIJ,"KL,MNO"

コメント行の行頭文字は、そのファイルを扱うソフトによって多種多様です。

汎用ファイル入出力ライブラリ

上で述べたような項目への対応は、テキスト主体の汎用的なファイル入出力を行うためには避けられません。

しかし、前章で述べたような標準ファイル入出力関数は、 もともと数値ファイルを想定した単純なものであったため、 これらの項目に対応する機能がありません。 そのためVCSSL 3.1 以前では、load 関数などでファイル内容をまるごと読み込み、文字列解析を行って、 こうした機能の処理を自分で記述する必要がありました。

しかしVCSSL3.2 からは、これらの項目に対応した、 汎用ファイル入出力機能(ライブラリ)が標準サポートで用意されました。 これにより、標準ファイル入出力関数とほぼ同様の簡単な操作で、こういった項目に対応する高度な入出力を、 自動で行えるようになりました。

CSV形式テキストファイルの書き込み

例として、CSV 形式でテキストファイルを書き込みます。

実行すると、以下の内容のファイルが書き出されます。

"あいう,えお",かきくけこ,さしすせそ
#この行はコメントなので無視する
ABCDE,FGHIJ,"KL,MNO"

カンマ記号を含む値が、正しくエンクロージャで囲まれています。 また、コメント行は設定した「#」を付けて書き出されています。

プログラムの最初の行「 import file.TextFile; 」は、汎用入出力を行うために必要です。 具体的には、汎用ファイル入出力機能を提供するプログラム(ライブラリ)を読み込んでいますが、 これについては後の 「 モジュールとライブラリ 」 の章で説明します。

内容については、全体的に標準ファイル入出力とかなり似ているので、 特に違和感無く使用できると思われますが、以下の1 行は形が異なります。

この部分は、標準ファイル入出力の場合なら以下のようになるでしょう:

このように、標準ファイル入出力(下)ならばファイル番号を int 型の変数 file で受け取るわけですが、 汎用ファイル入出力(上)では TextFile という見たことの無い型の変数で受け取っています。

これはすぐ後の章で説明しますが、構造体というもので、いわば新しい型です。ここではとりあえず int 型の代わりに TextFile 型を用いるだけなので、あまり深く考える必要はありません。

なお、標準ファイル入出力と同様、モードは以下のように定数で指定する事もできます。定数名も標準ファイル入出力と全く同じです。タイプ数は増えますが、タイプミスが構文エラーで分かるので防げます。

CSV形式テキストファイルの読み込み

続いて、先ほど作成したCSV 形式でテキストファイルを読み込みます。

実行すると、コンソールに以下の内容が出力されます。

0 行目: あいう,えお/かきくけこ/さしすせそ
1 行目: ABCDE/FGHIJ/KL,MNO

このように、エンクロージャを認識した上で、「 あい,うえお 」を1 つの値として読み込めました。 また、コメント行は無視されています。

ファイル行数をカウントするcountln 関数も、コメント行は完全に無視して数えるてくれるめ、 ファイル行末を超過して読み込んでしまう事もありません。 なお、エンクロージャで囲まれた値が改行コードを含む場合についても、countln 関数はそれを1 行にはカウントせず、 あくまで値に含まれた改行コードであると識別してくれます。 そのため、標準入出力と同様の感覚で、まずcountln 関数で行数を取得し、その回数だけreadln 関数で読み進めるだけで、 簡単にテキストCSV/TSV ファイルの入出力を行う事ができます。

入出力時の挙動に関する細かな設定

汎用入出力では、細かな設定が可能です。詳細は下記URL の公式仕様をご参照ください。

上記ページでは、ここで用いた汎用ファイル入出力機能を提供するライブラリの、詳細な仕様を確認できます。



スポンサーリンク



この階層の目次
お知らせ

各ソフトウェアをアップデート、リニアングラフのコマンド拡張やVCSSLの英語対応など
2024/02/05 - 各ソフトの一斉アップデートの内容をお知らせします。今回は、リニアングラフのコマンド機能を大幅拡張したのがメインです。また、VCSSLのメッセージ類の英語対応も行いました。

Vnano の Ver.1.1 で実装した反復計算高速化の内側
2024/01/17 - 前回のお知らせ記事の続編です。スクリプトエンジン Vnano の Ver.1.1 において実施した高速化を、エンジン内部の実装面から掘り下げて解説します。

スクリプトエンジン Vnano の Ver.1.1 を公開、同じ内容の反復実行が劇的に高速化
2023/12/22 - スクリプトエンジン Vnano の最新版を公開しました。同じ計算式やスクリプトを反復実行する速さが、大幅に向上しました。次期版リニアングラフ3D内での活用例を交えつつ、詳しく解説します。

新着
[公式ガイドサンプル] 各種の図形や画像を描画する

「VCSSL 2DCG開発ガイド」内のサンプルコードです。図形や画像などを描画します。
2022/12/16
角度の「度」とラジアンとを相互変換し、図示もするツール

45度などの「度」の値と、ラジアンの値とを相互に変換できるツールです。対応する角度の図示もできます。
2022/11/22
[公式ガイドサンプル] 立体モデルを回転させるアニメーション

「VCSSL 3DCG開発ガイド」内のサンプルコードです。立体モデルを、アニメーションで回転させ続けます
2022/11/18
[公式ガイドサンプル] 立体モデルを回転させる

「VCSSL 3DCG開発ガイド」内のサンプルコードです。立体モデルを、指定した角度だけ回転させます。
2022/11/17
[公式ガイドサンプル] 四則演算の計算順序や、カッコを使った順序指定

「VCSSLスタートアップガイド」内のサンプルコードです。四則演算が計算される順序や、カッコを使って順序を指定する方法を例示します。
2022/10/31