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

クラスPrintWriter

java.lang.Object
java.io.Writer
java.io.PrintWriter
すべての実装されたインタフェース:
Closeable, Flushable, Appendable, AutoCloseable

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

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

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

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

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

    フィールド
    修飾子と型
    フィールド
    説明
    protected Writer
    このPrintWriterのベースとなる文字出力ストリームです。

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

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

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

    修飾子と型
    メソッド
    説明
    append(char c)
    指定された文字をこのライターに追加します。
    指定された文字シーケンスをこのライターに追加します。
    append(CharSequence csq, int start, int end)
    指定された文字シーケンスのサブシーケンスをこのライターに追加します。
    boolean
    ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。
    protected void
    このストリームのエラー状態を解除します。
    void
    ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。
    void
    ストリームをフラッシュします。
    format(String format, Object... args)
    指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込みます。
    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
    オブジェクトを出力します。
    void
    文字列を出力します。
    printf(String format, Object... args)
    指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。
    printf(Locale l, String format, Object... args)
    指定された書式文字列および引数を使用して、書式付き文字列をこのライターに書き込む簡易メソッドです。
    void
    行の区切り文字列を書き込むことで、現在の行を終了させます。
    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
    Objectを出力し、行を終了させます。
    void
    文字列を出力し、行を終了させます。
    protected void
    ストリームのエラー状態をtrueに設定します。
    void
    write(char[] buf)
    文字の配列を書き込みます。
    void
    write(char[] buf, int off, int len)
    文字の配列の一部を書き込みます。
    void
    write(int c)
    単一の文字を書き込みます。
    void
    文字列を書き込みます。
    void
    write(String s, int off, int len)
    文字列の一部を書き込みます。

    クラスjava.io.Writerで宣言されたメソッド

    nullWriter

    クラスjava.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • フィールド詳細

    • out

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

    • PrintWriter

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

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

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

      public PrintWriter(OutputStream out, boolean autoFlush)
      既存のOutputStreamから新しいPrintWriterを作成します。 このコンビニエンス・コンストラクタは、デフォルトの文字セットを使用して文字をバイトに変換する必要な中間OutputStreamWriterを作成します。outPrintStreamで、印刷ストリームで使用される文字セットです。
      パラメータ:
      out - 出力ストリーム
      autoFlush - ブール。trueの場合、printlnprintfまたはformatメソッドは出力バッファをフラッシュ
      関連項目:
    • PrintWriter

      public PrintWriter(OutputStream out, boolean autoFlush, Charset charset)
      既存のOutputStreamから新しいPrintWriterを作成します。 この簡易コンストラクタは、必要な中間OutputStreamWriterを作成します。これは、指定されたcharsetを使用して文字をバイトに変換します。
      パラメータ:
      out - 出力ストリーム
      autoFlush - ブール。trueの場合、printlnprintfまたは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
      関連項目:
    • close

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

      public boolean checkError()
      ストリームが閉じられていない場合は、そのストリームをフラッシュし、エラー状態をチェックします。
      戻り値:
      このストリームがIOExceptionを検出した場合、またはsetErrorメソッドが呼び出された場合のみtrue
    • setError

      protected void setError()
      ストリームのエラー状態をtrueに設定します。

      このメソッドにより、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
      関連項目:
    • print

      public void print(long l)
      long整数を出力します。 String.valueOf(long)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。
      パラメータ:
      l - 出力されるlong
      関連項目:
    • print

      public void print(float f)
      浮動小数点数を出力します。 String.valueOf(float)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。
      パラメータ:
      f - 出力されるfloat
      関連項目:
    • print

      public void print(double d)
      倍精度の浮動小数点数を出力します。 String.valueOf(double)によって生成される文字列は、デフォルトの文字セットに従ってバイトに変換され、これらのバイトはwrite(int)メソッドの正確な方法で書き込まれます。
      パラメータ:
      d - 出力される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
      関連項目:
    • println

      public void println()
      行の区切り文字列を書き込むことで、現在の行を終了させます。 行セパレータはSystem.lineSeparator()であり、必ずしも単一の改行文字('\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を出力し、行を終了させます。 このメソッドは、firstString.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 Virtual Machine仕様」で定義されている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 Virtual Machine仕様」で定義されているJava配列の最大サイズによって制限されます。 引数がnullの場合、動作は変換に応じて異なる。
      戻り値:
      このライター
      例外:
      IllegalFormatException - 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に指定された不適切な引数、またはほかの不正な条件を含む場合。 考えられるすべての書式エラーの仕様については、フォーマッタ・クラス仕様の「詳細」セクションを参照。
      NullPointerException - formatnullの場合
      導入されたバージョン:
      1.5
    • format

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

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

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

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

      out.append(csq)形式のこのメソッドの起動は、起動とまったく同じように動作

          out.write(csq.toString())
      

      文字シーケンスcsqtoStringの指定によっては、シーケンス全体が追加されない場合があります。 たとえば、文字バッファのtoStringメソッドを呼び出すと、内容がバッファの位置と制限によって異なる部分列が返されます。

      定義:
      append、インタフェースAppendable
      オーバーライド:
      append、クラスWriter
      パラメータ:
      csq - 追加するcharシーケンス。 csqnullの場合、このライターに4文字の"null"が追加されます。
      戻り値:
      このライター
      導入されたバージョン:
      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の場合、csqに4文字の"null"が含まれているかのように、文字が追加されます。
      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