java.io
클래스 PrintWriter

java.lang.Object 
  |
  +--java.io.Writer 
        |
        +--java.io.PrintWriter

public class PrintWriter

extends Writer

포맷 된 오브젝트의 표현을 텍스트 출력 스트림에 출력합니다. 이 클래스에서는 PrintStream 에 있는 인자 메소드를 모두 구현하고 있습니다. 다만, 생의 바이트를 기입하는 메소드는 포함하지 않습니다. 이러한 경우는 코드화되어 있지 않은 바이트 스트림을 프로그램으로 사용하지 않으면 안됩니다.

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

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

도입된 버젼:

JDK1. 1

필드의 개요

protected Writer

out 이 PrintWriter 의 기본이 되는 캐릭터 출력 스트림입니다.

클래스 java.io. Writer 에서 상속받은 필드

lock

생성자의 개요

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

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

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

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

메소드의 개요

boolean	checkError () 스트림이 닫지 않으면 플래시 해, 그 에러 상태를 체크합니다.
void	close () 스트림을 닫습니다.
void	flush () 스트림을 플래시 합니다.
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) 캐릭터 라인을 출력합니다.
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() 메소드에서는 출력 버퍼를 플래시 한다

PrintWriter

public PrintWriter(OutputStream  out)

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

파라미터:

out - 출력 스트림

관련 항목:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(OutputStream  out,
                   boolean autoFlush)

기존의 OutputStream 로부터 새로운 PrintWriter 를 작성합니다. 이 간이 constructor 에서는 필요한 중간의 OutputStreamWriter 를 작성합니다. 이것에 의해, 디폴트의 캐릭터 인코딩을 사용해 캐릭터를 바이트로 변환합니다.

파라미터:

out - 출력 스트림

autoFlush - boolean 치. 값이 true 의 경우, println() 메소드에서는 출력 버퍼를 플래시 하는

관련 항목:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

메소드의 상세

flush

public void flush()

스트림을 플래시 합니다.

정의:

클래스 Writer 내의 flush

관련 항목:

checkError()

close

public void close()

스트림을 닫습니다.

정의:

클래스 Writer 내의 close

관련 항목:

checkError()

checkError

public boolean checkError()

스트림이 닫지 않으면 플래시 해, 그 에러 상태를 체크합니다. 에러는 누적됩니다. 스트림이 에러를 한 번 검출하면(자), 이 routine는 연속하는 모든 호출로 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 치