Node.jsでテキストファイルやバイナリファイルのデータを読み込む

2016/02/22 2016/11/26

1 非同期的な読み込み
2 同期的な読み込み
3 ストリームを使用した読み込み
4 使い分け
5 サンプルコード1
- 5.1 fs-readfile-text.js
- 5.2 実行結果
6 サンプルコード2
- 6.1 fs-readfilesync-text.js
- 6.2 実行結果
7 サンプルコード3
- 7.1 fs-createreadstream.js
- 7.2 実行結果
8 関連

テキストファイルやバイナリファイルのデータを読み込むには非同期的に読み込む方法と同期的に読み込む方法とストリームを使用して読み込む方法の3つがあります。

ストリームとは？

Node.js

ストリームとはサイズが非常に大きなデータを取り扱う際などには、データの全てを一度にメモリに読み込んでしまうとメモリが逼迫し、プログラムのパフォーマンスを低下させてしまう可能性があります。そのような場合にはストリームを使用します。ストリームとはデータを徐々に読み込んだり、書き込んだり、変換したりすることができ

なお、テキストファイルのデータの読み込みにおいて対応している文字コードはバッファが対応している文字コードと同じです。

対応している文字コードに関しては下の記事の「文字コード」の項を参照してください。

文字コード

Node.js

バッファについて

バッファとはバッファとはメモリ上に確保される、バイナリデータを格納するための領域です。バッファは作成時に長さを指定し、作成後に長さを変更することはできません。 Node

非同期的な読み込み

テキストファイルやバイナリファイルのデータを非同期的に読み込むにはfs.readFile関数を使用します。

var fs = require('fs');

fs.readFile('xxx', {
    encoding: 'utf-8'
}, function (err, data) {
});
//or
fs.readFile('xxx', 'utf-8', function (err, data) {
});
//or
fs.readFile('xxx', function (err, data) {
});

第1引数にファイルのパスを指定します。

第2引数にオプションをオブジェクトとして指定します。この引数は指定しなくても構いません。

オプションには下のようなものがあります。

encoding・・・テキストファイルの文字コードを指定します。バイナリファイルのデータを読み込む場合には指定しません。

ただし、第2引数にはオプションをオブジェクトとして指定するのではなく、テキストファイルの文字コードのみを直接指定することもできます。

第3引数にコールバック関数を指定します。この関数の第1引数はエラーオブジェクトであり、第2引数はファイルのデータです。

このデータは第2引数の文字コードを指定した場合には文字列となり、指定しなかった場合にはバッファとなります。

なお、ファイルが存在しない場合にはエラーが発生します。

同期的な読み込み

テキストファイルやバイナリファイルのデータを同期的に読み込むにはfs.readFileSync関数を使用します。

var data = fs.readFileSync('xxx', {
    encoding: 'utf-8'
});
//or
var data = fs.readFileSync('xxx', 'utf-8');
//or
var data = fs.readFileSync('xxx');

第1引数にファイルのパスを指定します。

第2引数にオプションをオブジェクトとして指定します。この引数は指定しなくても構いません。このオプションはfs.readFile関数の第2引数のオプションと同じです。

返り値としてファイルのデータが得られます。

このデータは第2引数の文字コードを指定した場合には文字列となり、指定しなかった場合にはバッファとなります。

なお、ファイルが存在しない場合にはエラーが発生します。

ストリームを使用した読み込み

ストリームを使用してテキストファイルやバイナリファイルのデータを読み込むにはfs.createReadStream関数を使用します。

var rs = fs.createReadStream('xxx', {
    encoding: 'utf-8', 
    start: 100, 
    end: 200
});
//or
var rs = fs.createReadStream('xxx', 'utf-8');
//or
var rs = fs.createReadStream('xxx');

第1引数にファイルのパスを指定します。

第2引数にオプションをオブジェクトとして指定します。この引数は指定しなくても構いません。

オプションには下のようなものがあります。

encoding・・・テキストファイルの文字コードを指定します。バイナリファイルのデータを読み込む場合には指定しません。
start・・・読み込みの開始位置をバイト単位で指定します。
end・・・読み込みの終了位置をバイト単位で指定します。

返り値としてファイルのデータを読み込む読み込みストリームが得られます。

なお、ファイルが存在しない場合にはエラーが発生します。

使い分け

原則的にはfs.readFile関数かfs.createReadStream関数を使用するべきであり、特に理由がないならfs.readFileSync関数は使用するべきではありません。

これは、ファイルへのアクセスは非常に時間の掛かる処理であるためです。ファイルへのアクセスを同期的に行うとアクセスが完了するまでプログラムは待機状態となり、他の処理を行うことができません。長い時間プログラムが待機状態になると様々な問題を引き起こす可能性があります（このような現象をスターベーションと言います）。

スターベーションとは？

Node.js

Node.jsのパフォーマンス

Node.jsを使用するとパフォーマンスが高いウェブアプリケーションを作成することができます。では、何故パフォーマンスが高いウェブアプリケーションを作成することができるのでしょうか。それはディスクやネットワークからのデータの読み込みには非常に時間が掛かるということが関係しています。データを読み込むのに掛かる

また、fs.readFile関数やfs.readFileSync関数はファイルのデータ全体をメモリにロードします。そのため、ファイルのサイズが非常に大きい場合には使用するべきではありません。そのような場合にはfs.createReadStream関数を使用するべきです。

サンプルコード1

fs.readFile関数の使用例です。

3つ目のコマンドライン引数として与えられたテキストファイルのデータを非同期的に読み込み、標準出力に出力します。

fs-readfile-text.js

var fs = require('fs');

if (process.argv.length < 3) {
    console.error('lack argument.');
    process.exit(1);
}

fs.readFile(process.argv[2], 'utf-8', function (err, data) {
    if (err) {
        console.error(err);
        process.exit(1);
    }
    else {
        process.stdout.write(data);
    }
});

実行結果

現在のフォルダにはtextfile.txtという名称のテキストファイルが存在しています（文字コードはUTF-8です）。

C:\work\node>type textfile.txt
これはテキストファイルの内容です。

このテキストファイルを3つ目のコマンドライン引数に指定してコードを実行すると正しく内容が出力されます。

C:\work\node>node fs-readfile-text.js textfile.txt
これはテキストファイルの内容です。

存在しないテキストファイルやフォルダを指定した場合にはエラーが発生します。

C:\work\node>node fs-readfile-text.js textfile2.txt
{ [Error: ENOENT: no such file or directory, open 'C:\work\node\textfile2.txt']
  errno: -4058,
  code: 'ENOENT',
  syscall: 'open',
  path: 'C:\\work\\node\\textfile2.txt' }

C:\work\node>node fs-readfile-text.js C:\work\node
{ [Error: EISDIR: illegal operation on a directory, read] errno: -4068, code: 'EISDIR', syscall: 'read' }

なお、テキストファイルの文字コードがUTF-8でない場合には下のように文字化けします。

C:\work\node>type textfile.txt
����̓e�L�X�g�t�@�C���̓�e�ł��B
C:\work\node>node fs-readfile.js textfile.txt
�����̓e�L�X�g�t�@�C���̓��e�ł��B

サンプルコード2

fs.readFileSync関数の使用例です。

3つ目のコマンドライン引数として与えられたテキストファイルのデータを同期的に読み込み、標準出力に出力します。

fs-readfilesync-text.js

var fs = require('fs');

if (process.argv.length < 3) {
    console.error('lack argument.');
    process.exit(1);
}

var data = '';
try {
    data = fs.readFileSync(process.argv[2], 'utf-8');
}
catch (err) {
    console.error(err);
    process.exit(1);
}

process.stdout.write(data);

実行結果

現在のフォルダにはtextfile.txtという名称のテキストファイルが存在しています（文字コードはUTF-8です）。

C:\work\node>type textfile.txt
これはテキストファイルの内容です。

このテキストファイルを3つ目のコマンドライン引数に指定してコードを実行すると正しく内容が出力されます。

C:\work\node>node fs-readfilesync-text.js textfile.txt
これはテキストファイルの内容です。

存在しないテキストファイルやフォルダを指定した場合にはエラーが発生します。

C:\work\node>node fs-readfilesync-text.js textfile2.txt
{ [Error: ENOENT: no such file or directory, open 'C:\work\node\textfile2.txt']
  errno: -4058,
  code: 'ENOENT',
  syscall: 'open',
  path: 'C:\\work\\node\\textfile2.txt' }

C:\work\node>node fs-readfilesync-text.js C:\work\node
{ [Error: EISDIR: illegal operation on a directory, read] errno: -4068, code: 'EISDIR', syscall: 'read' }

なお、テキストファイルの文字コードがUTF-8でない場合には下のように文字化けします。

C:\work\node>type textfile.txt
����̓e�L�X�g�t�@�C���̓�e�ł��B
C:\work\node>node fs-readfilesync-text.js textfile.txt
�����̓e�L�X�g�t�@�C���̓��e�ł��B

サンプルコード3

fs.createReadStream関数の使用例です。

3つ目のコマンドライン引数として与えられたテキストファイルのデータをストリームを使用して読み込み、標準出力に出力します。

fs-createreadstream.js

var fs = require('fs');

if (process.argv.length < 3) {
    console.error('lack argument.');
    process.exit(1);
}

try {
    var rs = fs.createReadStream(process.argv[2], 'utf-8');
    rs.on('data', function (data) {
        process.stdout.write(data);
    });
    rs.on('error', function (err) {
        console.error(err);
        process.exit(1);
    });
}
catch (err) {
    console.error(err);
    process.exit(1);
}

実行結果

現在のフォルダにはtextfile.txtという名称のテキストファイルが存在しています（文字コードはUTF-8です）。

C:\work\node>type textfile.txt
これはテキストファイルの内容です。

このテキストファイルを3つ目のコマンドライン引数に指定してコードを実行すると正しく内容が出力されます。

C:\work\node>node fs-createreadstream.js textfile.txt
これはテキストファイルの内容です。

存在しないテキストファイルやフォルダを指定した場合にはエラーが発生します。

C:\work\node>node fs-createreadstream.js textfile2.txt
{ [Error: ENOENT: no such file or directory, open 'C:\work\node\textfile2.txt']
  errno: -4058,
  code: 'ENOENT',
  syscall: 'open',
  path: 'C:\\work\\node\\textfile2.txt' }

C:\work\node>node fs-createreadstream.js C:\work\node
{ [Error: EISDIR: illegal operation on a directory, read] errno: -4068, code: 'EISDIR', syscall: 'read' }

なお、テキストファイルの文字コードがUTF-8でない場合には下のように文字化けします。

C:\work\node>type textfile.txt
����̓e�L�X�g�t�@�C���̓�e�ł��B
C:\work\node>node fs-createreadstream.js textfile.txt
�����̓e�L�X�g�t�@�C���̓��e�ł��B

Message コメントをキャンセル

: Node.jsでShowdownを使ったMarkdown→HTML変換を行う

目次1 変換2 サンプルコード12.1 showdown.js2.2 使用パッケ ...

: Node.jsを使用する

目次1 REPL1.1 環境変数2 プログラムを実行する3 コマンドラインオプシ ...

: Node.jsで互いに依存関係のある複数の非同期的な処理を実行する

目次1 async.auto関数1.1 第1引数1.2 第2引数1.3 第3引数 ...

: Node.jsでイベントを使用する

目次1 イベントの発生2 イベントハンドラの登録3 イベントハンドラの登録解除4 ...

: Node.jsでストリームの接続（pipe）と同時にエラー処理を追加する

目次1 サンプルコード11.1 pump.js1.2 使用パッケージ1.3 実行 ...

PREV: 暗号通貨開発日誌 1日目
NEXT: Node.jsでテキストファイルやバイナリファイルにデータを書き込む

Node.jsでテキストファイルやバイナリファイルのデータを読み込む

非同期的な読み込み

同期的な読み込み

ストリームを使用した読み込み

使い分け

サンプルコード1

fs-readfile-text.js

実行結果

サンプルコード2

fs-readfilesync-text.js

実行結果

サンプルコード3

fs-createreadstream.js

実行結果

関連