モジュール java.base
パッケージ java.io

クラスStringReader

  • すべての実装されたインタフェース:
    Closeable, AutoCloseable, Readable
    public class StringReader
extends Reader
    ソースが文字列の文字ストリームです。
    導入されたバージョン:
    1.1

    • フィールドのサマリー

      • クラス java.io.Readerで宣言されたフィールド

        lock

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      StringReader​(String s)
      新しい文字列リーダーを作成します。

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      void close()
      ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。
      void mark​(int readAheadLimit)
      ストリームの現在位置にマークを設定します。
      boolean markSupported()
      このストリームが、実行するmark()オペレーションをサポートするかどうかを通知します。
      int read()
      単一の文字を読み込みます。
      int read​(char[] cbuf, int off, int len)
      配列の一部に文字を読み込みます。
      boolean ready()
      このストリームが読込み可能かどうかを判定します。
      void reset()
      直前のマーク位置にストリームをリセットします。マークが設定されていない場合は、文字列の先頭にリセットします。
      long skip​(long ns)
      ストリーム内の指定された数の文字をスキップします。

    • コンストラクタの詳細

      • StringReader

        public StringReader​(String s)
        新しい文字列リーダーを作成します。
        パラメータ:
        s - 文字ストリームを提供する文字列。

    • メソッドの詳細

      • read

        public int read()
         throws IOException
        単一の文字を読み込みます。
        オーバーライド:
        read、クラス: Reader
        戻り値:
        読み込まれた文字。ストリームの終わりに達した場合は -1
        例外:
        IOException - 入出力エラーが発生した場合

      • read

        public int read​(char[] cbuf,
                int off,
                int len)
         throws IOException
        配列の一部に文字を読み込みます。
        定義:
        read、クラス: Reader
        パラメータ:
        cbuf - 転送先バッファ
        off - 文字の書込み開始オフセット
        len - 読み込む文字の最大数
        戻り値:
        読み込まれた文字数。ストリームの終わりに達した場合は -1
        例外:
        IOException - 入出力エラーが発生した場合
        IndexOutOfBoundsException - I/Oエラーが発生した場合

      • skip

        public long skip​(long ns)
          throws IOException
        ストリーム内の指定された数の文字をスキップします。 スキップされた文字の数を返します。

        nsパラメータは、Readerスーパー・クラスのskipメソッドが例外をスローする場合があっても、負の値にできます。 nsが負の値であれば、ストリームは後ろへスキップします。 負の戻り値は、後ろへスキップすることを示します。 文字列の先頭を超えて後ろへスキップすることはできません。

        文字列全体が読み込まれたかスキップされた場合、このメソッドは何も実行せずに、常に0を返します。

        オーバーライド:
        skip、クラス: Reader
        パラメータ:
        ns - スキップする文字数
        戻り値:
        実際にスキップした文字数
        例外:
        IOException - 入出力エラーが発生した場合

      • ready

        public boolean ready()
              throws IOException
        このストリームが読込み可能かどうかを判定します。
        オーバーライド:
        ready、クラス: Reader
        戻り値:
        次のread()が入力をブロックしないことを保証できる場合はtrue
        例外:
        IOException - ストリームが閉じられた場合

      • markSupported

        public boolean markSupported()
        このストリームが、実行するmark()オペレーションをサポートするかどうかを通知します。
        オーバーライド:
        markSupported、クラス: Reader
        戻り値:
        このストリームがmarkオペレーションをサポートする場合に限りtrue。

      • mark

        public void mark​(int readAheadLimit)
          throws IOException
        ストリームの現在位置にマークを設定します。 以降のreset()の呼出しでは、ストリームはこの位置に再配置されます。
        オーバーライド:
        mark、クラス: Reader
        パラメータ:
        readAheadLimit - マークを保持しながら読み込むことができる文字数の上限。 文字列からストリームに入力されるので、実際の上限はない。そのため、この引数は負の値であってはならないが、そうでない場合は無視される。
        例外:
        IllegalArgumentException - readAheadLimit < 0の場合
        IOException - 入出力エラーが発生した場合

      • reset

        public void reset()
           throws IOException
        直前のマーク位置にストリームをリセットします。マークが設定されていない場合は、文字列の先頭にリセットします。
        オーバーライド:
        reset、クラス: Reader
        例外:
        IOException - 入出力エラーが発生した場合

      • close

        public void close()
        ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 ストリームが閉じられたあとにread()、ready()、mark()、またはreset()を呼び出すと、IOExceptionがスローされます。 すでに閉じられているストリームを閉じても、何の影響もありません。 このメソッドは、リーダー上に別のスレッドがブロックされている間にブロックされます。
        定義:
        close、インタフェース: AutoCloseable
        定義:
        close、インタフェース: Closeable
        定義:
        close、クラス: Reader