Java : BufferedReader - API使用例

BufferedReader (Java SE 17 & JDK 17) の使用例まとめです。
だいたいのメソッドを網羅済みです。
API仕様のおともにどうぞ。


概要

文字、配列、行をバッファリングすることによって、文字型入力ストリームからテキストを効率良く読み込みます。

クラス構成

final var path = Path.of("R:", "java-work", "aaa.txt");
System.out.println(path); // R:\java-work\aaa.txt

Files.writeString(path, """
        abcd
        XYZ
        12345
        """);

// --- PowerShell ---
//PS R:\java-work> ls | Format-Table -Property Mode, Length, Name
//
//Mode  Length Name
//----  ------ ----
//-a---     15 aaa.txt

try (final var reader = Files.newBufferedReader(path)) {

    System.out.println(reader.readLine()); // abcd
    System.out.println(reader.readLine()); // XYZ
    System.out.println(reader.readLine()); // 12345
    System.out.println(reader.readLine()); // null
}

BufferedReader は使い終わったら close が必要です。
try-with-resources文 を使い、リソースリークが起きないようにしましょう。

Readerで宣言されたフィールド

lock

Java API 使用例 : Reader」をご参照ください。

コンストラクタ

BufferedReader (Reader in)

デフォルト・サイズのバッファでバッファリングされた、文字型入力ストリームを作成します。

final var s = """
        abcd
        XYZ
        """;

try (final var reader = new BufferedReader(new StringReader(s))) {

    System.out.println(reader.readLine()); // abcd
    System.out.println(reader.readLine()); // XYZ
    System.out.println(reader.readLine()); // null
}

BufferedReader (Reader in, int sz)

指定されたサイズのバッファでバッファリングされた、文字型入力ストリームを作成します。

final var s = """
        abcd
        XYZ
        """;

try (final var reader = new BufferedReader(new StringReader(s), 128)) {

    System.out.println(reader.readLine()); // abcd
    System.out.println(reader.readLine()); // XYZ
    System.out.println(reader.readLine()); // null
}

メソッド

void close ()

ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。

final var path = Path.of("R:", "java-work", "aaa.txt");
System.out.println(path); // R:\java-work\aaa.txt

Files.writeString(path, "abcd");

try (final var reader = Files.newBufferedReader(path)) {

    final var cbuf = new char[4];

    System.out.println(reader.read(cbuf)); // 4
    System.out.println(Arrays.toString(cbuf)); // [a, b, c, d]
}
// try-with-resources文を使わない例です。
final var path = Path.of("R:", "java-work", "aaa.txt");
System.out.println(path); // R:\java-work\aaa.txt

Files.writeString(path, "abcd");

final var reader = Files.newBufferedReader(path);
try {
    final var cbuf = new char[4];

    System.out.println(reader.read(cbuf)); // 4
    System.out.println(Arrays.toString(cbuf)); // [a, b, c, d]
} finally {
    reader.close();
}

Stream<String> lines ()

Streamを返します。要素はBufferedReaderから読み込まれる行です。

final var path = Path.of("R:", "java-work", "aaa.txt");
System.out.println(path); // R:\java-work\aaa.txt

Files.writeString(path, """
        abcd
        XYZ
        12345
        """);

// --- PowerShell ---
//PS R:\java-work> ls | Format-Table -Property Mode, Length, Name
//
//Mode  Length Name
//----  ------ ----
//-a---     15 aaa.txt

try (final var reader = Files.newBufferedReader(path)) {

    final var lines = reader.lines();
    lines.forEach(System.out::println);
}

// 結果
// ↓
//abcd
//XYZ
//12345

void mark (int readAheadLimit)

ストリームの現在位置にマークを設定します。

try (final var reader = new BufferedReader(new StringReader("abcde"))) {

    System.out.println("%c".formatted(reader.read())); // a
    System.out.println("%c".formatted(reader.read())); // b
    System.out.println("%c".formatted(reader.read())); // c

    reader.mark(3);

    System.out.println("%c".formatted(reader.read())); // d
    System.out.println("%c".formatted(reader.read())); // e
    System.out.println(reader.read()); // -1

    reader.reset();

    System.out.println("%c".formatted(reader.read())); // d
    System.out.println("%c".formatted(reader.read())); // e
    System.out.println(reader.read()); // -1

    reader.reset();
    reader.mark(2);

    System.out.println("%c".formatted(reader.read())); // d
    System.out.println("%c".formatted(reader.read())); // e
    System.out.println(reader.read()); // -1

    try {
        // readAheadLimit に達してリセットしようとすると例外が発生します。
        reader.reset();
    } catch (IOException e) {
        System.out.println(e);
    }

    // 結果
    // ↓
    //java.io.IOException: Mark invalid
}

boolean markSupported ()

このストリームが、実行するmark()オペレーションをサポートするかどうかを通知します。

try (final var reader = Files.newBufferedReader(Path.of("R:", "java-work", "aaa.txt"))) {
    System.out.println(reader.markSupported()); // true
}

try (final var reader = new BufferedReader(new StringReader("abcd"))) {
    System.out.println(reader.markSupported()); // true
}

int read ()

単一の文字を読み込みます。

try (final var reader = new BufferedReader(new StringReader("abc"))) {

    System.out.println("%c".formatted(reader.read())); // a
    System.out.println("%c".formatted(reader.read())); // b
    System.out.println("%c".formatted(reader.read())); // c
    System.out.println(reader.read()); // -1
}

int read (char[] cbuf, int off, int len)

配列の一部に文字を読み込みます。

try (final var reader = new BufferedReader(new StringReader("abcdefg"))) {

    final var cbuf = new char[5];

    System.out.println(reader.read(cbuf, 0, 1)); // 1
    System.out.println(Arrays.toString(cbuf)); // [a,  ,  ,  ,  ]

    System.out.println(reader.read(cbuf, 0, 2)); // 2
    System.out.println(Arrays.toString(cbuf)); // [b, c,  ,  ,  ]

    System.out.println(reader.read(cbuf, 0, 3)); // 3
    System.out.println(Arrays.toString(cbuf)); // [d, e, f,  ,  ]

    System.out.println(reader.read(cbuf, 0, 4)); // 1
    System.out.println(Arrays.toString(cbuf)); // [g, e, f,  ,  ]

    System.out.println(reader.read(cbuf, 0, 5)); // -1
    System.out.println(Arrays.toString(cbuf)); // [g, e, f,  ,  ]
}
try (final var reader = new BufferedReader(new StringReader("abcde"))) {

    final var cbuf = new char[5];

    System.out.println(reader.read(cbuf, 4, 1)); // 1
    System.out.println(Arrays.toString(cbuf)); // [ ,  ,  ,  , a]

    System.out.println(reader.read(cbuf, 3, 1)); // 1
    System.out.println(Arrays.toString(cbuf)); // [ ,  ,  , b, a]

    System.out.println(reader.read(cbuf, 2, 1)); // 1
    System.out.println(Arrays.toString(cbuf)); // [ ,  , c, b, a]

    System.out.println(reader.read(cbuf, 1, 1)); // 1
    System.out.println(Arrays.toString(cbuf)); // [ , d, c, b, a]

    System.out.println(reader.read(cbuf, 0, 1)); // 1
    System.out.println(Arrays.toString(cbuf)); // [e, d, c, b, a]
}
try (final var reader = new BufferedReader(new StringReader("abcdefg"))) {

    final var cbuf = new char[3];

    System.out.println(reader.read(cbuf, 0, 3)); // 3
    System.out.println(Arrays.toString(cbuf)); // [a, b, c]

    //reader.read(cbuf, 0, 4); // IndexOutOfBoundsException
    //reader.read(cbuf, 3, 1); // IndexOutOfBoundsException
}

String readLine ()

テキスト行を読み込みます。

final var path = Path.of("R:", "java-work", "aaa.txt");
System.out.println(path); // R:\java-work\aaa.txt

Files.writeString(path, """
        abcd
        XYZ
        12345
        """);

// --- PowerShell ---
//PS R:\java-work> ls | Format-Table -Property Mode, Length, Name
//
//Mode  Length Name
//----  ------ ----
//-a---     15 aaa.txt

try (final var reader = Files.newBufferedReader(path)) {

    System.out.println(reader.readLine()); // abcd
    System.out.println(reader.readLine()); // XYZ
    System.out.println(reader.readLine()); // 12345
    System.out.println(reader.readLine()); // null
}

boolean ready ()

このストリームが読込み可能かどうかを判定します。

final var path = Path.of("R:", "java-work", "aaa.txt");
System.out.println(path); // R:\java-work\aaa.txt

Files.writeString(path, "abc");

try (final var reader = Files.newBufferedReader(path)) {

    System.out.println(reader.ready()); // true
    System.out.println("%c".formatted(reader.read())); // a

    System.out.println(reader.ready()); // true
    System.out.println("%c".formatted(reader.read())); // b

    System.out.println(reader.ready()); // true
    System.out.println("%c".formatted(reader.read())); // c

    System.out.println(reader.ready()); // false
    System.out.println(reader.read()); // -1
}

void reset ()

ストリームを、もっとも新しいマーク位置にリセットします。

このメソッドの使用例は、mark(int readAheadLimit) にまとめて記載しました。
そちらのAPI使用例をご参照ください。

Readerで宣言されたメソッド

nullReader, read, read, skip, transferTo

Java API 使用例 : Reader」をご参照ください。


関連記事

ページの先頭へ