java.io
클래스 PrintWriter

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

모든 구현된 인터페이스:

Closeable , Flushable , Appendable

public class PrintWriter
extends Writer 

객체의 서식 첨부 표현을 텍스트 출력 스트림에 출력합니다. 이 클래스는,PrintStream 에 있는 print 메소드를 모두 구현합니다. 다만, raw 바이트를 기입하는 메소드는 포함되지 않습니다. raw 바이트에 대해서는, encode되어 있지 않은 바이트 스트림을 프로그램으로 사용해 주세요.

PrintStream 클래스와는 달라, 자동 플래시가 유효한 경우는, 개행 문자가 출력될 때는 아니고,println,printf,format 의 몇개의 메소드가 불려 갔을 때에 마셔 실행됩니다. 이러한 메소드는, 개행 문자는 아니고, 플랫폼에 고유의 행 단락의 표기를 사용합니다.

이 클래스의 메소드는, 생성자 의 일부를 제외해, 입출력 예외를 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) 지정된 문자 순서의 서브 순서를 이 라이터에 추가합니다.
boolean	checkError () 스트림이 닫혀지지 않은 경우는, 그 스트림을 플래시 해, 에러 상태를 체크합니다.
protected void	clearError () 이 스트림의 에러 상태를 해제합니다.
void	close () 스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.
void	flush () 스트림을 플래시 합니다.
PrintWriter	format (Locale l, String format, Object ... args) 지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다.
PrintWriter	format (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 (Locale l, String format, Object ... args) 지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입하는 편리한 메소드입니다.
PrintWriter	printf (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) 캐릭터 라인의 일부를 기입합니다.

클래스 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 가상 머신 인스턴스의디폴트 캐릭터 세트를 사용해, 문자를 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 가상 머신 인스턴스의디폴트 캐릭터 세트를 사용해, 문자를 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()

스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다. 벌써 닫혀지고 있는 스트림을 닫아도, 무슨 영향도 없습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

관련 항목:

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)

단일의 문자를 기입합니다.

오버라이드(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)

캐릭터 라인을 출력해, 행을 종료시킵니다. 이 메소드는,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 - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

printf

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

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입하는 편리한 메소드입니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

이 메소드를 out.printf(l, format, args) 의 형식에서 호출하면(자), 다음의 호출과 같은 결과가 됩니다.

out.format(l, format, args) 

파라미터:

l - 서식 설정시에 적용하는로케일 . l 가 null 의 경우, 로컬라이제이션은 적용되지 않는

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

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

format

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

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

이 객체에 대해서 다른 서식 설정 메소드가 먼저 불려 가고 있었는지 어떠했는지에 관계없이,Locale.getDefault() 에 의해 반환되는 로케일이 항상 사용됩니다.

파라미터:

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

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

format

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

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

파라미터:

l - 서식 설정시에 적용하는로케일 . l 가 null 의 경우, 로컬라이제이션은 적용되지 않는

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

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

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 의 경우는, 이 라이터에 「null」라고 하는 4 문자가 추가된다

반환값:

이 라이터

도입된 버젼:

1.5

append

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

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

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

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

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 문자 서브 순서의 추가원이 되는 문자 순서. csq 가 null 의 경우,csq 에 「null」의 4 문자가 포함되는것 같이 문자가 추가되는

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

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

반환값:

이 라이터

예외:

IndexOutOfBoundsException - start 또는 end 가 0 보다 작은 값의 경우,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