java.io
인터페이스 DataOutput

알려진 서브 인터페이스 목록 :

ImageOutputStream, ObjectOutput

알려진 구현 클래스 목록:

DataOutputStream, FileCacheImageOutputStream, FileImageOutputStream, ImageOutputStreamImpl, MemoryCacheImageOutputStream, ObjectOutputStream, RandomAccessFile

public interface DataOutput

Java 원시형이 있으면 그 데이터를 일련의 바이트로 변환해 바이너리 스트림에 출력하기 위해서 제공되고 있습니다. 또, String를 수정 UTF-8 형식으로 변환해 결과의 일련의 바이트를 출력하는 기능도 있습니다.

이 인터페이스의 바이트를 출력하는 모든 메서드에서는 하등의 이유로써 바이트를 출력할 수 없는 경우는 보통, IOException가 발생 됩니다.

도입된 버전 :

JDK1. 0

관련 항목:

DataInput, DataOutputStream

메서드 개요

void	write (byte[] b) 출력 스트림에 배열 b 모든 바이트를 출력합니다.
void	write (byte[] b, int off, int len) 배열 b로 부터 len 바이트를 차례로 출력 스트림에 출력합니다.
void	write (int b) 인수 b 하위 8 비트를 출력 스트림에 출력합니다.
void	writeBoolean (boolean v) 1개의 boolean값을 출력 스트림에 출력합니다.
void	writeByte (int v) 인수 v 하위 8 비트를 출력 스트림에 출력합니다.
void	writeBytes (String s) 캐릭터 라인을 출력 스트림에 출력합니다.
void	writeChar (int v) 2 바이트로부터 구성되는 char값을 출력 스트림에 출력합니다.
void	writeChars (String s) 캐릭터 라인 s 내의 각 문자를, 1 문자 마다 2 바이트씩 차례로 출력합니다.
void	writeDouble (double v) 8 바이트로부터 구성되는 double값을 출력 스트림에 출력합니다.
void	writeFloat (float v) 4 바이트로부터 구성되는 float값을 출력 스트림에 출력합니다.
void	writeInt (int v) 4 바이트로부터 구성되는 int값을 출력 스트림에 출력합니다.
void	writeLong (long v) 8 바이트로부터 구성되는 long값을 출력 스트림에 출력합니다.
void	writeShort (int v) 인수의 값을 나타내는 2 바이트를 출력 스트림에 출력합니다.
void	writeUTF (String str) 길이 정보의 2 바이트를 출력 스트림에 출력합니다.

메서드의 상세

write

void write(int b)
           throws IOException 

인수 b 하위 8 비트를 출력 스트림에 출력합니다. b 상위 24 비트에 대해서는 무시됩니다.

파라미터:

b - 출력하는 바이트

예외:

IOException - 입출력 에러가 발생했을 경우

write

void write(byte[] b)
           throws IOException 

출력 스트림에 배열 b 모든 바이트를 출력합니다. b가 null인 경우, NullPointerException가 발생 됩니다. b.length가 제로의 경우, 출력해지는 바이트는 없습니다. 그렇지 않은 경우는 우선 바이트 b[0], 다음에 b[1] 으로 차례차례 출력해져 마지막에 바이트 b[b.length-1]가 출력해집니다.

파라미터:

b - 데이터

예외:

IOException - 입출력 에러가 발생했을 경우

write

void write(byte[] b,
           int off,
           int len)
           throws IOException 

배열 b로 부터 len 바이트를 차례로 출력 스트림에 출력합니다. b가 null인 경우는 NullPointerException가 발생 됩니다. off가 잘못된 값 의 경우, len가 잘못된 값 의 경우, 혹은 off+len가 배열 b 길이보다 큰 경우에는 IndexOutOfBoundsException가 발생 됩니다. len가 제로의 경우, 출력해지는 바이트는 없습니다. 그렇지 않은 경우는 우선 바이트 b[off], 다음에 b[off+1]와 차례차례 출력해져 마지막에 바이트 b[off+len-1]가 출력해집니다.

파라미터:

b - 데이터

off - 데이터의 개시 오프셋(offset)

len - 출력하는 바이트수

예외:

IOException - 입출력 에러가 발생했을 경우

writeBoolean

void writeBoolean(boolean v)
                  throws IOException 

1개의 boolean값을 출력 스트림에 출력합니다. 인수 v가 true인 경우는 값 (byte) 1 이 출력해집니다. v가 false인 경우는 값 (byte) 0 이 출력해집니다. 이 메서드가 출력하는 바이트는 DataInput인터페이스의 readBoolean 메서드에 의해 읽힙니다. 다음에 readBoolean 메서드에의해 v에 동일한 boolean가 리턴됩니다 .

파라미터:

v - 출력해지는 boolean

예외:

IOException - 입출력 에러가 발생했을 경우

writeByte

void writeByte(int v)
               throws IOException 

인수 v 하위 8 비트를 출력 스트림에 출력합니다. v 상위 24 비트는 무시됩니다. 즉, writeByte 동작은 정수형 인수의 경우는 write와 완전히 같습니다. 이 메서드가 출력하는 바이트는 DataInput인터페이스의 readByte 메서드에 의해 읽힙니다. 다음에 readByte 메서드에의해 (byte) v에 동일한 byte가 리턴됩니다 .

파라미터:

v - 출력해지는 바이트값

예외:

IOException - 입출력 에러가 발생했을 경우

writeShort

void writeShort(int v)
                throws IOException 

인수의 값을 나타내는 2 바이트를 출력 스트림에 출력합니다. 다음에 나타내는 바이트값이 이 차례로 출력해집니다.

 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)
  

이 메서드가 출력하는 바이트는 DataInput인터페이스의 readShort 메서드에 의해 읽힙니다. 다음에 readShort 메서드에의해 (short) v에 동일한 short이 리턴됩니다 .

파라미터:

v - 출력해지는 short값

예외:

IOException - 입출력 에러가 발생했을 경우

writeChar

void writeChar(int v)
               throws IOException 

2 바이트로부터 구성되는 char값을 출력 스트림에 출력합니다. 다음에 나타내는 바이트값이 이 차례로 출력해집니다.

 (byte)(0xff & (v >> 8)) (byte)(0xff & v) 

이 메서드가 출력하는 바이트는 DataInput인터페이스의 readChar 메서드에 의해 읽힙니다. 다음에 readChar 메서드에의해 (char) v에 동일한 char가 리턴됩니다 .

파라미터:

v - 출력해지는 char값

예외:

IOException - 입출력 에러가 발생했을 경우

writeInt

void writeInt(int v)
              throws IOException 

4 바이트로부터 구성되는 int값을 출력 스트림에 출력합니다. 다음에 나타내는 바이트값이 이 차례로 출력해집니다.

 (byte)(0xff & (v >> 24)) (byte)(0xff & (v >> 16)) (byte)(0xff & (v >>    8)) (byte)(0xff & v) 

이 메서드가 출력하는 바이트는 DataInput인터페이스의 readInt 메서드에 의해 읽힙니다. 다음에 readInt 메서드에의해 v에 동일한 int이 리턴됩니다 .

파라미터:

v - 출력해지는 int값

예외:

IOException - 입출력 에러가 발생했을 경우

writeLong

void writeLong(long v)
               throws IOException 

8 바이트로부터 구성되는 long값을 출력 스트림에 출력합니다. 다음에 나타내는 바이트값이 이 차례로 출력해집니다.

 (byte)(0xff & (v >> 56)) (byte)(0xff & (v >> 48)) (byte)(0xff & (v >> 40)) (byte)(0xff & (v >> 32)) (byte)(0xff & (v >> 24)) (byte)(0xff & (v >> 16)) (byte)(0xff & (v >>  8)) (byte)(0xff & v) 

이 메서드가 출력하는 바이트는 DataInput인터페이스의 readLong 메서드에 의해 읽힙니다. 다음에 readLong 메서드에의해 v에 동일한 long가 리턴됩니다 .

파라미터:

v - 출력해지는 long값

예외:

IOException - 입출력 에러가 발생했을 경우

writeFloat

void writeFloat(float v)
                throws IOException 

4 바이트로부터 구성되는 float값을 출력 스트림에 출력합니다. 이 때문에는 우선 Float.floatToIntBits 메서드와 완전히 같은 방법으로 이 float값을 int로 변환하고 나서, writeInt 메서드와 완전히 같은 방법으로 int값을 출력합니다. 이 메서드가 출력하는 바이트는 DataInput인터페이스의 readFloat 메서드에 의해 읽힙니다. 다음에 readFloat 메서드에의해 v에 동일한 float이 리턴됩니다 .

파라미터:

v - 출력해지는 float 치

예외:

IOException - 입출력 에러가 발생했을 경우

writeDouble

void writeDouble(double v)
                 throws IOException 

8 바이트로부터 구성되는 double값을 출력 스트림에 출력합니다. 이 때문에는 우선 Double.doubleToLongBits 메서드와 완전히 같은 방법으로 이 double값을 long로 변환하고 나서, writeLong 메서드와 완전히 같은 방법으로 long값을 출력합니다. 이 메서드가 출력하는 바이트는 DataInput인터페이스의 readDouble 메서드에 의해 읽힙니다. 다음에 readDouble 메서드에의해 v에 동일한 double가 리턴됩니다 .

파라미터:

v - 출력해지는 double 치

예외:

IOException - 입출력 에러가 발생했을 경우

writeBytes

void writeBytes(String  s)
                throws IOException 

캐릭터 라인을 출력 스트림에 출력합니다. 캐릭터 라인 s 각 문자가 차례로 꺼내져 1 바이트가 출력 스트림에 출력해집니다. s가 null인 경우는 NullPointerException가 발생 됩니다.

s.length가 제로의 경우, 출력해지는 바이트는 없습니다. 그렇지 않은 경우는 우선 문자 s[0], 다음에 s[1] 이라고 하는 상태에 차례차례 출력해져 마지막에 문자 s[s.length-1]가 출력해집니다. 각 문자에 대해서는 writeByte 메서드와 완전히 같은 방법으로 1 바이트, 즉 하위 바이트가 출력해집니다. 캐릭터 라인내의 각 문자의 상위 8 비트는 무시됩니다.

파라미터:

s - 출력해지는 바이트의 캐릭터 라인

예외:

IOException - 입출력 에러가 발생했을 경우

writeChars

void writeChars(String  s)
                throws IOException 

캐릭터 라인 s 내의 각 문자를, 1 문자 마다 2 바이트씩 차례로 출력합니다. s가 null인 경우, NullPointerException가 발생 됩니다. s.length가 제로의 경우, 출력해지는 문자는 없습니다. 그렇지 않은 경우는 우선 문자 s[0], 다음에 s[1] 으로 차례차례 출력해져 마지막에 문자 s[s.length-1]가 출력해집니다. 각 문자에 대해서는 writeChar 메서드와 완전히 같은 방법으로 상위 바이트를 먼저의해 2 바이트가 실제로 출력해집니다.

파라미터:

s - 출력해지는 캐릭터 라인의 값

예외:

IOException - 입출력 에러가 발생했을 경우

writeUTF

void writeUTF(String  str)
              throws IOException 

길이 정보의 2 바이트를 출력 스트림에 출력합니다. 그 뒤에는 캐릭터 라인 s 내의 각 문자의 수정 UTF-8 표현이 계속됩니다. s가 null인 경우, NullPointerException가 발생 됩니다. 캐릭터 라인 s 내의 각 문자는 문자의 값에 기반해 1, 2, 또는 3 바이트의 그룹에 변환됩니다.

문자 c가 \u0001 ~ \u007f 범위에 있는 경우, 다음과 같은 1 바이트로 표현됩니다.

(byte) c 

문자 c가 \u0000인 경우나, \u0080 ~ \u07ff 범위에 있는 경우에는 다음의 순서로 출력해지는 2 바이트에 의해 나타내집니다.

 (byte)(0xc0 | (0x1f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))
  

문자 c가 \u0800 ~ uffff 범위에 있는 경우, 다음의 순서로 출력해지는 3 바이트에 의해 나타내집니다.

 (byte)(0xe0 | (0x0f & (c >> 12)))
 (byte)(0x80 | (0x3f & (c >>  6)))
 (byte)(0x80 | (0x3f & c))
  

우선, s 모든 문자를 나타내는데 필요한 총바이트수가 계산됩니다. 이 수값이 65535를 넘는 경우는 UTFDataFormatException가 발생 됩니다. 그렇지 않은 경우는 이 길이가 writeShort 메서드와 완전히 같은 방법으로 출력 스트림에 출력해집니다. 다음에 캐릭터 라인 s 내의 각 문자의 1, 2, 또는 3 바이트 표현이 출력해집니다.

이 메서드가 출력하는 바이트는 DataInput인터페이스의 readUTF 메서드에 의해 읽힙니다. 다음에 readUTF 메서드에의해 s에 동일한 String가 리턴됩니다 .

파라미터:

str - 출력해지는 캐릭터 라인의 값

예외:

IOException - 입출력 에러가 발생했을 경우