RustファイルとIO

この章ではRust言語のI/O操作を紹介します。

コマンドライン引数の受け取り

コマンドラインプログラムはコンピュータープログラムの最も基本的な存在形態であり、ほとんどすべてのオペレーティングシステムがコマンドラインプログラムをサポートし、ビジュアルプログラムの動作をコマンドラインメカニズムに基づいています。

コマンドラインプログラムはコマンドライン環境からの引数を受け取れる必要があります。これらの引数は通常、コマンドラインのコマンドの後にスペースで区切られています。

多くの言語(JavaやC/C++など)では、環境引数はメイン関数のパラメータ(多くの場合、文字列配列)としてプログラムに渡されます。しかしRustでは、メイン関数は引数なしの関数であり、環境引数は開発者がstd::envモジュールを介して取得する必要があります。そのプロセスは非常に簡単です:

例

fn main() {
    let args = std::env::args();
    println!("{:?}", args);
}

では、プログラムを直接実行します:

Args { inner: ["D:\\rust\\greeting\\target\\debug\\greeting.exe"] }

得られる結果はこれよりもずっと長いかもしれませんが、それは正常です。この結果のArgs構造体にはinner配列があり、現在実行中のプログラムの場所を表す唯一の文字列だけが含まれています。

しかし、このデータ構造は理解しにくいです。大丈夫、単純にそれを反復処理できます:

例

fn main() {
    let args = std::env::args();
    for arg in args {
        println!("{}", arg);
    }
}

実行結果:

D:\rust\greeting\target\debug\greeting.exe

一般的に、引数は反復処理されるためにあるのです。

では、久しく触れていなかった launch.json を開き、"args": [] を見つけます。ここで実行時引数を設定できます。これを "args": ["first", "second"] と書き、保存して、もう一度先ほどのプログラムを実行します。実行結果:

D:\rust\greeting\target\debug\greeting.exe
first
second

実際のコマンドラインプログラムとして、私たちはそれを実際に使ったことはありません。言語チュートリアルとして、ここではコマンドラインでRustプログラムを実行する方法については説明しません。しかし、訓練された開発者であれば、実行可能ファイルの場所を見つけることができるはずです。ディレクトリに入り、コマンドラインコマンドを使用して、プログラムがコマンドライン環境引数を受け取ることをテストしてみてください。

コマンドライン入力

初期の章ではコマンドライン出力の使い方を詳しく説明しました。これは言語学習のためであり、出力がなければプログラムをデバッグできません。しかし、コマンドラインから入力情報を取得することは、コマンドラインプログラムにとって依然として非常に重要です。

Rustでは、std::ioモジュールが標準入力(コマンドライン入力と見なせます)の関連機能を提供します:

例

use std::io::stdin;

fn main() {
let mut str_buf = String::new();

    stdin().read_line(&mut str_buf)
        .expect("Failed to read line.");

    println!("Your input line is \n{}", str_buf);
}

VSCode環境でコマンドライン入力をサポートさせるのは非常に面倒なことで、クロスプラットフォームの問題やデバッグ不可の問題が関わってきます。そのため、VSCodeターミナルで直接プログラムを実行します。コマンドラインで実行:

D:\rust\greeting> cd ./target/debug
D:\rust\greeting\target\debug> ./greeting.exe
サンプル
Your input line is 
サンプル

std::io::Stdio には read_line 読み取りメソッドがあり、1行の文字列をバッファに読み取ることができます。戻り値はすべて Result 列挙型で、読み取り中に発生したエラーを渡すために使われます。そのため、通常は expect または unwrap 関数を使用してエラーを処理します。

注意:現在、Rust標準ライブラリはコマンドラインから数値やフォーマット済みデータを直接読み取る方法を提供していません。1行の文字列を読み取り、文字列認識関数を使用してデータを処理できます。

ファイル読み取り

コンピューターのD:\ディレクトリにファイル text.txt を作成します。内容は次のとおりです:

This is a text file.

これはテキストファイルの内容を文字列に読み込むプログラムです:

例

use std::fs;

fn main() {
    let text = fs::read_to_string("D:\\text.txt").unwrap();
    println!("{}", text);
}

実行結果:

This is a text file.

Rustでメモリに収まるファイル全体を読み取ることは非常に簡単です。std::fsモジュールのread_to_stringメソッドでテキストファイルの読み取りを簡単に行えます。

ただし、読み取るファイルがバイナリファイルの場合は、std::fs::read 関数を使用して u8 型のコレクションを読み取ることができます:

例

use std::fs;

fn main() {
    let content = fs::read("D:\\text.txt").unwrap();
    println!("{:?}", content);
}

実行結果:

[84, 104, 105, 115, 32, 105, 115, 32, 97, 32, 116, 101, 120, 116, 32, 102, 105, 108, 101, 46]

上記の2つの方法は一括読み取りであり、Webアプリケーションの開発に非常に適しています。しかし、一部の低レベルプログラムにとっては、従来のストリーム読み取り方式は依然として代替できません。なぜなら、多くの場合、ファイルサイズがメモリ容量をはるかに超える可能性があるからです。

Rustでのファイルストリーム読み取り方式:

例

use std::io::prelude::*;
use std::fs;

fn main() {
    let mut buffer = [0u8; 5];
    let mut file = fs::File::open("D:\\text.txt").unwrap();
    file.read(&mut buffer).unwrap();
    println!("{:?}", buffer);
    file.read(&mut buffer).unwrap();
    println!("{:?}", buffer);
}

実行結果:

[84, 104, 105, 115, 32] 
[105, 115, 32, 97, 32]

std::fsモジュールのFileクラスはファイルを記述するクラスであり、ファイルを開くために使用できます。ファイルを開いた後、Fileのreadメソッドを使用して、ファイルの次のバイト列をストリームでバッファ(バッファはu8配列)に読み取ることができます。読み取られるバイト数はバッファの長さに等しくなります。

注意:VSCode には現在、標準ライブラリの参照を自動的に追加する機能はありません。そのため、「関数またはメソッドが存在しない」というエラーが発生する場合、標準ライブラリの参照の問題である可能性があります。標準ライブラリのコメントドキュメント(マウスを置くと表示されます)を確認して、手動で標準ライブラリを追加できます。

std::fs::File の open メソッドは「読み取り専用」でファイルを開き、対応する close メソッドはありません。Rustコンパイラはファイルが不要になったときに自動的にファイルを閉じることができるからです。

ファイル書き込み

ファイル書き込みは一括書き込みとストリーム書き込みに分けられます。ストリーム書き込みではファイルを開く必要があり、開き方には「新規作成」(create)と「追記」(append)の2種類があります。

一括書き込み:

例

use std::fs;

fn main() {
    fs::write("D:\\text.txt", "FROM RUST PROGRAM")
        .unwrap();
}

これは一括読み取りと同じくらい簡単で便利です。プログラムを実行すると、D:\text.txt の内容は FROM RUST PROGRAM に書き換えられます。そのため、一括書き込みは慎重に使用してください!ファイルの内容を(ファイルがどれほど大きくても)直接削除するからです。ファイルが存在しない場合はファイルが作成されます。

ストリーム方式でファイルの内容を書き込む場合は、std::fs::File の create メソッドを使用できます:

例

use std::io::prelude::*;
use std::fs::File;

fn main() {
    let mut file = File::create("D:\\text.txt").unwrap();
    file.write(b"FROM RUST PROGRAM").unwrap();
}

このプログラムは前のプログラムと同等です。

注意:開いたファイルは、Fileのメソッドを使用できるように、可変変数に格納する必要があります!

Fileクラスには append 静的メソッドはありませんが、OpenOptions を使用して特定の方法でファイルを開くことができます:

例

use std::io::prelude::*;
use std::fs::OpenOptions;

fn main() -> std::io::Result<()> {
   
    let mut file = OpenOptions::new()
            .append(true).open("D:\\text.txt")?;

    file.write(b" APPEND WORD")?;

    Ok(())
}

実行後、D:\text.txt のファイル内容は次のようになります:

FROM RUST PROGRAM APPEND WORD

OpenOptions は柔軟なファイルの開き方であり、開く権限を設定できます。append 権限の他に、read 権限と write 権限があります。読み書き権限でファイルを開きたい場合は、次のように書けます:

例


use std::io::prelude::*;
use std::fs::OpenOptions;

fn main() -> std::io::Result<()> {
   
    let mut file = OpenOptions::new()
            .read(true).write(true).open("D:\\text.txt")?;

    file.write(b"COVER")?;

    Ok(())
}

実行後、D:\text.txt のファイル内容は次のようになります:

COVERRUST PROGRAM APPEND WORD
その他の拡張