Android - An Open Handset Alliance Project

java.io.RandomAccessFile

Android - An Open Handset Alliance Project

Documentation

Roadmap

Goodies

java.io.RandomAccessFile

Summary

Details

Summary

Details

Public Constructors

Public Methods

Public Constructors

Public Methods

Public Constructors

Public Methods

Public Constructors

Public Methods

public RandomAccessFile(File file, String mode)

Parameters

Throws

public RandomAccessFile(String fileName, String mode)

Parameters

Throws

public void close()

Throws

public final synchronized FileChannel getChannel()

Returns

public final FileDescriptor getFD()

Returns

Throws

public long getFilePointer()

Returns

Throws

public long length()

Returns

Throws

public int read(byte[] buffer, int offset, int count)

Parameters

Returns

Throws

public int read()

Returns

Throws

public int read(byte[] buffer)

Parameters

Returns

Throws

public final boolean readBoolean()

Returns

Throws

public final byte readByte()

Returns

Throws

public final char readChar()

Returns

Throws

public final double readDouble()

Returns

Throws

public final float readFloat()

Returns

Throws

public final void readFully(byte[] buffer, int offset, int count)

Parameters

Throws

public final void readFully(byte[] buffer)

Parameters

Throws

public final int readInt()

Returns

Throws

public final String readLine()

Returns

Throws

public final long readLong()

Returns

Throws

public final short readShort()

Returns

Throws

public final String readUTF()

Returns

Throws

public final int readUnsignedByte()

Returns

Throws

public final int readUnsignedShort()

Returns

Throws

public void seek(long pos)

Parameters

Throws

public void setLength(long newLength)

Parameters

Throws

public int skipBytes(int count)

Parameters

Returns

Throws

public void write(byte[] buffer, int offset, int count)

Parameters

Throws

public void write(int oneByte)

Parameters

Throws

public void write(byte[] buffer)

Parameters

Throws

public final void writeBoolean(boolean val)

Parameters

Throws

public final void writeByte(int val)

Parameters

Throws

public final void writeBytes(String str)

Parameters

Throws

public final void writeChar(int val)

Parameters

Throws

public final void writeChars(String str)

Parameters

Throws

public final void writeDouble(double val)

Parameters

Throws

public final void writeFloat(float val)

Parameters

Throws

public final void writeInt(int val)

Parameters

Throws

public final void writeLong(long val)

Parameters

Throws

public final void writeShort(int val)

Parameters

Throws

public final void writeUTF(String str)

Parameters

Throws

public RandomAccessFile(File file, String mode)

Parameters

Throws

See Also

public RandomAccessFile(String fileName, String mode)

Parameters

Throws

See Also

public void close()

Throws

public final synchronized FileChannel getChannel()

Returns

public final FileDescriptor getFD()

Returns

Throws

public long getFilePointer()

Returns

Throws

public long length()

Returns

Throws

public int read(byte[] buffer, int offset, int count)

Parameters

Returns

Throws

See Also

public int read()

Returns

Throws

See Also

public int read(byte[] buffer)

Parameters

Returns

Throws

See Also

public final boolean readBoolean()

Returns

Throws

See Also

public final byte readByte()

Returns

Throws

See Also

public final char readChar()

Returns

Throws

See Also

public final double readDouble()

Returns

Throws

See Also

public final float readFloat()

Returns

Throws

See Also

public final void readFully(byte[] buffer, int offset, int count)

Parameters

Throws

See Also

public final void readFully(byte[] buffer)

Parameters

Throws

See Also

public final int readInt()

Returns

Methods inherited from class java.lang.Object

Methods inherited from interface java.io.Closeable

Methods inherited from interface java.io.DataInput

Methods inherited from interface java.io.DataOutput

Methods inherited from class java.lang.Object

Methods inherited from interface java.io.Closeable

Methods inherited from interface java.io.DataInput

Methods inherited from interface java.io.DataOutput

java.io
public class

java.lang.Object
	java.io.RandomAccessFile	Closeable DataInput DataOutput

RandomAccessFile is a class which allows positioning of the next read anywhere in the file. This is useful for reading specific locations of files or following links within a file. Most input classes only support forward skipping.

		void	close()
			Close this RandomAccessFile.
synchronized	final	FileChannel	getChannel()
			Returns the FileChannel equivalent to this stream.
	final	FileDescriptor	getFD()
			Returns the FileDescriptor representing the operating system resource for this RandomAccessFile.
		long	getFilePointer()
			Returns the current position within this RandomAccessFile.
		long	length()
			Returns the current length of this RandomAccessFile in bytes.
		int	read(byte[] buffer, int offset, int count)
			Reads at most `count` bytes from this RandomAccessFile and stores them in byte array `buffer` starting at `offset`.
		int	read()
			Reads a single byte from this RandomAccessFile and returns the result as an int.
		int	read(byte[] buffer)
			Reads bytes from this RandomAccessFile into the byte array `buffer`.
	final	boolean	readBoolean()
			Reads a boolean from this stream.
	final	byte	readByte()
			Reads an 8-bit byte value from this stream.
	final	char	readChar()
			Reads a 16-bit character value from this stream.
	final	double	readDouble()
			Reads a 64-bit `double` value from this stream.
	final	float	readFloat()
			Reads a 32-bit `float` value from this stream.
	final	void	readFully(byte[] buffer, int offset, int count)
			Read bytes from this stream and stores them in byte array `buffer` starting at offset `offset`.
	final	void	readFully(byte[] buffer)
			Reads bytes from this stream into the byte array `buffer`.
	final	int	readInt()
			Reads a 32-bit integer value from this stream.
	final	String	readLine()
			Returns a `String` representing the next line of text available in this BufferedReader.
	final	long	readLong()
			Reads a 64-bit `long` value from this stream.
	final	short	readShort()
			Reads a 16-bit `short` value from this stream.
	final	String	readUTF()
			Reads a UTF format String from this Stream.
	final	int	readUnsignedByte()
			Reads an unsigned 8-bit `byte` value from this stream and returns it as an int.
	final	int	readUnsignedShort()
			Reads a 16-bit unsigned `short` value from this stream and returns it as an int.
		void	seek(long pos)
			Seeks to the position `pos` in this RandomAccessFile.
		void	setLength(long newLength)
			Set the length of this file to be `newLength`.
		int	skipBytes(int count)
			Skips `count` number of bytes in this stream.
		void	write(byte[] buffer, int offset, int count)
			Writes `count` bytes from the byte array `buffer` starting at `offset` to this RandomAccessFile starting at the current file pointer..
		void	write(int oneByte)
			Writes the specified byte `oneByte` to this RandomAccessFile starting at the current file pointer.
		void	write(byte[] buffer)
			Writes the entire contents of the byte array `buffer` to this RandomAccessFile starting at the current file pointer.
	final	void	writeBoolean(boolean val)
			Writes a boolean to this output stream.
	final	void	writeByte(int val)
			Writes a 8-bit byte to this output stream.
	final	void	writeBytes(String str)
			Writes the low order 8-bit bytes from a String to this output stream.
	final	void	writeChar(int val)
			Writes the specified 16-bit character to the OutputStream.
	final	void	writeChars(String str)
			Writes the specified 16-bit characters contained in str to the OutputStream.
	final	void	writeDouble(double val)
			Writes a 64-bit double to this output stream.
	final	void	writeFloat(float val)
			Writes a 32-bit float to this output stream.
	final	void	writeInt(int val)
			Writes a 32-bit int to this output stream.
	final	void	writeLong(long val)
			Writes a 64-bit long to this output stream.
	final	void	writeShort(int val)
			Writes the specified 16-bit short to the OutputStream.
	final	void	writeUTF(String str)
			Writes the specified String out in UTF format.

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

	Object	clone()
		Returns a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class<? extends Object>	getClass()
		Returns the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Returns an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Returns a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

readBoolean, readByte, readChar, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readUTF, readUnsignedByte, readUnsignedShort, skipBytes

					boolean	readBoolean()
						Reads a boolean from this stream.
					byte	readByte()
						Reads an 8-bit byte value from this stream.
					char	readChar()
						Reads a 16-bit character value from this stream.
					double	readDouble()
						Reads a 64-bit `double` value from this stream.
					float	readFloat()
						Reads a 32-bit `float` value from this stream.
					void	readFully(byte[] buffer, int offset, int count)
						Read bytes from this stream and stores them in byte array `buffer` starting at offset `offset`.
					void	readFully(byte[] buffer)
						Reads bytes from this stream into the byte array `buffer`.
					int	readInt()
						Reads a 32-bit integer value from this stream.
					String	readLine()
						Returns a `String` representing the next line of text available in this BufferedReader.
					long	readLong()
						Reads a 64-bit `long` value from this stream.
					short	readShort()
						Reads a 16-bit `short` value from this stream.
					String	readUTF()
						Reads a UTF format String from this Stream.
					int	readUnsignedByte()
						Reads an unsigned 8-bit `byte` value from this stream and returns it as an int.
					int	readUnsignedShort()
						Reads a 16-bit unsigned `short` value from this stream and returns it as an int.
					int	skipBytes(int count)
						Skips `count` number of bytes in this stream.

write, write, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeDouble, writeFloat, writeInt, writeLong, writeShort, writeUTF

					void	write(int oneByte)
						Writes the specified `byte` to the OutputStream.
					void	write(byte[] buffer)
						Writes the entire contents of the byte array `buffer` to the OutputStream.
					void	write(byte[] buffer, int offset, int count)
						Writes `count` `bytes` from the byte array `buffer` starting at offset `index` to the OutputStream.
					void	writeBoolean(boolean val)
						Writes a boolean to this output stream.
					void	writeByte(int val)
						Writes a 8-bit byte to this output stream.
					void	writeBytes(String str)
						Writes the low order 8-bit bytes from a String to this output stream.
					void	writeChar(int oneByte)
						Writes the specified 16-bit character to the OutputStream.
					void	writeChars(String str)
						Writes the specified 16-bit characters contained in str to the OutputStream.
					void	writeDouble(double val)
						Writes a 64-bit double to this output stream.
					void	writeFloat(float val)
						Writes a 32-bit float to this output stream.
					void	writeInt(int val)
						Writes a 32-bit int to this output stream.
					void	writeLong(long val)
						Writes a 64-bit long to this output stream.
					void	writeShort(int val)
						Writes the specified 16-bit short to the OutputStream.
					void	writeUTF(String str)
						Writes the specified String out in UTF format.

Constructs a new RandomAccessFile on the File file and opens it according to the access String in mode. The access mode may be one of "r" for read access only, or "rw" for read/write access.

file	the File to open.
mode	"r" for read only, or "rw" for read/write.

FileNotFoundException	If the `mode` is incorrect or the File cannot be opened in the requested `mode`.

Constructs a new RandomAccessFile on the file named fileName and opens it according to the access String in mode. The file may be absolute or relative to the System property "user.dir". The access mode may be one of "r" for read access only, or "rw" for read/write access.

fileName	the filename of the file to open.
mode	"r" for read only, or "rw" for read/write.

FileNotFoundException	If the `mode` is incorrect or the file cannot be opened in the requested `mode`.

Close this RandomAccessFile.

IOException	If an error occurs attempting to close this RandomAccessFile.

Returns the FileChannel equivalent to this stream.

The file channel is write-only and has an initial position within the file that is the same as the current position of this FileOutputStream within the file. All changes made to the underlying file descriptor state via the channel are visible by the output stream and vice versa.

the file channel representation for this FileOutputStream.

Returns the FileDescriptor representing the operating system resource for this RandomAccessFile.

the FileDescriptor for this RandomAccessFile.

IOException	If an error occurs attempting to get the FileDescriptor of this RandomAccessFile.

Returns the current position within this RandomAccessFile. All reads and writes take place at the current file pointer position.

the current file pointer position.

IOException	If an error occurs attempting to get the file pointer position of this RandomAccessFile.

Returns the current length of this RandomAccessFile in bytes.

the current file length in bytes.

IOException	If an error occurs attempting to get the file length of this RandomAccessFile.

Reads at most count bytes from this RandomAccessFile and stores them in byte array buffer starting at offset. Answer the number of bytes actually read or -1 if no bytes were read and end of file was encountered.

buffer	the byte array in which to store the read bytes.
offset	the offset in `buffer` to store the read bytes.
count	the maximum number of bytes to store in `buffer`.

the number of bytes actually read or -1 if end of file.

IOException	If an error occurs attempting to read from this RandomAccessFile.

Reads a single byte from this RandomAccessFile and returns the result as an int. The low-order byte is returned or -1 of the end of file was encountered.

the byte read or -1 if end of file.

IOException	If an error occurs attempting to read from this RandomAccessFile.

Reads bytes from this RandomAccessFile into the byte array buffer. The number of bytes actually read is returned.

buffer	the buffer to read bytes into

the number of bytes actually read or -1 if end of file.

IOException	If an error occurs attempting to read from this RandomAccessFile.

Reads a boolean from this stream.

boolean the next boolean value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads an 8-bit byte value from this stream.

byte the next byte value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads a 16-bit character value from this stream.

char the next char value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads a 64-bit double value from this stream.

double the next double value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads a 32-bit float value from this stream.

float the next float value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Read bytes from this stream and stores them in byte array buffer starting at offset offset. This method blocks until count number of bytes have been read.

buffer	the byte array in which to store the read bytes.
offset	the offset in `buffer` to store the read bytes.
count	the maximum number of bytes to store in `buffer`.

IOException	If a problem occurs reading from this DataInputStream.

Reads bytes from this stream into the byte array buffer. This method will block until buffer.length number of bytes have been read.

buffer	the buffer to read bytes into

IOException	If a problem occurs reading from this DataInputStream.

Reads a 32-bit integer value from this stream.

int the next int value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Returns a String representing the next line of text available in this BufferedReader. A line is represented by 0 or more characters followed by '\n', '\r', "\n\r" or end of stream. The String does not include the newline sequence.

String the contents of the line or null if no characters were read before end of stream.

IOException	If the BufferedReader is already closed or some other IO error occurs.

Reads a 64-bit long value from this stream.

long the next long value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads a 16-bit short value from this stream.

short the next short value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads a UTF format String from this Stream.

String the next UTF String from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads an unsigned 8-bit byte value from this stream and returns it as an int.

int the next unsigned byte value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Reads a 16-bit unsigned short value from this stream and returns it as an int.

int the next unsigned short value from the source stream.

IOException	If a problem occurs reading from this DataInputStream.

Seeks to the position pos in this RandomAccessFile. All read/write/skip methods sent will be relative to pos.

pos	the desired file pointer position

IOException	If the stream is already closed or another IOException occurs.

Set the length of this file to be newLength. If the current file is smaller, it will be expanded and the filePosition will be set to the new file length. If the newLength is smaller then the file will be truncated.

newLength	the desired file length

IOException	If the stream is already closed or another IOException occurs.

Skips count number of bytes in this stream. Subsequent read()'s will not return these bytes unless reset() is used.

count	the number of bytes to skip.

the number of bytes actually skipped.

IOException	If the stream is already closed or another IOException occurs.

Writes count bytes from the byte array buffer starting at offset to this RandomAccessFile starting at the current file pointer..

buffer	the bytes to be written
offset	offset in buffer to get bytes
count	number of bytes in buffer to write

IOException	If an error occurs attempting to write to this RandomAccessFile.
IndexOutOfBoundsException	If offset or count are outside of bounds.

Writes the specified byte oneByte to this RandomAccessFile starting at the current file pointer. Only the low order byte of oneByte is written.

oneByte	the byte to be written

IOException	If an error occurs attempting to write to this RandomAccessFile.

Writes the entire contents of the byte array buffer to this RandomAccessFile starting at the current file pointer.

buffer	the buffer to be written.

IOException	If an error occurs trying to write to this RandomAccessFile.

Writes a boolean to this output stream.

val	the boolean value to write to the OutputStream

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes a 8-bit byte to this output stream.

val	the byte value to write to the OutputStream

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes the low order 8-bit bytes from a String to this output stream.

str	the String containing the bytes to write to the OutputStream

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes the specified 16-bit character to the OutputStream. Only the lower 2 bytes are written with the higher of the 2 bytes written first. This represents the Unicode value of val.

val	the character to be written

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes the specified 16-bit characters contained in str to the OutputStream. Only the lower 2 bytes of each character are written with the higher of the 2 bytes written first. This represents the Unicode value of each character in str.

str	the String whose characters are to be written.

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes a 64-bit double to this output stream. The resulting output is the 8 bytes resulting from calling Double.doubleToLongBits().

val	the double to be written.

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes a 32-bit float to this output stream. The resulting output is the 4 bytes resulting from calling Float.floatToIntBits().

val	the float to be written.

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes a 32-bit int to this output stream. The resulting output is the 4 bytes, highest order first, of val.

val	the int to be written.

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes a 64-bit long to this output stream. The resulting output is the 8 bytes, highest order first, of val.

val	the long to be written.

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes the specified 16-bit short to the OutputStream. Only the lower 2 bytes are written with the higher of the 2 bytes written first.

val	the short to be written

IOException	If an error occurs attempting to write to this DataOutputStream.

Writes the specified String out in UTF format.

str	the String to be written in UTF format.

IOException	If an error occurs attempting to write to this DataOutputStream.

					void	close()
						Close the object and release any system resources it holds.


e.g. "intent" or "activity"

RandomAccessFile(File file, String mode)

Constructs a new RandomAccessFile on the File file and opens it according to the access String in mode.

RandomAccessFile(String fileName, String mode)

Constructs a new RandomAccessFile on the file named fileName and opens it according to the access String in mode.