java.io
클래스 RandomAccessFile

java.lang.Object 
  |
  +--java.io.RandomAccessFile

모든 구현 인터페이스:

DataInput , DataOutput

public class RandomAccessFile

extends Object

implements DataOutput , DataInput

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

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

도입된 버젼:

JDK1. 0

생성자의 개요

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

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

메소드의 개요

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 

지정된 이름을 가지는 파일로부터의 읽어들여, 및 옵션으로 기입을 실시하는 랜덤 억세스 파일 스트림을 작성합니다. 파일에의 접속을 나타내는 새로운 FileDescriptor 오브젝트가 생성됩니다.

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

시큐러티 매니저가 존재하는 경우, 파일에의 읽어들여 액세스가 허가되고 있는지 어떤지를 확인하기 위해서, 인수로서 name 를 취하는 시큐러티 매니저의 checkRead 메소드가 불려 갑니다. 기입이 허가되는 모드의 경우, 파일에의 기입해 액세스가 허가되고 있는지 어떤지를 확인하기 위해서, 인수로서 name 를 취하는 시큐러티 매니저의 checkWrite 메소드도 불려 갑니다.

파라미터:

name - 시스템에 의존하는 파일명

mode - 액세스모드

예외:

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

FileNotFoundException - 파일은 존재하지만 통상의 파일은 아니고 디렉토리인 경우나, 다른 이유로써 파일을 여는 것, 혹은 작성할 수가 없는 경우

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

관련 항목:

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

RandomAccessFile

public RandomAccessFile(File  file,
                        String  mode)
                 throws FileNotFoundException 

인수로 지정된 파일을 읽어들여 원으로서 또 경우에 따라서는 기입해 앞으로서 랜덤 억세스 파일 스트림을 작성합니다. 이 파일 접속을 나타내는 새로운 FileDescriptor 오브젝트가 생성됩니다.

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

/tr_

"r"	read용으로 연다. 연 오브젝트의 임의의 write 메소드를 호출하면(자),IOException 가 슬로우 된다
"rw"	read 및 기입해용으로 연다. 파일이 존재하지 않는 경우는 작성하려고 한다
"rws"	"rw" 와 같게, read 및 기입해용으로 연다. 파일의 내용 또는 메타데이타를 갱신했을 때는 바탕으로 되는 기억장치에도 동시에 적용할 필요가 있다
"rwd"	"rw" 와 같게, read 및 기입해용으로 연다. 파일의 내용을 갱신했을 때는 바탕으로 되는 기억장치에도 동시에 적용할 필요가 있다

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

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

시큐러티 매니저가 존재하는 경우, 파일에의 읽어들여 액세스가 허가되고 있는지 어떤지를 확인하기 위해서, 인수로서 file 의 패스명을 취하는 시큐러티 매니저의 checkRead 메소드가 불려 갑니다. 기입이 허가되는 모드의 경우, 파일에의 기입해 액세스가 허가되고 있는지 어떤지를 확인하기 위해서 path 인수를 취하는 시큐러티 매니저의 checkWrite 메소드도 불려 갑니다.

파라미터:

file - 파일 오브젝트

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

예외:

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

FileNotFoundException - 파일은 존재하지만 통상의 파일은 아니고 디렉토리인 경우나, 다른 이유로써 파일을 여는 것, 혹은 작성할 수가 없는 경우

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 - 입출력 에러가 발생했을 경우. 파일의 마지막에 이르렀을 경우는 슬로우 되지 않는다

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를 반복합니다. 이 메소드는 요구된 바이트수를 읽어들이는지 스트림의 마지막을 검출하는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readFully

파라미터:

b - 데이터의 read처의 버퍼

예외:

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

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

readFully

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

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

정의:

인터페이스 DataInput 내의 readFully

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽어들이는 바이트수

예외:

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

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

skipBytes

public int skipBytes(int n)
              throws IOException 

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

이 메소드는 n 보다 적은 바이트수 (제로의 경우도 있다) 밖에 스킵 하지 않는 경우도 있습니다. 이것은 몇개의 조건 가운데 1 개에 해당했을 경우에 발생합니다. n 바이트분을 스킵 하기 전에 파일의 마지막에 이르러 버렸을 경우도 그 1 kr입니다. 이 메소드가 EOFException 를 슬로우 할 것은 없습니다. 스킵 된 실제의 바이트수가 돌려주어집니다. 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)를 설정한 뒤, 기입을 행했을 때입니다.

파라미터:

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를 해방합니다. 닫혀진 랜덤 억세스 파일은 입력 처리 또는 출력 처리를 실행할 수 없습니다. 또, 그것을 다시 열 수도 있습니다.

이 파일에 관련지을 수 있고 있는 채널이 있는 경우는 그 채널도 닫습니다.

예외:

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

readBoolean

public final boolean readBoolean()
                          throws IOException 

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

정의:

인터페이스 DataInput 내의 readBoolean

반환값:

읽힌 boolean 의 값

예외:

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

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

readByte

public final byte readByte()
                    throws IOException 

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

     (byte)(b)
 

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

정의:

인터페이스 DataInput 내의 readByte

반환값:

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

예외:

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

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

readUnsignedByte

public final int readUnsignedByte()
                           throws IOException 

이 파일로부터 부호 없음 8 비트수를 읽어들입니다. 이 메소드는 이 파일의 현재의 파일 포인터 위치로부터 시작해 1 바이트를 읽어들여, 그 바이트를 돌려줍니다.

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

정의:

인터페이스 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 바이트를 읽어들이는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 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 바이트를 읽어들이는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 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 바이트를 읽어들이는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 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 바이트를 읽어들이는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 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 바이트를 읽어들이는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readLong

반환값:

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

예외:

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

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

readFloat

public final float readFloat()
                      throws IOException 

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

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

정의:

인터페이스 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 바이트를 읽어들이는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readDouble

반환값:

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

예외:

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

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

관련 항목:

readLong() , Double.longBitsToDouble(long)

readLine

public final String  readLine()
                      throws IOException 

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

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

이 메소드는 개행 캐릭터가 읽힐 때까지 복귀와 거기에 계속되는 바이트가 읽히는 (개행인가 어떤가를 확인한다)까지 파일의 마지막에 이를 때까지 또는 예외가 슬로우 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readLine

반환값:

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

예외:

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

readUTF

public final String  readUTF()
                     throws IOException 

이 파일로부터 캐릭터 라인을 읽어들입니다. 캐릭터 라인은 변경된 UTF-8 형식을 사용해 코드화 되고 있습니다.

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

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

정의:

인터페이스 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 - 입출력 에러가 발생했을 경우