java.io
클래스 PrintWriter

java.lang.Object 
  java.io.Writer 
      java.io.PrintWriter

모든 구현된 인터페이스:

Closeable, Flushable, Appendable

public class PrintWriter
extends Writer 

포맷된 객체의 표현을 텍스트 출력 스트림에 출력합니다. 이 클래스에서는 PrintStream에 있는 print 메서드를 모두 구현하고 있습니다. 다만, 원시바이트를 출력하는 메서드는 포함하지 않습니다. 이러한 경우는 encode되어 있지 않은 바이트 스트림을 프로그램으로 사용하지 않으면 안됩니다.

자동 플래시가 유효한 경우는 PrintStream 와는 달라, 개행 문자를 출력할 때가 아니고, println, printf, 또는 format 메서드의 1개를 호출했을 때에 플래시를 합니다. 이러한 메서드에서는 개행 문자가 아니고, 그 플랫폼 자체가 가지는 행 단락 문자의 표기를 사용합니다.

이 클래스의 메서드는 입출력 예외를 Throw 할 것은 없습니다만, 생성자 안에는 Throw 하는 것도 있습니다. 클라이언트는 checkError()를 호출하는 것에의해 에러가 발생했는지 어떠했는지를 조회할 수 있습니다.

도입된 버전 :

JDK1. 1

필드 개요

protected Writer

out 이 PrintWriter 기본이 되는 문자 출력 스트림입니다.

클래스 java.io. Writer 로부터 상속된 필드

lock

생성자 개요

PrintWriter (File file)
행의 자동 플래시는 실시하지 않고, 지정의 파일로 새로운 PrintWriter를 작성합니다.

PrintWriter (File file, String csn)
행의 자동 플래시는 실시하지 않고, 지정의 파일과 캐릭터셋로 새로운 PrintWriter를 작성합니다.

PrintWriter (OutputStream out)
행의 자동 플래시는 실시하지 않고, 기존의 OutputStream 로부터 새로운 PrintWriter를 작성합니다.

PrintWriter (OutputStream out, boolean autoFlush)
기존의 OutputStream 로부터 새로운 PrintWriter를 작성합니다.

PrintWriter (String fileName)
행의 자동 플래시는 실시하지 않고, 지정의 이름으로 새로운 PrintWriter를 작성합니다.

PrintWriter (String fileName, String csn)
행의 자동 플래시는 실시하지 않고, 지정의 이름과 캐릭터셋로 새로운 PrintWriter를 작성합니다.

PrintWriter (Writer out)
자동행 플래시는 실시하지 않고, 새로운 PrintWriter를 작성합니다.

PrintWriter (Writer out, boolean autoFlush)
새로운 PrintWriter를 작성합니다.

메서드 개요

PrintWriter	append (char c) 이 라이터로 지정된 문자를 추가합니다.
PrintWriter	append (CharSequence csq) 이 라이터로 지정된 문자 순서를 추가합니다.
PrintWriter	append (CharSequence csq, int start, int end) 지정된 문자 순서의 서브 순서를 이 Writer에 추가합니다.
boolean	checkError () 스트림이 닫지 않으면 플래시 해, 그 에러 상태를 체크합니다.
void	close () 스트림을 닫습니다.
void	flush () 스트림을 플래시 합니다.
PrintWriter	format (Locale l, String format, Object ... args) 서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력합니다.
PrintWriter	format (String format, Object ... args) 서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력합니다.
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 (Locale l, String format, Object ... args) 서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력하는 편리한 방법입니다.
PrintWriter	printf (String format, Object ... args) 서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력하는 편리한 방법입니다.
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) String를 출력해, 행을 종료합니다.
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) 캐릭터 라인의 일부를 출력합니다.

클래스 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 - boolean 치. 값이 true인 경우, println, printf, 또는 format 메서드에서는 출력 버퍼를 플래시 한다

PrintWriter

public PrintWriter(OutputStream  out)

행의 자동 플래시는 실시하지 않고, 기존의 OutputStream 로부터 새로운 PrintWriter를 작성합니다. 이 생성자에서는 필요한 중간의 OutputStreamWriter를 작성합니다. 이것에 의해 디폴트의 캐릭터셋를 사용해 문자를 바이트로 변환합니다.

파라미터:

out - 출력 스트림

관련 항목:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(OutputStream  out,
                   boolean autoFlush)

기존의 OutputStream 로부터 새로운 PrintWriter를 작성합니다. 이 간이 생성자에서는 필요한 중간의 OutputStreamWriter를 작성합니다. 이것에 의해 디폴트의 캐릭터셋를 사용해 문자를 바이트로 변환합니다.

파라미터:

out - 출력 스트림

autoFlush - boolean 치. 값이 true인 경우, println, printf, 또는 format 메서드에서는 출력 버퍼를 플래시 하는

관련 항목:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(String  fileName)
            throws FileNotFoundException 

행의 자동 플래시는 실시하지 않고, 지정의 이름으로 새로운 PrintWriter를 작성합니다. 이 생성자에서는 필요한 중간 OutputStreamWriter를 작성합니다. 이것에 의해 이 Java 가상 머신의 이 인스턴스의 default charset를 사용해 문자를 encode 합니다.

파라미터:

fileName - 이 라이터의 행선지로서 사용하는 파일의 이름. 파일이 존재하는 경우, 사이즈 0에 잘라 버릴 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 포함된다

예외:

FileNotFoundException - 지정의 캐릭터 라인이, 기존의 출력가능한 보통 파일을 나타내지 않고, 그 이름을 가지는 보통 파일을 작성할 수 없는 경우. 또는 파일을 열고 있을 때나 작성할 때, 그 외의 에러가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkWrite(fileName) 메서드가 파일에의 쓰기 권한을 허가하지 않는 경우

도입된 버전 :

1.5

PrintWriter

public PrintWriter(String  fileName,
                   String  csn)
            throws FileNotFoundException,

                   UnsupportedEncodingException 

행의 자동 플래시는 실시하지 않고, 지정의 이름과 캐릭터셋로 새로운 PrintWriter를 작성합니다. 이 생성자에서는 필요한 중간 OutputStreamWriter를 작성합니다. 이것에 의해 지정의 캐릭터셋를 사용해 문자를 encode 합니다.

파라미터:

fileName - 이 라이터의 행선지로서 사용하는 파일의 이름. 파일이 존재하는 경우, 사이즈 0에 잘라 버릴 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 포함되는

csn - 지원하는 charset 이름

예외:

FileNotFoundException - 지정의 캐릭터 라인이, 기존의 출력가능한 보통 파일을 나타내지 않고, 그 이름을 가지는 보통 파일을 작성할 수 없는 경우. 또는 파일을 열고 있을 때나 작성할 때, 그 외의 에러가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkWrite(fileName) 메서드가 파일에의 쓰기 권한을 허가하지 않는 경우

UnsupportedEncodingException - 지정된 캐릭터셋가 지원되어 있지 않은 경우

도입된 버전 :

1.5

PrintWriter

public PrintWriter(File  file)
            throws FileNotFoundException 

행의 자동 플래시는 실시하지 않고, 지정의 파일로 새로운 PrintWriter를 작성합니다. 이 생성자에서는 필요한 중간 OutputStreamWriter를 작성합니다. 이것에 의해 이 Java 가상 머신의 이 인스턴스의 default charset를 사용해 문자를 encode 합니다.

파라미터:

file - 이 라이터의 행선지로서 사용하는 파일. 파일이 존재하는 경우, 사이즈 0에 잘라 버릴 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 포함된다

예외:

FileNotFoundException - 지정의 파일 객체가 기존의 출력가능한 보통 파일을 나타내지 않고, 그 이름을 가지는 보통 파일을 작성할 수 없는 경우. 또는 파일을 열고 있을 때나 작성할 때, 그 외의 에러가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkWrite(file.getPath()) 메서드가 파일에의 쓰기 권한을 허가하지 않는 경우

도입된 버전 :

1.5

PrintWriter

public PrintWriter(File  file,
                   String  csn)
            throws FileNotFoundException,

                   UnsupportedEncodingException 

행의 자동 플래시는 실시하지 않고, 지정의 파일과 캐릭터셋로 새로운 PrintWriter을 작성합니다. 이 생성자에서는 필요한 중간 OutputStreamWriter를 작성합니다. 이것에 의해 지정의 캐릭터셋를 사용해 문자를 encode 합니다.

파라미터:

file - 이 라이터의 행선지로서 사용하는 파일. 파일이 존재하는 경우, 사이즈 0에 잘라 버릴 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 포함되는

csn - 지원하는 charset 이름

예외:

FileNotFoundException - 지정의 파일 객체가 기존의 출력가능한 보통 파일을 나타내지 않고, 그 이름을 가지는 보통 파일을 작성할 수 없는 경우. 또는 파일을 열고 있을 때나 작성할 때, 그 외의 에러가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkWrite(file.getPath()) 메서드가 파일에의 쓰기 권한을 허가하지 않는 경우

UnsupportedEncodingException - 지정된 캐릭터셋가 지원되어 있지 않은 경우

도입된 버전 :

1.5

메서드의 상세

flush

public void flush()

스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

정의:

클래스 Writer 내의 flush

관련 항목:

checkError()

close

public void close()

스트림을 닫습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

관련 항목:

checkError()

checkError

public boolean checkError()

스트림이 닫지 않으면 플래시 해, 그 에러 상태를 체크합니다. 에러는 누적됩니다. 스트림이 에러를 한 번 검출하면, 이 루틴은 연속하는 모든 호출로 true를 계속 리턴합니다.

반환값:

기본이 되는 출력 스트림로 또는 포맷 변환중에 출력 스트림이 에러를 검출했을 경우는 true

setError

protected void setError()

에러가 발생한 것을 나타냅니다.

write

public void write(int c)

단일의 문자를 출력합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

c - 출력하는 문자를 지정하는 int

write

public void write(char[] buf,
                  int off,
                  int len)

문자의 배열의 일부를 출력합니다.

정의:

클래스 Writer 내의 write

파라미터:

buf - 문자의 배열

off - 문자의 출력 개시 오프셋(offset)

len - 출력하는 문자수

write

public void write(char[] buf)

문자의 배열을 출력합니다. 입출력 예외를 억제해야 하기 때문에 이 메서드는 Writer 클래스로부터 상속할 수 없습니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

buf - 출력하는 문자의 배열

write

public void write(String  s,
                  int off,
                  int len)

캐릭터 라인의 일부를 출력합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

s - 캐릭터 라인

off - 문자의 출력 개시 오프셋(offset)

len - 출력하는 문자수

write

public void write(String  s)

캐릭터 라인을 출력합니다. 입출력 예외를 억제해야 하기 때문에 이 메서드는 Writer 클래스로부터 상속할 수 없습니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

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 - s가 null인 경우

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)

String를 출력해, 행을 종료합니다. 이 메서드는 print(String) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 String 치

println

public void println(Object  x)

Object를 출력해, 행을 종료합니다. 이 메서드는 #print(object)를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 Object 치

printf

public PrintWriter  printf(String  format,
                          Object ... args)

서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력하는 편리한 방법입니다. 자동 플래시 유효한 경우는 이 메서드의 호출은 출력 버퍼를 플래시 합니다.

이 메서드를 out.printf(format, args) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.format(format, args) 

파라미터:

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인의 서식 지시자에 의해 참조되는 인수. 서식 지시자보다 인수가 많은 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대값 는 「Java 가상 머신 사양」으로 정의되고 있는 Java 배열의 최대 차원에 의해 제한된다. null 인수에서의 동작은, 변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」섹션을 참조

NullPointerException - format가 null인 경우

도입된 버전 :

1.5

printf

public PrintWriter  printf(Locale  l,
                          String  format,
                          Object ... args)

서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력하는 편리한 방법입니다. 자동 플래시 유효한 경우는 이 메서드의 호출은 출력 버퍼를 플래시 합니다.

이 메서드를 out.printf(l, format, args) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.format(l, format, args) 

파라미터:

l - 서식 설정시에 적용하는 locale . l가 null인 경우, 지역 대응은 적용되지 않는

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인의 서식 지시자에 의해 참조되는 인수. 서식 지시자보다 인수가 많은 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대값 는 「Java 가상 머신 사양」으로 정의되고 있는 Java 배열의 최대 차원에 의해 제한된다. null 인수에서의 동작은, 변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」섹션을 참조

NullPointerException - format가 null인 경우

도입된 버전 :

1.5

format

public PrintWriter  format(String  format,
                          Object ... args)

서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력합니다. 자동 플래시 유효한 경우는 이 메서드의 호출은 출력 버퍼를 플래시 합니다.

항상 사용되는 로케일은 이 객체의 그 외의 서식화 메서드의 지금까지의 호출에 관계없이, Locale.getDefault() 에 의해 리턴된 로케일입니다.

파라미터:

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인의 서식 지시자에 의해 참조되는 인수. 서식 지시자보다 인수가 많은 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대값 는 「Java 가상 머신 사양」으로 정의되고 있는 Java 배열의 최대 차원에 의해 제한된다. null 인수에서의 동작은, 변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」섹션을 참조

NullPointerException - format가 null인 경우

도입된 버전 :

1.5

format

public PrintWriter  format(Locale  l,
                          String  format,
                          Object ... args)

서식 첨부 캐릭터 라인을 지정된 서식 캐릭터 라인과 인수를 사용해, 이 Writer에 출력합니다. 자동 플래시 유효한 경우는 이 메서드의 호출은 출력 버퍼를 플래시 합니다.

파라미터:

l - 서식 설정시에 적용하는locale . l가 null인 경우, 지역 대응은 적용되지 않는

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인의 서식 지시자에 의해 참조되는 인수. 서식 지시자보다 인수가 많은 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대값 는 「Java 가상 머신 사양」으로 정의되고 있는 Java 배열의 최대 차원에 의해 제한된다. null 인수에서의 동작은, 변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」섹션을 참조

NullPointerException - format가 null인 경우

도입된 버전 :

1.5

append

public PrintWriter  append(CharSequence  csq)

이 라이터로 지정된 문자 순서를 추가합니다.

이 메서드를 out.append(csq) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.write(csq.toString()) 

문자 순서 csq에 대한 toString 지정에 응해, 순서 전체가 추가되지 않는 것도 있습니다. 예를 들어 문자 버퍼의 toString를 호출하면, 내용이 버퍼의 위치와 리밋트에 의존된 서브 순서가 리턴됩니다 .

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 추가되는 문자 순서. csq가 null인 경우는 이 Writer에 「null」라고 하는 4 문자가 추가된다

반환값:

이 라이터

도입된 버전 :

1.5

append

public PrintWriter  append(CharSequence  csq,
                          int start,
                          int end)

지정된 문자 순서의 서브 순서를 이 Writer에 추가합니다.

csq가 null는 아닐 때에 이 메서드를 out.append(csq, start, end) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

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

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 서브 순서의 추가원의 문자 순서. csq가 null 이면, 문자는 csq에 「null」라고 하는 4 문자가 포함되어 있는 것과 같게 추가되는

start - 서브 순서의 최초의 문자의 인덱스

end - 서브 순서의 마지막 문자의 후에 계속되는 문자의 인덱스

반환값:

이 라이터

예외:

IndexOutOfBoundsException - start 또는 end가 잘못된 값 의 경우, start가 end 보다 큰 경우, 혹은 end가 csq.length() 보다 큰 경우

도입된 버전 :

1.5

append

public PrintWriter  append(char c)

이 라이터로 지정된 문자를 추가합니다.

이 메서드를 out.append(c) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.write(c) 

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

c - 추가되는 16 비트의 문자

반환값:

이 라이터

도입된 버전 :

1.5