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 

다른 출력 스트림에 기능을 추가합니다. 구체적으로는 다양한 데이터의 표현을 간이적으로 출력하는 기능을 추가합니다. 같이 다른 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 () 스트림을 플래시 해, 그 에러 상황을 확인합니다.
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 - 지정된 캐릭터셋가 지원되어 있지 않은 경우

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로 설정합니다.

도입된 버전 :

JDK1. 1

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를 출력해, 행을 종료합니다. 이 메서드는 #print(object)를 호출하고 나서 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 - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」섹션을 참조

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

NullPointerException - format가 null인 경우

도입된 버전 :

1.5

format

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

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

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

파라미터:

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

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

반환값:

이 출력 스트림

예외:

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

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

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가 잘못된 값 의 경우, 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