java.io
클래스 PrintStream

java.lang.Object 
  java.io.OutputStream 
      java.io.FilterOutputStream 
          java.io.PrintStream

모든 구현된 인터페이스:

Closeable , Flushable , Appendable

직계의 기존의 서브 클래스:

LogStream

public class PrintStream
extends FilterOutputStream 
implements Appendable , Closeable 

PrintStream 는, 다른 출력 스트림에 기능을 추가합니다. 구체적으로는, 다양한 데이터값의 표현을 간이적으로 출력하는 기능을 추가합니다. 같이 다른 2 개의 기능도 제공되고 있습니다. PrintStream 는 다른 출력 스트림과는 달라, IOException 를 throw 할 것은 없습니다. 예외적인 상황에서는, 단지 내부 플래그가 설정될 뿐입니다. 이 플래그 상태는,checkError 메소드로 조사할 수가 있습니다. 필요에 따라서,PrintStream 를 자동적으로 플래시 하도록(듯이) 작성할 수 있습니다. 즉, 바이트 배열이 기입해졌는지,println 메소드의 1 개가 불려 갔는지, 또는 개행 문자 또는 바이트 ('\n')가 기입해진 뒤에,flush 메소드가 자동적으로 불려 갑니다.

PrintStream 가 출력한 모든 문자는, 이 출력한 모든 문자는, 플랫폼의 디폴트의 문자 인코딩을 사용해 바이트에 변환됩니다. PrintWriter 클래스는, 바이트는 아니고 문자를 기입하는 것이 필요한 상황으로 사용됩니다.

도입된 버젼:

JDK1. 0

필드의 개요

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

out

생성자 의 개요

PrintStream (File file)
행의 자동 플래시는 실시하지 않고 , 지정의 파일로 새로운 출력 스트림을 작성합니다.

PrintStream (File file, String csn)
행의 자동 플래시는 실시하지 않고 , 지정의 파일과 캐릭터 세트로 새로운 출력 스트림을 작성합니다.

PrintStream (OutputStream out)
새로운 PrintStream 를 작성합니다.

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

PrintStream (OutputStream out, boolean autoFlush, String encoding)
새로운 PrintStream 를 작성합니다.

PrintStream (String fileName)
행의 자동 플래시는 실시하지 않고 , 지정의 이름으로 새로운 출력 스트림을 작성합니다.

PrintStream (String fileName, String csn)
행의 자동 플래시는 실시하지 않고 , 지정의 이름과 캐릭터 세트로 새로운 출력 스트림을 작성합니다.

메소드의 개요

PrintStream	append (char c) 이 출력 스트림로 지정된 문자를 추가합니다.
PrintStream	append (CharSequence csq) 이 출력 스트림로 지정된 문자 순서를 추가합니다.
PrintStream	append (CharSequence csq, int start, int end) 지정된 문자 순서의 서브 순서를 이 출력 스트림에 추가합니다.
boolean	checkError () 스트림을 플래시 해, 그 에러 상황을 확인합니다.
protected void	clearError () 이 스트림의 내부 에러 상태를 해제합니다.
void	close () 스트림을 닫습니다.
void	flush () 스트림을 플래시 합니다.
PrintStream	format (Locale l, String format, Object ... args) 지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 출력 스트림의 행선지에 기입합니다.
PrintStream	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) 캐릭터 라인을 출력합니다.
PrintStream	printf (Locale l, String format, Object ... args) 서식 첨부 캐릭터 라인을, 지정된 서식 캐릭터 라인과 인수를 사용해, 이 출력 스트림에 기입하는 편리한 방법입니다.
PrintStream	printf (String format, Object ... args) 서식 첨부 캐릭터 라인을, 지정된 서식 캐릭터 라인과 인수를 사용해, 이 출력 스트림에 기입하는 편리한 방법입니다.
void	println () 개행 캐릭터 라인을 기입하는 것에 의해, 현재의 행을 개행합니다.
void	println (boolean x) boolean 치를 출력해, 행을 종료합니다.
void	println (char x) 문자를 출력해, 행을 종료합니다.
void	println (char[] x) 문자의 배열을 출력해, 행을 종료합니다.
void	println (double x) double 를 출력해, 행을 종료합니다.
void	println (float x) float 를 출력해, 행을 종료합니다.
void	println (int x) 정수를 출력해, 행을 종료합니다.
void	println (long x) long 를 출력해, 행을 종료합니다.
void	println (Object x) Object 를 출력해, 행을 종료합니다.
void	println (String x) String 를 출력해, 행을 종료합니다.
protected void	setError () 스트림의 에러 상태를 true 로 설정합니다.
void	write (byte[] buf, int off, int len) 오프셋(offset) 위치 off 로부터 시작되는 지정된 바이트 배열로부터, 이 스트림에 len 바이트를 기입합니다.
void	write (int b) 지정된 바이트를, 이 스트림에 기입합니다.

클래스 java.io. FilterOutputStream 로부터 상속된 메소드

write

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

PrintStream

public PrintStream(OutputStream  out)

새로운 PrintStream 를 작성합니다. 이 스트림은, 자동적으로 플래시 할 것은 없습니다.

파라미터:

out - 치와 객체가 출력되는 출력 스트림

관련 항목:

PrintWriter.PrintWriter(java.io.OutputStream)

PrintStream

public PrintStream(OutputStream  out,
                   boolean autoFlush)

새로운 PrintStream 를 작성합니다.

파라미터:

out - 치와 객체가 출력되는 출력 스트림

autoFlush - boolean 치. true 의 경우, 바이트 배열이 기입해졌을 때,println 메소드의 1 개가 불려 갔을 때, 또는 개행 문자 또는 바이트 ('\n')가 기입해졌을 때에, 출력 버퍼가 플래시 되는

관련 항목:

PrintWriter.PrintWriter(java.io.OutputStream, boolean)

PrintStream

public PrintStream(OutputStream  out,
                   boolean autoFlush,
                   String  encoding)
            throws UnsupportedEncodingException 

새로운 PrintStream 를 작성합니다.

파라미터:

out - 치와 객체가 출력되는 출력 스트림

autoFlush - boolean 치. true 의 경우, 바이트 배열이 기입해졌을 때,println 메소드의 1 개가 불려 갔을 때, 또는 개행 문자 또는 바이트 ('\n')가 기입해졌을 때에, 출력 버퍼가 플래시 되는

encoding - 지원되는문자 인코딩의 이름

예외:

UnsupportedEncodingException - 지정된 인코딩이 지원되어 있지 않은 경우

도입된 버젼:

1.4

PrintStream

public PrintStream(String  fileName)
            throws FileNotFoundException 

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

파라미터:

fileName - 이 출력 스트림의 행선지로서 사용하는 파일의 이름. 파일이 존재하는 경우, 사이즈 0 에 절약할 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 포함된다

예외:

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

SecurityException - 시큐리티 매니저가 존재해, 시큐리티 매니저의 checkWrite(fileName) 메소드가 파일에의 기입해 액세스를 허가하지 않는 경우

도입된 버젼:

1.5

PrintStream

public PrintStream(String  fileName,
                   String  csn)
            throws FileNotFoundException ,
                   UnsupportedEncodingException 

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

파라미터:

fileName - 이 출력 스트림의 행선지로서 사용하는 파일의 이름. 파일이 존재하는 경우, 사이즈 0 에 절약할 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 포함되는

csn - 지원하는 charset 의 이름

예외:

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

SecurityException - 시큐리티 매니저가 존재해, 시큐리티 매니저의 checkWrite(fileName) 메소드가 파일에의 기입해 액세스를 허가하지 않는 경우

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

도입된 버젼:

1.5

PrintStream

public PrintStream(File  file)
            throws FileNotFoundException 

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

파라미터:

file - 이 출력 스트림의 행선지로서 사용하는 파일. 파일이 존재하는 경우, 사이즈 0 에 절약할 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 포함된다

예외:

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

SecurityException - 시큐리티 매니저가 존재해, 시큐리티 매니저의 checkWrite(file.getPath()) 메소드가 파일에의 기입해 액세스를 허가하지 않는 경우

도입된 버젼:

1.5

PrintStream

public PrintStream(File  file,
                   String  csn)
            throws FileNotFoundException ,
                   UnsupportedEncodingException 

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

파라미터:

file - 이 출력 스트림의 행선지로서 사용하는 파일. 파일이 존재하는 경우, 사이즈 0 에 절약할 수 있다. 파일이 없으면 새로운 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 포함되는

csn - 지원하는 charset 의 이름

예외:

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

SecurityException - 시큐리티 매니저가 존재해, 시큐리티 매니저의 checkWrite(file.getPath()) 솟드가 파일에의 기입해 액세스를 허가하지 않는 경우

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

도입된 버젼:

1.5

메소드의 상세

flush

public void flush()

스트림을 플래시 합니다. 버퍼 된 출력 바이트를 기본이 되는 출력 스트림에 기입해, 이 스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

오버라이드(override):

클래스 FilterOutputStream 내의 flush

관련 항목:

OutputStream.flush()

close

public void close()

스트림을 닫습니다. 스트림을 플래시 해, 기본이 되는 출력 스트림을 닫습니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 FilterOutputStream 내의 close

관련 항목:

OutputStream.close()

checkError

public boolean checkError()

스트림을 플래시 해, 그 에러 상황을 확인합니다. 기본이 되는 출력 스트림이 InterruptedIOException 는 아니고 IOException 를 throw 했을 경우, 및 setError 메소드가 불려 갔을 경우에, 내부 에러 상태는 true 로 설정됩니다. 기본이 되는 출력 스트림의 오퍼레이션이 InterruptedIOException 를 throw 하면(자),PrintStream 가 다음의 조작 또는 거기에 상당하는 조작에 의해 예외를 변환해 인터럽트에 되돌립니다.

Thread.currentThread(). interrupt();
 

또는 동등의 것

반환값:

이 스트림이 InterruptedIOException 는 아니고 IOException 를 검출했을 경우, 또는 setError 메소드가 불려 갔을 경우는 true

setError

protected void setError()

스트림의 에러 상태를 true 로 설정합니다.

이 메소드를 사용하면(자),clearError() 가 불려 갈 때까지,checkError() 가 계속해 불려 가 true 가 돌려주어집니다.

도입된 버젼:

JDK1. 1

clearError

protected void clearError()

이 스트림의 내부 에러 상태를 해제합니다.

이 메소드를 사용하면(자), 다른 기입 처리가 실패해,setError() 가 불려 갈 때까지,checkError() 가 계속해 불려 가 false 가 돌려주어집니다.

도입된 버젼:

1.6

write

public void write(int b)

지정된 바이트를, 이 스트림에 기입합니다. 바이트가 복귀 개행으로, 자동 플래시가 유효한 경우는,flush 메소드가 불려 갑니다.

바이트는, 지정된 채로 기입해지는 것에 주의해 주세요. 플랫폼의 디폴트의 문자 인코딩에 따라 변환된 문자를 기입하려면 ,print(char) 또는 println(char) 메소드를 사용합니다.

오버라이드(override):

클래스 FilterOutputStream 내의 write

파라미터:

b - 기입해지는 바이트

관련 항목:

print(char) , println(char)

write

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

오프셋(offset) 위치 off 로부터 시작되는 지정된 바이트 배열로부터, 이 스트림에 len 바이트를 기입합니다. 자동 플래시가 유효한 경우는,flush 메소드가 불려 갑니다.

바이트는, 지정된 채로 기입해집니다. 플랫폼의 디폴트의 문자 인코딩에 따라 변환된 캐릭터 라인을 기입하려면 ,print(char) 멧소드 또는 println(char) 메소드를 사용합니다.

오버라이드(override):

클래스 FilterOutputStream 내의 write

파라미터:

buf - 바이트 배열

off - 바이트의 혼잡 개시 오프셋(offset)

len - 기입해지는 바이트수

관련 항목:

FilterOutputStream.write(int)

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)

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

파라미터:

x - 출력되는 float 치

println

public void println(double x)

double 를 출력해, 행을 종료합니다. 이 메소드는,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 를 출력해, 행을 종료합니다. 이 메소드는, 최초로 String.valueOf(x)를 호출해, 출력된 객체의 캐릭터 라인치를 가져옵니다. 다음에,print(String) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 Object 치

printf

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

서식 첨부 캐릭터 라인을, 지정된 서식 캐릭터 라인과 인수를 사용해, 이 출력 스트림에 기입하는 편리한 방법입니다.

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

     out.format(format, args) 

파라미터:

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

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

반환값:

이 출력 스트림

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 주어진(given) 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 올바르지 않은 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 스펙에 대해서는, 포매터 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

printf

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

서식 첨부 캐릭터 라인을, 지정된 서식 캐릭터 라인과 인수를 사용해, 이 출력 스트림에 기입하는 편리한 방법입니다.

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

     out.format(l, format, args) 

파라미터:

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

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

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

반환값:

이 출력 스트림

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 주어진(given) 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 올바르지 않은 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 스펙에 대해서는, 포매터 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

format

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

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 출력 스트림의 행선지에 기입합니다.

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

파라미터:

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

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

반환값:

이 출력 스트림

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 주어진(given) 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 올바르지 않은 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 스펙에 대해서는, 포매터 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

format

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

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 출력 스트림의 행선지에 기입합니다.

파라미터:

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

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

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

반환값:

이 출력 스트림

예외:

IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 주어진(given) 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 올바르지 않은 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 스펙에 대해서는, 포매터 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

append

public PrintStream  append(CharSequence  csq)

이 출력 스트림로 지정된 문자 순서를 추가합니다.

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

     out.print(csq.toString()) 

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

정의:

인터페이스 Appendable 내의 append

파라미터:

csq - 추가되는 문자 순서. csq 가 null 의 경우는, 이 출력 스트림에 「null」라고 하는 4 문자가 추가된다

반환값:

이 출력 스트림

도입된 버젼:

1.5

append

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

지정된 문자 순서의 서브 순서를 이 출력 스트림에 추가합니다.

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

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

정의:

인터페이스 Appendable 내의 append

파라미터:

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

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

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

반환값:

이 출력 스트림

예외:

IndexOutOfBoundsException - start 또는 end 가 0 보다 작은 값의 경우,start 가 end 보다 큰 경우, 또는 end 가 csq.length() 보다 큰 경우

도입된 버젼:

1.5

append

public PrintStream  append(char c)

이 출력 스트림로 지정된 문자를 추가합니다.

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

     out.print(c) 

정의:

인터페이스 Appendable 내의 append

파라미터:

c - 추가되는 16 비트 문자

반환값:

이 출력 스트림

도입된 버젼:

1.5