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

クラスPrintWriter

  • すべての実装されたインタフェース:
    Closeable, Flushable, Appendable, AutoCloseable

    public class PrintWriter
    extends Writer
    オブジェクトの書式付き表現をテキスト出力ストリームに出力します。 このクラスは、PrintStreamで見つかったすべてのprintメソッドを実装します。 ただし、rawバイトを書き込むメソッドは含まれません。rawバイトに対しては、エンコードされていないバイト・ストリームをプログラムで使用してください。

    PrintStreamクラスとは異なり、自動フラッシュが有効な場合は、改行文字が出力されるときではなく、printlnprintf、またはformatのいずれかのメソッドが呼び出されたときにのみ実行されます。 これらのメソッドは、改行文字ではなく、プラットフォームに固有の行区切りの表記を使用します。

    このクラスのメソッドは、コンストラクタの一部を除き、入出力例外をスローすることはありません。 クライアントは、checkError()を呼び出すことによって、エラーが発生したかどうかを照会できます。

    このクラスは、不正な形式およびマップ不可能な文字列を、常にcharsetのデフォルトの置換文字列で置き換えます。 エンコード処理をより強力に制御する必要がある場合は、CharsetEncoderクラスを使用してください。

    導入されたバージョン:
    1.1
    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      protected Writer out
      このPrintWriterのベースとなる文字出力ストリームです。
      • クラス java.io.Writerで宣言されたフィールド

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

      コンストラクタ 
      コンストラクタ 説明
      PrintWriter​(File file)
      行の自動フラッシュは行わずに、指定されたファイルで新しいPrintWriterを作成します。
      PrintWriter​(File file, String csn)
      行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。
      PrintWriter​(File file, Charset charset)
      行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。
      PrintWriter​(OutputStream out)
      行の自動フラッシュは行わずに、既存のOutputStreamから新しいPrintWriterを作成します。
      PrintWriter​(OutputStream out, boolean autoFlush)
      既存のOutputStreamから新しいPrintWriterを作成します。
      PrintWriter​(OutputStream out, boolean autoFlush, Charset charset)
      既存のOutputStreamから新しいPrintWriterを作成します。
      PrintWriter​(Writer out)
      行の自動フラッシュは行わずに、新しいPrintWriterを作成します。
      PrintWriter​(Writer out, boolean autoFlush)
      新しいPrintWriterを作成します。
      PrintWriter​(String fileName)
      行の自動フラッシュは行わずに、指定されたファイル名で新しいPrintWriterを作成します。
      PrintWriter​(String fileName, String csn)
      行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。
      PrintWriter​(String fileName, Charset charset)
      行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      PrintWriter append​(char c)
      指定された文字をこのライターに追加します。
      PrintWriter append​(CharSequence csq)
      指定された文字シーケンスをこのライターに追加します。
      PrintWriter append​(CharSequence csq, int start, int end)
      指定された文字シーケンスのサブシーケンスをこのライターに追加します。
      boolean checkError()
      ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。
      protected void clearError()
      このストリームのエラー状態を解除します。
      void close()
      ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。
      void flush()
      ストリームをフラッシュします。
      PrintWriter format​(String format, Object... args)
      指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。
      PrintWriter format​(Locale l, String format, Object... args)
      指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。
      void print​(boolean b)
      boolean型の値を出力します。
      void print​(char c)
      文字を出力します。
      void print​(char[] s)
      文字の配列を出力します。
      void print​(double d)
      倍精度の浮動小数点数を出力します。
      void print​(float f)
      浮動小数点数を出力します。
      void print​(int i)
      整数を出力します。
      void print​(long l)
      long整数を出力します。
      void print​(Object obj)
      オブジェクトを出力します。
      void print​(String s)
      文字列を出力します。
      PrintWriter printf​(String format, Object... args)
      指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。
      PrintWriter printf​(Locale l, String format, Object... args)
      指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。
      void println()
      行の区切り文字列を書き込むことで、現在の行を終了させます。
      void println​(boolean x)
      boolean値を出力し、行を終了させます。
      void println​(char x)
      文字を出力し、行を終了させます。
      void println​(char[] x)
      文字の配列を出力し、行を終了させます。
      void println​(double x)
      倍精度浮動小数点数を出力し、行を終了させます。
      void println​(float x)
      浮動小数点数を出力し、行を終了させます。
      void println​(int x)
      整数を出力し、行を終了させます。
      void println​(long x)
      long型の整数値を出力し、行を終了させます。
      void println​(Object x)
      Objectを出力し、行を終了させます。
      void println​(String x)
      文字列を出力し、行を終了させます。
      protected void setError()
      エラーが発生したことを示します。
      void write​(char[] buf)
      文字の配列を書き込みます。
      void write​(char[] buf, int off, int len)
      文字の配列の一部を書き込みます。
      void write​(int c)
      単一の文字を書き込みます。
      void write​(String s)
      文字列を書き込みます。
      void write​(String s, int off, int len)
      文字列の一部を書き込みます。
    • フィールドの詳細

      • out

        protected Writer out
        このPrintWriterのベースとなる文字出力ストリームです。
        導入されたバージョン:
        1.2
    • コンストラクタの詳細

      • PrintWriter

        public PrintWriter​(Writer out)
        行の自動フラッシュは行わずに、新しいPrintWriterを作成します。
        パラメータ:
        out - 文字出力ストリーム
      • PrintWriter

        public PrintWriter​(Writer out,
                           boolean autoFlush)
        新しいPrintWriterを作成します。
        パラメータ:
        out - 文字出力ストリーム
        autoFlush - boolean値。trueの場合、printlnメソッド、printfメソッド、またはformatメソッドは出力バッファをフラッシュする
      • PrintWriter

        public PrintWriter​(OutputStream out)
        行の自動フラッシュは行わずに、既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要となる中間のOutputStreamWriterを作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。
        パラメータ:
        out - 出力ストリーム
        関連項目:
        OutputStreamWriter(java.io.OutputStream)
      • PrintWriter

        public PrintWriter​(OutputStream out,
                           boolean autoFlush)
        既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要となる中間のOutputStreamWriterを作成します。これは、デフォルトの文字エンコーディングを使用して文字をバイトに変換します。
        パラメータ:
        out - 出力ストリーム
        autoFlush - boolean値。trueの場合、printlnメソッド、printfメソッド、またはformatメソッドは出力バッファをフラッシュする
        関連項目:
        OutputStreamWriter(java.io.OutputStream)
      • PrintWriter

        public PrintWriter​(OutputStream out,
                           boolean autoFlush,
                           Charset charset)
        既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要な中間OutputStreamWriterを作成します。これは、指定されたcharsetを使用して文字をバイトに変換します。
        パラメータ:
        out - 出力ストリーム
        autoFlush - boolean値。trueの場合、printlnメソッド、printfメソッド、またはformatメソッドは出力バッファをフラッシュする
        charset - A charset
        導入されたバージョン:
        10
      • PrintWriter

        public PrintWriter​(String fileName)
                    throws FileNotFoundException
        行の自動フラッシュは行わずに、指定されたファイル名で新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。
        パラメータ:
        fileName - このライターの宛先として使用されるファイルの名前。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
        例外:
        FileNotFoundException - 指定された文字列が既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
        SecurityException - セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合
        導入されたバージョン:
        1.5
      • PrintWriter

        public PrintWriter​(String fileName,
                           String csn)
                    throws FileNotFoundException,
                           UnsupportedEncodingException
        行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。
        パラメータ:
        fileName - このライターの宛先として使用されるファイルの名前。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
        csn - サポートされているcharsetの名前
        例外:
        FileNotFoundException - 指定された文字列が既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
        SecurityException - セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合
        UnsupportedEncodingException - 指定された文字セットがサポートされていない場合
        導入されたバージョン:
        1.5
      • PrintWriter

        public PrintWriter​(String fileName,
                           Charset charset)
                    throws IOException
        行の自動フラッシュは行わずに、指定されたファイル名と文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。
        パラメータ:
        fileName - このライターの宛先として使用されるファイルの名前。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
        charset - A charset
        例外:
        IOException - ファイルのオープンまたは作成中にI/Oエラーが発生した場合
        SecurityException - セキュリティ・マネージャが存在し、checkWrite(fileName)がファイルへの書込みアクセスを拒否した場合
        導入されたバージョン:
        10
      • PrintWriter

        public PrintWriter​(File file)
                    throws FileNotFoundException
        行の自動フラッシュは行わずに、指定されたファイルで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これがJava仮想マシンのこのインスタンス用にデフォルト文字セットを使用して文字をエンコードします。
        パラメータ:
        file - このライターの宛先として使用されるファイル。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
        例外:
        FileNotFoundException - 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
        SecurityException - セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合
        導入されたバージョン:
        1.5
      • PrintWriter

        public PrintWriter​(File file,
                           String csn)
                    throws FileNotFoundException,
                           UnsupportedEncodingException
        行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。
        パラメータ:
        file - このライターの宛先として使用されるファイル。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
        csn - サポートされているcharsetの名前
        例外:
        FileNotFoundException - 指定されたファイル・オブジェクトが既存のファイルを示さない場合、書込み可能な通常ファイルおよび新規の通常ファイルがその名前で作成できない場合、またはファイルのオープンまたは作成中にその他のエラーが発生した場合
        SecurityException - セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合
        UnsupportedEncodingException - 指定された文字セットがサポートされていない場合
        導入されたバージョン:
        1.5
      • PrintWriter

        public PrintWriter​(File file,
                           Charset charset)
                    throws IOException
        行の自動フラッシュは行わずに、指定されたファイルと文字セットで新しいPrintWriterを作成します。 この便利なコンストラクタは必要な中間OutputStreamWriterを作成し、これが指定された文字セットを使用して文字をエンコードします。
        パラメータ:
        file - このライターの宛先として使用されるファイル。 ファイルが存在する場合は、サイズ0に切り詰められる。そうでない場合は、新規ファイルが作成される。 出力はファイルに書き込まれ、バッファに格納される。
        charset - A charset
        例外:
        IOException - ファイルのオープンまたは作成中にI/Oエラーが発生した場合
        SecurityException - セキュリティ・マネージャが存在し、checkWrite(file.getPath())がファイルへの書込みアクセスを拒否した場合
        導入されたバージョン:
        10
    • メソッドの詳細

      • flush

        public void flush()
        ストリームをフラッシュします。
        定義:
        flush、インタフェース: Flushable
        定義:
        flush、クラス: Writer
        関連項目:
        checkError()
      • close

        public void close()
        ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 すでに閉じられているストリームを閉じても、何の影響もありません。
        定義:
        close、インタフェース: AutoCloseable
        定義:
        close、インタフェース: Closeable
        定義:
        close、クラス: Writer
        関連項目:
        checkError()
      • checkError

        public boolean checkError()
        ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。
        戻り値:
        ベースとなる出力ストリームで、またはフォーマット変換中に、プリント・ストリームがエラーを検出した場合はtrue
      • setError

        protected void setError()
        エラーが発生したことを示します。

        このメソッドを使用すると、clearError()が呼び出されるまで、checkError()の以降の呼出しではtrueが返されます。

      • clearError

        protected void clearError()
        このストリームのエラー状態を解除します。

        このメソッドを使用すると、別の書込み操作が失敗して、setError()が呼び出されるまで、checkError()の以降の呼出しではfalseが返されます。

        導入されたバージョン:
        1.6
      • write

        public void write​(int c)
        単一の文字を書き込みます。
        オーバーライド:
        write、クラス: Writer
        パラメータ:
        c - 書き込まれる文字を指定するint。
      • write

        public void write​(char[] buf,
                          int off,
                          int len)
        文字の配列の一部を書き込みます。
        定義:
        write、クラス: Writer
        パラメータ:
        buf - 文字の配列
        off - 文字の書込み開始オフセット
        len - 書き込む文字数
        例外:
        IndexOutOfBoundsException - offおよびlenパラメータの値によって、下にあるWriterの対応するメソッドがIndexOutOfBoundsExceptionをスローする場合
      • write

        public void write​(char[] buf)
        文字の配列を書き込みます。 入出力例外を抑制しなければならないので、このメソッドをWriterクラスから継承することはできません。
        オーバーライド:
        write、クラス: Writer
        パラメータ:
        buf - 書き込まれる文字の配列
      • write

        public void write​(String s,
                          int off,
                          int len)
        文字列の一部を書き込みます。
        オーバーライド:
        write、クラス: Writer
        パラメータ:
        s - 文字列
        off - 文字の書込み開始オフセット
        len - 書き込む文字数
        例外:
        IndexOutOfBoundsException - offおよびlenパラメータの値によって、下にあるWriterの対応するメソッドがIndexOutOfBoundsExceptionをスローする場合
      • write

        public void write​(String s)
        文字列を書き込みます。 入出力例外を抑制しなければならないので、このメソッドをWriterクラスから継承することはできません。
        オーバーライド:
        write、クラス: Writer
        パラメータ:
        s - 書き込まれる文字列
      • print

        public void print​(boolean b)
        boolean型の値を出力します。 String.valueOf(boolean)によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        b - 出力されるboolean
      • print

        public void print​(char c)
        文字を出力します。 この文字は、プラットフォームのデフォルトの文字エンコーディングに従って1つ以上のバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        c - 出力されるchar
      • print

        public void print​(int i)
        整数を出力します。 String.valueOf(int)によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        i - 出力されるint
        関連項目:
        Integer.toString(int)
      • print

        public void print​(long l)
        long整数を出力します。 String.valueOf(long)によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        l - 出力されるlong
        関連項目:
        Long.toString(long)
      • print

        public void print​(float f)
        浮動小数点数を出力します。 String.valueOf(float)によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        f - 出力されるfloat
        関連項目:
        Float.toString(float)
      • print

        public void print​(double d)
        倍精度の浮動小数点数を出力します。 String.valueOf(double)によって生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        d - 出力されるdouble
        関連項目:
        Double.toString(double)
      • print

        public void print​(char[] s)
        文字の配列を出力します。 これらの文字は、プラットフォームのデフォルト文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        s - 出力されるcharの配列
        例外:
        NullPointerException - snullである場合
      • print

        public void print​(String s)
        文字列を出力します。 引数がnullの場合は、文字列"null"が出力されます。 それ以外の場合、文字列の文字はプラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        s - 出力されるString
      • print

        public void print​(Object obj)
        オブジェクトを出力します。 String.valueOf(Object)メソッドで生成された文字列は、プラットフォームのデフォルトの文字エンコーディングに従ってバイトに変換され、これらのバイトはwrite(int)メソッドとまったく同じ方法で記述されます。
        パラメータ:
        obj - 出力されるObject
        関連項目:
        Object.toString()
      • println

        public void println()
        行の区切り文字列を書き込むことで、現在の行を終了させます。 行の区切り文字列は、システム・プロパティline.separatorで定義され、必ずしも単一の改行文字('\n')であるとは限りません。
      • println

        public void println​(boolean x)
        boolean値を出力し、行を終了させます。 このメソッドは、print(boolean)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるboolean
      • println

        public void println​(char x)
        文字を出力し、行を終了させます。 このメソッドは、print(char)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるchar
      • println

        public void println​(int x)
        整数を出力し、行を終了させます。 このメソッドは、print(int)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるint
      • println

        public void println​(long x)
        long型の整数値を出力し、行を終了させます。 このメソッドは、print(long)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるlong
      • println

        public void println​(float x)
        浮動小数点数を出力し、行を終了させます。 このメソッドは、print(float)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるfloat
      • println

        public void println​(double x)
        倍精度浮動小数点数を出力し、行を終了させます。 このメソッドは、print(double)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるdouble
      • println

        public void println​(char[] x)
        文字の配列を出力し、行を終了させます。 このメソッドは、print(char[])println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるchar値の配列
      • println

        public void println​(String x)
        文字列を出力し、行を終了させます。 このメソッドは、print(String)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるString
      • println

        public void println​(Object x)
        Objectを出力し、行を終了させます。 このメソッドは最初にString.valueOf(x)を呼び出して印刷オブジェクトの文字列値を取得し、print(String)println()を呼び出すように動作します。
        パラメータ:
        x - 出力されるObject値。
      • printf

        public PrintWriter printf​(String format,
                                  Object... args)
        指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。

        このメソッドをout.printf(format, args)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。

        
             out.format(format, args)
         

        パラメータ:
        format - 書式文字列の構文で説明した書式文字列。
        args - 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、Java™仮想マシン仕様で定義されているJava配列の最大次元により制限される。 引数がnullの場合、動作は変換に応じて異なる。
        戻り値:
        このライター
        例外:
        IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の詳細セクションを参照。
        NullPointerException - formatnullである場合
        導入されたバージョン:
        1.5
      • printf

        public PrintWriter printf​(Locale l,
                                  String format,
                                  Object... args)
        指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。

        このメソッドをout.printf(l, format, args)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。

        
             out.format(l, format, args)
         

        パラメータ:
        l - 書式設定時に適用するlocale lnullの場合、ローカリゼーションは適用されない。
        format - 書式文字列の構文で説明した書式文字列。
        args - 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、Java™仮想マシン仕様で定義されているJava配列の最大次元により制限される。 引数がnullの場合、動作は変換に応じて異なる。
        戻り値:
        このライター
        例外:
        IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の詳細セクションを参照。
        NullPointerException - formatnullである場合
        導入されたバージョン:
        1.5
      • format

        public PrintWriter format​(String format,
                                  Object... args)
        指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。

        このオブジェクトに対して別の書式設定メソッドが先に呼び出されていたかどうかにかかわらず、Locale.getDefault()により返されるロケールが常に使用されます。

        パラメータ:
        format - 書式文字列の構文で説明した書式文字列。
        args - 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、Java™仮想マシン仕様で定義されているJava配列の最大次元により制限される。 引数がnullの場合、動作は変換に応じて異なる。
        戻り値:
        このライター
        例外:
        IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、Formatterクラス仕様の詳細セクションを参照。
        NullPointerException - formatnullである場合
        導入されたバージョン:
        1.5
      • format

        public PrintWriter format​(Locale l,
                                  String format,
                                  Object... args)
        指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。 自動フラッシュが有効な場合は、このメソッドを呼び出すと出力バッファがフラッシュされます。
        パラメータ:
        l - 書式設定時に適用するlocale lnullの場合、ローカリゼーションは適用されない。
        format - 書式文字列の構文で説明した書式文字列。
        args - 書式文字列の書式指示子により参照される引数。 引数が書式指定子よりも多い場合、余分な引数は無視されます。 引数の数は変数で、0(ゼロ)の場合があります。 引数の最大数は、Java™仮想マシン仕様で定義されているJava配列の最大次元により制限される。 引数がnullの場合、動作は変換に応じて異なる。
        戻り値:
        このライター
        例外:
        IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の詳細セクションを参照。
        NullPointerException - formatnullである場合
        導入されたバージョン:
        1.5
      • append

        public PrintWriter append​(CharSequence csq)
        指定された文字シーケンスをこのライターに追加します。

        このメソッドをout.append(csq)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。

        
             out.write(csq.toString())
         

        charシーケンスcsqに対するtoStringの指定に応じて、シーケンス全体が追加されないこともあります。 たとえば、charバッファのtoStringメソッドを呼び出した場合、そのバッファの位置とリミットによって決まる内容を持つサブシーケンスが返されます。

        定義:
        append、インタフェース: Appendable
        オーバーライド:
        append、クラス: Writer
        パラメータ:
        csq - 追加するcharシーケンス。 csqnullの場合は、このライターにnullという4文字が追加される。
        戻り値:
        このライター
        導入されたバージョン:
        1.5
      • append

        public PrintWriter append​(CharSequence csq,
                                  int start,
                                  int end)
        指定された文字シーケンスのサブシーケンスをこのライターに追加します。

        csqnullでないときに、このメソッドをout.append(csq, start, end)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。

        
             out.write(csq.subSequence(start, end).toString())
         

        定義:
        append、インタフェース: Appendable
        オーバーライド:
        append、クラス: Writer
        パラメータ:
        csq - サブシーケンスの追加元のcharシーケンス。 csqnullの場合は、csqnullという4 charが含まれているかのようにcharが追加される
        start - サブシーケンスの最初のcharのインデックス
        end - サブシーケンスの最後のcharのあとに続くcharのインデックス
        戻り値:
        このライター
        例外:
        IndexOutOfBoundsException - startまたはendが負の値の場合、startendよりも大きい場合、あるいはendcsq.length()よりも大きい場合
        導入されたバージョン:
        1.5
      • append

        public PrintWriter append​(char c)
        指定された文字をこのライターに追加します。

        このメソッドをout.append(c)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。

        
             out.write(c)
         

        定義:
        append、インタフェース: Appendable
        オーバーライド:
        append、クラス: Writer
        パラメータ:
        c - 追加する16ビット文字
        戻り値:
        このライター
        導入されたバージョン:
        1.5