java.io
클래스 RandomAccessFile

java.lang.Object 
  java.io.RandomAccessFile

모든 구현된 인터페이스:

Closeable, DataInput, DataOutput

public class RandomAccessFile
extends Object 
implements DataOutput,
 DataInput,
 Closeable 

이 클래스의 인스턴스는 랜덤 액세스 파일로부터의 read/출력의 양쪽 모두를 지원합니다. 랜덤 액세스 파일의 동작은 파일 시스템에 포함되고 있는 대규모 바이트 배열을 닮아 있습니다. 상정되는 배열에는 커서와 같은 「파일 포인터」라고 불리는 인덱스가 있습니다. 입력 처리는 파일 포인터 위치로부터 시작되는 일련의 바이트를 읽기, 읽어들인 바이트분만큼 파일 포인터를 먼저 진행합니다. 읽기 /출력 모드로 작성되고 있는 경우, 랜덤 액세스 파일은 출력 처리에도 사용할 수 있습니다. 출력 처리는 파일 포인터 위치로부터 시작되는 일련의 바이트를 출력해, 출력한 바이트분만큼 파일 포인터를 먼저 진행합니다. 출력 처리는 상정된 배열의 현재의 말미를 넘어 출력하는 경우에는 배열이 확장됩니다. 파일 포인터는 getFilePointer 메서드에 의해 읽기, seek 메서드에 의해 설정합니다.

이 클래스내의 모든 read 루틴에서는 필요한 바이트수가 읽히기 전에 파일의 마지막에 이르렀을 경우는 보통, EOFException (IOException 일종)가 발생 됩니다. 파일의 마지막에 이르렀다고 하는 이외의 이유로써 바이트의 read가 실패했을 경우는 EOFException 이외의 IOException가 발생 됩니다. 특히, 스트림이 닫혀지고 있으면, IOException가 발생 됩니다.

도입된 버전 :

JDK1. 0

생성자 개요

RandomAccessFile (File file, String mode)
File 인수로 지정된 파일을 읽기 원으로서 또 경우에 따라서는 출력앞으로서 랜덤 액세스 파일 스트림을 작성합니다.

RandomAccessFile (String name, String mode)
지정된 이름을 가지는 파일로부터의 읽기 및 옵션으로 write를 실시하는 랜덤 액세스 파일 스트림을 작성합니다.

메서드 개요

void	close () 이 랜덤 액세스 파일 스트림을 종료해, 이 스트림에 관련된 모든 system resource를 해방합니다.
FileChannel	getChannel () 이 파일에 관련된, 하나의 FileChannel 객체를 리턴합니다.
FileDescriptor	getFD () 이 스트림에 관련된 불투명한 파일 기술자를 리턴합니다.
long	getFilePointer () 이 파일의 현재의 오프셋(offset)를 리턴합니다.
long	length () 이 파일의 길이를 리턴합니다.
int	read () 이 파일로부터 1 바이트의 데이터를 읽어들입니다.
int	read (byte[] b) 이 파일로부터 최대 b.length 바이트의 데이터를 바이트 배열에 읽어들입니다.
int	read (byte[] b, int off, int len) 이 파일로부터 최대 len 바이트의 데이터를 바이트 배열에 읽어들입니다.
boolean	readBoolean () 이 파일로부터 boolean을 읽어들입니다.
byte	readByte () 이 파일로부터 부호 첨부 8 비트치를 읽어들입니다.
char	readChar () 이 파일로부터 Unicode 문자를 읽어들입니다.
double	readDouble () 이 파일로부터 double를 읽어들입니다.
float	readFloat () 이 파일로부터 float를 읽어들입니다.
void	readFully (byte[] b) 이 파일로부터 바이트 배열에 현재의 파일 포인터 위치로부터 시작해 b.length 바이트를 읽어들입니다.
void	readFully (byte[] b, int off, int len) 이 파일로부터 바이트 배열에 현재의 파일 포인터 위치로부터 시작해 len 바이트를 읽어들입니다.
int	readInt () 이 파일로부터 부호 첨부 32 비트 정수를 읽어들입니다.
String	readLine () 이 파일의 다음의 텍스트행을 읽어들입니다.
long	readLong () 이 파일로부터 부호 첨부의 64 비트 정수를 읽어들입니다.
short	readShort () 부호 첨부 16 비트수를 이 파일로부터 읽어들입니다.
int	readUnsignedByte () 이 파일로부터 부호 없음 8 비트수를 읽어들입니다.
int	readUnsignedShort () 부호 없음 16 비트수를 이 파일로부터 읽어들입니다.
String	readUTF () 이 파일로부터 캐릭터 라인을 읽어들입니다.
void	seek (long pos) 이 파일의 선두를 시점으로서 파일 포인터의 오프셋(offset)를 설정합니다.
void	setLength (long newLength) 이 파일의 길이를 설정합니다.
int	skipBytes (int n) n 바이트의 입력을 스킵 해, 스킵 한 바이트를 파기하려고 합니다.
void	write (byte[] b) 지정된 바이트 배열로부터 이 파일에 현재의 파일 포인터 위치로부터 개시해 b.length 바이트를 출력합니다.
void	write (byte[] b, int off, int len) 지정된 바이트 배열의 오프셋(offset) off로 부터 len 바이트를, 이 파일에 출력합니다.
void	write (int b) 지정된 바이트를 파일에 출력합니다.
void	writeBoolean (boolean v) boolean을 1 바이트값으로 파일에 출력합니다.
void	writeByte (int v) byte를 1 바이트값으로 파일에 출력합니다.
void	writeBytes (String s) 캐릭터 라인을 일련의 바이트로서 파일에 출력합니다.
void	writeChar (int v) char를 2 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다).
void	writeChars (String s) 캐릭터 라인을 일련의 문자로서 파일에 출력합니다.
void	writeDouble (double v) Double 클래스의 doubleToLongBits 메서드를 사용해 double 인수를 long로 변환하고 나서, 그 long값을 8 바이트값으로 상위 바이트로부터 먼저 파일에 출력합니다.
void	writeFloat (float v) Float 클래스의 floatToIntBits 메서드를 사용해 float 인수를 int로 변환하고 나서, 그 int값을 4 바이트값으로 상위 바이트로부터 먼저 파일에 출력합니다.
void	writeInt (int v) int를 4 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다).
void	writeLong (long v) long를 8 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다).
void	writeShort (int v) short를 2 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다).
void	writeUTF (String str) 머신에 존하지 않는수정 UTF-8 인코딩을 사용해, 캐릭터 라인을 파일에 출력합니다.

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

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

생성자 상세

RandomAccessFile

public RandomAccessFile(String  name,
                        String  mode)
                 throws FileNotFoundException 

지정된 이름을 가지는 파일로부터의 읽기 및 옵션으로 write를 실시하는 랜덤 액세스 파일 스트림을 작성합니다. 파일에의 접속을 나타내는 새로운 FileDescriptor 객체가 생성됩니다.

mode 인수에는 파일을 열 때의 액세스 모드를 지정합니다. 지정할 수 있는 값과 그 미는 RandomAccessFile(File, String) 생성자 인수와 같습니다.

시큐러티 매니저가 존재하는 경우, 파일에의 읽기 액세스가 허가되고 있는지를 확인하기 위해서 인수로서 name를 취하는 시큐러티 매니저의 checkRead 메서드가 호출됩니다. 출력이 허가되는 모드의 경우, 파일에의 쓰기 권한가 허가되고 있는지를 확인하기 위해서 인수로서 name를 취하는 시큐러티 매니저의 checkWrite 메서드도 호출합니다.

파라미터:

name - 시스템에 의존된 파일명

mode - 액세스모드

예외:

IllegalArgumentException - mode 인수가 "r", "rw", "rws", 또는 "rwd"가 아닌 경우

FileNotFoundException - 모드가 "r" 이지만 지정의 캐릭터 라인이 기존의 보통 파일을 나타내지 않는 경우. 모드가 "rw"로 부터 시작되지만 지정의 캐릭터 라인이 기존의, 출력가능한 보통 파일을 나타내지 않고, 그 이름을 가지는 보통 파일을 작성할 수 없는 경우. 또는 파일을 열고 있을 때나 작성할 때, 그 외의 에러가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkRead 메서드가 파일에의 읽기 액세스를 거부했을 경우, 혹은 모드가 "rw" 로 시큐러티 매니저의 checkWrite 메서드가 파일에의 쓰기 권한을 거부했을 경우

관련 항목:

SecurityException, SecurityManager.checkRead(java.lang.String), SecurityManager.checkWrite(java.lang.String)

RandomAccessFile

public RandomAccessFile(File  file,
                        String  mode)
                 throws FileNotFoundException 

File 인수로 지정된 파일을 읽기 원으로서 또 경우에 따라서는 출력앞으로서 랜덤 액세스 파일 스트림을 작성합니다. 이 파일 접속을 나타내는 새로운 FileDescriptor 객체가 생성됩니다.

mode 인수에는 파일을 열 때의 액세스 모드를 지정합니다. 지정할 수 있는 값과 그 미를 다음에 나타냅니다.

값	의미
"r"	read용으로 연다. 연 객체의 임의의 write 메서드를 호출하면, IOException이 발생되는
"rw"	read 및 출력해용으로 연다. 파일이 존재하지 않는 경우는 작성하려고 하는
"rws"	"rw"와 같게, read 및 출력해용으로 연다. 파일의 내용 또는 메타데이타를 갱신했을 때는 바탕으로 되는 기억장치에도 동시에 적용할 필요가 있는
"rwd"	"rw"와 같게, read 및 출력해용으로 연다. 파일의 내용을 갱신했을 때는 바탕으로 되는 기억장치에도 동시에 적용할 필요가 있다

"rws" 모드와 "rwd" 모드의 동작은, FileChannel 클래스의 force(boolean) 메서드에 true 인수 또는 false 인수를 건네주었을 경우에 각각 닮았습니다. 다만, 이러한 모드는 모든 입출력 조작에 적용되기 때문에 보다 효율적입니다. 파일이 로컬 기억장치에 있는 경우, 이 클래스의 메서드를 호출했을 때에는 파일에 적용한 변경이 기억장치에도 항상 출력해집니다. 이 기능을 이용하면, 시스템에 장해가 발생했을 때에 중요한 정보가 없어지는 일이 없습니다. 파일이 로컬 기억장치에 없는 경우는 이 규칙은 적용되지 않습니다.

"rwd" 모드는 실행되는 입출력 조작의 수를 줄이기 위해서 사용할 수 있습니다. "rwd"를 사용했을 경우는 파일의 내용에의 갱신만이 기억장치에 출력해집니다. "rws"를 사용했을 경우는 파일의 내용과 그 메타데이타의 양쪽 모두에 갱신을 출력해지지 않으면 안됩니다. 일반적으로 1개 이상 하위 레벨의 입출력 조작이 필요하게 됩니다.

시큐러티 매니저가 존재하는 경우, 파일에의 읽기 액세스가 허가되고 있는지를 확인하기 위해서 인수로서 file 패스명을 취하는 시큐러티 매니저의 checkRead 메서드가 호출됩니다. 출력이 허가되는 모드의 경우, 파일에의 쓰기 권한가 허가되고 있는지를 확인하기 위해서 path 인수를 취하는 시큐러티 매니저의 checkWrite 메서드도 호출합니다.

파라미터:

file - 파일 객체

mode - 액세스 모드. 전술의 설명을 참조

예외:

IllegalArgumentException - mode 인수가 "r", "rw", "rws", 또는 "rwd"가 아닌 경우

FileNotFoundException - 모드가 "r" 이지만 지정의 파일 객체가 기존의 보통 파일을 나타내지 않는 경우. 모드가 "rw"로 부터 시작되지만 지정의 파일 객체가 기존의, 출력가능한 보통 파일을 나타내지 않고, 그 이름을 가지는 보통 파일을 작성할 수 없는 경우. 또는 파일을 열고 있을 때나 작성할 때, 그 외의 에러가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkRead 메서드가 파일에의 읽기 액세스를 거부했을 경우, 혹은 모드가 "rw" 로 시큐러티 매니저의 checkWrite 메서드가 파일에의 쓰기 권한을 거부했을 경우

관련 항목:

SecurityManager.checkRead(java.lang.String), SecurityManager.checkWrite(java.lang.String), FileChannel.force(boolean)

메서드의 상세

getFD

public final FileDescriptor  getFD()
                           throws IOException 

이 스트림에 관련된 불투명한 파일 기술자를 리턴합니다.

반환값:

이 스트림에 관련된 파일 기술자 객체

예외:

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

관련 항목:

FileDescriptor

getChannel

public final FileChannel  getChannel()

이 파일에 관련된, 하나의 FileChannel 객체를 리턴합니다.

리턴된 채널의 position 는 항상, getFilePointer 메서드로부터 리턴된 이 객체의 파일 포인터 오프셋(offset)와 동일해집니다. 객체의 파일 포인터 오프셋(offset)를 명시적으로 또는 바이트의 읽고 쓰기에 의해 변경하면, 채널의 위치도 변경됩니다. 채널의 위치를 변경하면, 객체의 파일 포인터 오프셋(offset)도 변경됩니다. 이 객체의 파일의 길이를 변경하면, 파일 채널에 보관 유지되고 있는 파일의 길이도 변경됩니다. 파일 채널의 파일의 길이를 변경하면, 객체의 파일의 길이도 변경됩니다.

반환값:

이 파일과 관련된 파일 채널

도입된 버전 :

1.4

read

public int read()
         throws IOException 

이 파일로부터 1 바이트의 데이터를 읽어들입니다. 그 바이트는 0 ~ 255 (0x00-0x0ff)의 범위의 정수로서 리턴됩니다 . 이 메서드는 유효한 입력이 아직 없는 경우는 블록 합니다.

RandomAccessFile는 InputStream 서브 클래스가 아니고, 이 메서드의 동작은 InputStream InputStream.read() 메서드와 완전히 같습니다.

반환값:

데이터의 다음의 바이트. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우. 파일의 마지막에 이르렀을 경우는 Throw 되지 않는다

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException 

이 파일로부터 최대 len 바이트의 데이터를 바이트 배열에 읽어들입니다. 이 메서드는 적어도 1 바이트의 입력 데이터를 얻을 수 있게 될 때까지 블록 합니다.

RandomAccessFile는 InputStream 서브 클래스가 아니고, 이 메서드의 동작은 InputStream InputStream.read(byte[], int, int) 메서드와 완전히 같습니다.

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽히는 최대 바이트수

반환값:

버퍼에 읽힌 바이트의 합계수. 스트림의 마지막에 이르러 데이터가 없는 경우는 -1

예외:

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

read

public int read(byte[] b)
         throws IOException 

이 파일로부터 최대 b.length 바이트의 데이터를 바이트 배열에 읽어들입니다. 이 메서드는 적어도 1 바이트의 입력 데이터를 얻을 수 있게 될 때까지 블록 합니다.

RandomAccessFile는 InputStream 서브 클래스가 아니고, 이 메서드의 동작은 InputStream InputStream.read(byte[]) 메서드와 완전히 같습니다.

파라미터:

b - 데이터의 read처의 버퍼

반환값:

버퍼에 읽힌 바이트의 합계수. 스트림의 마지막에 이르러 데이터가 없는 경우는 -1

예외:

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

readFully

public final void readFully(byte[] b)
                     throws IOException 

이 파일로부터 바이트 배열에 현재의 파일 포인터 위치로부터 시작해 b.length 바이트를 읽어들입니다. 이 메서드는 요구된 바이트수가 될 때까지 파일로부터의 read를 반복합니다. 이 메서드는 요구된 바이트수를 읽어들이는지, 스트림의 마지막을 검출하는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readFully

파라미터:

b - 데이터의 read처의 버퍼

예외:

EOFException - 모든 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

readFully

public final void readFully(byte[] b,
                            int off,
                            int len)
                     throws IOException 

이 파일로부터 바이트 배열에 현재의 파일 포인터 위치로부터 시작해 len 바이트를 읽어들입니다. 이 메서드는 요구된 바이트수가 읽힐 때까지 파일로부터 반복해 읽어들입니다. 이 메서드는 요구된 바이트수를 읽어들이는지, 스트림의 마지막을 검출하는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readFully

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽어들이는 바이트수

예외:

EOFException - 모든 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

skipBytes

public int skipBytes(int n)
              throws IOException 

n 바이트의 입력을 스킵 해, 스킵 한 바이트를 파기하려고 합니다.

이 메서드는 n 보다 적은 바이트수 (제로의 경우도 있다) 밖에 스킵 하지 않는 경우도 있습니다. 이것은 몇개의 조건 가운데 1개에 해당했을 경우에 발생합니다. n 바이트분을 스킵 하기 전에 파일의 마지막에 이르러 버렸을 경우도 그 1개 입니다. 이 메서드가 EOFException을 Throw 할 것은 없습니다. 스킵 된 실제의 바이트수가 리턴됩니다 . n가 잘못된 값 의 경우, 바이트는 스킵 되지 않습니다.

정의:

인터페이스 DataInput 내의 skipBytes

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

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

write

public void write(int b)
           throws IOException 

지정된 바이트를 파일에 출력합니다. 출력은 현재의 파일 포인터 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 write

파라미터:

b - 출력해지는 byte

예외:

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

write

public void write(byte[] b)
           throws IOException 

지정된 바이트 배열로부터 이 파일에 현재의 파일 포인터 위치로부터 개시해 b.length 바이트를 출력합니다.

정의:

인터페이스 DataOutput 내의 write

파라미터:

b - 데이터

예외:

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

write

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

지정된 바이트 배열의 오프셋(offset) off로 부터 len 바이트를, 이 파일에 출력합니다.

정의:

인터페이스 DataOutput 내의 write

파라미터:

b - 데이터

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

len - 출력하는 바이트수

예외:

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

getFilePointer

public long getFilePointer()
                    throws IOException 

이 파일의 현재의 오프셋(offset)를 리턴합니다.

반환값:

파일의 선두로부터의 바이트 단위의 오프셋(offset)로 여기로부터 다음의 읽기 또는 출력이 발생한다

예외:

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

seek

public void seek(long pos)
          throws IOException 

이 파일의 선두를 시점으로서 파일 포인터의 오프셋(offset)를 설정합니다. 다음의 읽기 또는 출력은 이 정도치로부터 행해집니다. 오프셋(offset)는 파일의 마지막을 넘는 위치로 설정할 수도 있습니다. 이 설정에 의해 파일의 길이가 바뀔 것은 없습니다. 파일의 길이가 변경되는 것은 파일의 마지막을 넘는 위치에 오프셋(offset)를 설정한뒤 write를 행했을 때입니다.

파라미터:

pos - 파일의 선두를 시점으로 한, 바이트 단위의 오프셋(offset) 위치. 이 정도치에 파일 포인터가 설정된다

예외:

IOException - pos가 0 보다 작은 경우, 혹은 입출력 에러가 발생했을 경우

length

public long length()
            throws IOException 

이 파일의 길이를 리턴합니다.

반환값:

바이트 단위의, 이 파일의 길이

예외:

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

setLength

public void setLength(long newLength)
               throws IOException 

이 파일의 길이를 설정합니다.

length 메서드로 리턴된 파일의 현재의 길이가 newLength인수보다 큰 경우는 newLength를 넘는 분은 잘라 버릴 수 있습니다. 이 경우 getFilePointer 메서드로 리턴된 파일 오프셋(offset)가 newLength 보다 크면, 이 메서드가 복귀한 뒤의 오프셋(offset)는 newLength에 동일해집니다.

length 메서드로 리턴된 파일의 현재의 길이가 newLength인수보다 작은 경우는 파일이 확장됩니다. 이 경우 파일의 확장 부분의 내용은 정의되지 않습니다.

파라미터:

newLength - 파일의 필요한 길이

예외:

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

도입된 버전 :

1.2

close

public void close()
           throws IOException 

이 랜덤 액세스 파일 스트림을 종료해, 이 스트림에 관련된 모든 system resource를 해방합니다. 닫혀진 랜덤 액세스 파일은 입력 처리 또는 출력 처리를 실행할 수 없습니다. 또, 그것을 다시 열 수도 있습니다.

이 파일에 관련된 채널이 있는 경우는 그 채널도 닫습니다.

정의:

인터페이스 Closeable 내의 close

예외:

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

readBoolean

public final boolean readBoolean()
                          throws IOException 

이 파일로부터 boolean을 읽어들입니다. 이 메서드는 파일의 현재의 파일 포인터 위치로부터 시작해 1개의 바이트를 읽어들입니다. 값 0 은 false를 나타냅니다. 그 외의 값은 true를 나타냅니다. 이 메서드는 바이트를 다 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readBoolean

반환값:

읽힌 boolean값

예외:

EOFException - 이 파일의 마지막에 이르렀을 경우

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

readByte

public final byte readByte()
                    throws IOException 

이 파일로부터 부호 첨부 8 비트치를 읽어들입니다. 이 메서드는 파일의 현재의 파일 포인터 위치로부터 시작해 1 바이트를 읽어들입니다. 읽히는 바이트가 b인 경우, 0 <= b <= 255 이면, 결과는 다음과 같이 됩니다.

 (byte)(b) 

이 메서드는 바이트를 다 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readByte

반환값:

부호 첨부 8 비트 byte로 서 해석되는 이 파일의 다음의 바이트

예외:

EOFException - 이 파일의 마지막에 이르렀을 경우

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

readUnsignedByte

public final int readUnsignedByte()
                           throws IOException 

이 파일로부터 부호 없음 8 비트수를 읽어들입니다. 이 메서드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 1 바이트를 읽기, 그 바이트를 리턴합니다.

이 메서드는 바이트를 다 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readUnsignedByte

반환값:

부호 없음의 8 비트 수라고의해 해석되는 이 파일의 다음의 바이트

예외:

EOFException - 이 파일의 마지막에 이르렀을 경우

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

readShort

public final short readShort()
                      throws IOException 

부호 첨부 16 비트수를 이 파일로부터 읽어들입니다. 이 메서드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 2 바이트를 읽어들입니다. 읽힌 2 바이트가 b1와 b2 순서로 2개의 각 값이 0 ~ 255 범위내의 경우, 결과는 아래와 같게 됩니다.

 (short)((b1 <<
 8) | b2) 

이 메서드는 2 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readShort

반환값:

부호 첨부 16 비트 수라고의해 해석되는 이 파일의 다음의 2 바이트

예외:

EOFException - 2 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

readUnsignedShort

public final int readUnsignedShort()
                            throws IOException 

부호 없음 16 비트수를 이 파일로부터 읽어들입니다. 이 메서드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 2 바이트를 읽어들입니다. 읽힌 바이트가 b1와 b2 순서로0 <= b1, b2 <= 255인 경우, 결과는 아래와 같게 됩니다.

 (b1 <<
 8) | b2 

이 메서드는 2 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readUnsignedShort

반환값:

부호 없음 16 비트 정수로서 해석되는 이 파일의 다음의 2 바이트

예외:

EOFException - 2 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

readChar

public final char readChar()
                    throws IOException 

이 파일로부터 Unicode 문자를 읽어들입니다. 이 메서드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 2 바이트를 읽어들입니다. 읽힌 바이트가 b1와 b2 순서로0 <= b1, b2 <= 255인 경우, 결과는 아래와 같게 됩니다.

 (char)((b1 <<
 8) | b2) 

이 메서드는 2 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readChar

반환값:

Unicode 문자로서 해석되는 이 파일의 다음의 2 바이트

예외:

EOFException - 2 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

readInt

public final int readInt()
                  throws IOException 

이 파일로부터 부호 첨부 32 비트 정수를 읽어들입니다. 이 메서드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 4 바이트를 읽어들입니다. 읽힌 바이트가 b1, b2, b3 및 b4 순서로0 <= b1, b2, b3, b4 <= 255인 경우, 결과는 아래와 같게 됩니다.

 (b1 <<
 24) | (b2 <<
 16) + (b3 <<
 8) + b4 

이 메서드는 4 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readInt

반환값:

int로 서 해석되는 이 파일의 다음의 4 바이트

예외:

EOFException - 4 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

readLong

public final long readLong()
                    throws IOException 

이 파일로부터 부호 첨부의 64 비트 정수를 읽어들입니다. 이 메서드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 8 바이트를 읽어들입니다. 읽힌 바이트가 b1, b2, b3, b4, b5, b6, b7 및 b8 순서로 아래의 경우,

 0 <= b1, b2, b3, b4, b5, b6, b7, b8 <=255, 

결과는 아래와 같게 됩니다.

 ((long) b1 << 56) + ((long) b2 << 48) + ((long) b3 << 40) + ((long) b4 << 32) + ((long) b5 << 24) + ((long) b6 << 16) + ((long) b7 << 8) + b8 

이 메서드는 8 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readLong

반환값:

long로 서 해석되는 이 파일의 다음의 8 바이트

예외:

EOFException - 8 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

readFloat

public final float readFloat()
                      throws IOException 

이 파일로부터 float를 읽어들입니다. 이 메서드는 readInt 메서드를 사용하는 것과 같이 현재의 파일 포인터 위치로부터 시작해 int값을 읽어들이고 나서, Float 클래스의 intBitsToFloat 메서드를 사용해 그 int를 float로 변환합니다.

이 메서드는 4 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readFloat

반환값:

float로 서 해석되는 이 파일의 다음의 4 바이트

예외:

EOFException - 4 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

관련 항목:

readInt(), Float.intBitsToFloat(int)

readDouble

public final double readDouble()
                        throws IOException 

이 파일로부터 double를 읽어들입니다. 이 메서드는 readLong 메서드를 사용하는 것과 같이 현재의 파일 포인터 위치로부터 시작해 long값을 읽어들이고 나서, Double 클래스의 longBitsToDouble 메서드를 사용해 그 long를 double로 변환합니다.

이 메서드는 8 바이트를 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readDouble

반환값:

double로 서 해석되는 이 파일의 다음의 8 바이트

예외:

EOFException - 8 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

관련 항목:

readLong(), Double.longBitsToDouble(long)

readLine

public final String  readLine()
                      throws IOException 

이 파일의 다음의 텍스트행을 읽어들입니다. 이 메서드는 파일의 현재의 파일 포인터로부터 시작해 줄 끝 기호 또는 파일의 마지막에 이를 때까지, 연속적으로 바이트를 읽어들입니다. 문자의 하위 8 비트의 바이트값를 취득해, 상위 8 비트를 제로로 설정하는 것으로 각 바이트는 문자에 변환됩니다. 그 때문에 이 메서드는 Unicode 캐릭터셋를 완전하게는 지원하고 있습니다.

텍스트행은 복귀 문자 ('\r'), 개행 문자 ('\n'), 복귀 문자의 직후에 개행 문자라고 하는 조합해 또는 파일의 마지막으로 종료합니다. 줄 끝 문자는 파기되어 리턴된 캐릭터 라인의 일부에는 포함되지 않습니다.

이 메서드는 개행 문자가 읽힐 때까지, 복귀와 거기에 계속되는 바이트가 읽히는 (개행인가 어떤가를 확인한다)까지, 파일의 마지막에 이를 때까지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readLine

반환값:

이 파일로부터의 다음의 텍스트행. 파일의 마지막이 검출 될 때까지 1 바이트도 읽어들일 수 없었던 경우는 null

예외:

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

readUTF

public final String  readUTF()
                     throws IOException 

이 파일로부터 캐릭터 라인을 읽어들입니다. 캐릭터 라인은, 수정 UTF-8 형식을 사용해 encode 되고 있습니다.

readUnsignedShort를 사용했을 경우와 같이, 현재의 파일 포인터 위치로부터 시작해, 최초의 2 바이트가 읽힙니다. 이 값이 가리키는 것은 encode 된 캐릭터 라인내의 후속 바이트수입니다. 결과의 캐릭터 라인의 길이가 아닙니다. 후속 바이트는 수정 UTF-8 형식에서 encode 된 문자로서 해석되어 문자에 변환됩니다.

이 메서드는 모든 바이트를 다 읽어들이는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readUTF

반환값:

Unicode 캐릭터 라인

예외:

EOFException - 모든 바이트를 읽어들이기 전에 이 파일의 마지막에 이르렀을 경우

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

UTFDataFormatException - 바이트가 유효한 수정 UTF-8 Unicode 캐릭터 라인을 나타내지 않는 경우

관련 항목:

readUnsignedShort()

writeBoolean

public final void writeBoolean(boolean v)
                        throws IOException 

boolean을 1 바이트값으로 파일에 출력합니다. 값 true는 값 (byte) 1 으로서 출력해져 값 false는 값 (byte) 0 으로서 출력해집니다. 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeBoolean

파라미터:

v - 출력해지는 boolean 치

예외:

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

writeByte

public final void writeByte(int v)
                     throws IOException 

byte를 1 바이트값으로 파일에 출력합니다. 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeByte

파라미터:

v - 출력해지는 byte값

예외:

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

writeShort

public final void writeShort(int v)
                      throws IOException 

short를 2 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다). 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeShort

파라미터:

v - 출력해지는 short값

예외:

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

writeChar

public final void writeChar(int v)
                     throws IOException 

char를 2 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다). 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeChar

파라미터:

v - 출력해지는 char값

예외:

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

writeInt

public final void writeInt(int v)
                    throws IOException 

int를 4 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다). 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeInt

파라미터:

v - 출력해지는 int값

예외:

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

writeLong

public final void writeLong(long v)
                     throws IOException 

long를 8 바이트값으로 파일에 출력합니다 (상위 바이트로부터 먼저 출력한다). 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeLong

파라미터:

v - 출력해지는 long값

예외:

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

writeFloat

public final void writeFloat(float v)
                      throws IOException 

Float 클래스의 floatToIntBits 메서드를 사용해 float 인수를 int로 변환하고 나서, 그 int값을 4 바이트값으로 상위 바이트로부터 먼저 파일에 출력합니다. 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeFloat

파라미터:

v - 출력해지는 float 치

예외:

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

관련 항목:

Float.floatToIntBits(float)

writeDouble

public final void writeDouble(double v)
                       throws IOException 

Double 클래스의 doubleToLongBits 메서드를 사용해 double 인수를 long로 변환하고 나서, 그 long값을 8 바이트값으로 상위 바이트로부터 먼저 파일에 출력합니다. 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeDouble

파라미터:

v - 출력해지는 double 치

예외:

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

관련 항목:

Double.doubleToLongBits(double)

writeBytes

public final void writeBytes(String  s)
                      throws IOException 

캐릭터 라인을 일련의 바이트로서 파일에 출력합니다. 캐릭터 라인내의 각 문자는 상위 8 비트를 파기해 순서에 출력해집니다. 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeBytes

파라미터:

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

예외:

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

writeChars

public final void writeChars(String  s)
                      throws IOException 

캐릭터 라인을 일련의 문자로서 파일에 출력합니다. 각 문자는 writeChar 메서드와 같이의해 데이터 출력 스트림에 출력해집니다. 출력은 파일 포인터의 현재 위치로부터 개시됩니다.

정의:

인터페이스 DataOutput 내의 writeChars

파라미터:

s - 출력해지는 String 치

예외:

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

관련 항목:

writeChar(int)

writeUTF

public final void writeUTF(String  str)
                    throws IOException 

머신에 존하지 않는수정 UTF-8 인코딩을 사용해, 캐릭터 라인을 파일에 출력합니다.

우선, 후속의 바이트수를 지정하는 writeShort 메서드를 사용했을 경우와 같이, 현재의 파일 포인터 위치로부터 시작해 2 바이트가 파일에 출력해집니다. 이 값은 실제로 출력해지는 바이트수입니다. 캐릭터 라인의 길이가 아닙니다. 길이에 이어, 캐릭터 라인의 각 문자가 문자 마다 수정 UTF-8 인코딩을 사용해 순서에 출력됩니다.

정의:

인터페이스 DataOutput 내의 writeUTF

파라미터:

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

예외:

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