Класс RandomAccessFile

public RandomAccessFile(String pathname, String mode) throws FileNotFoundException

Параметры:

pathname - строка с путем, зависящим от системы

mode - режим доступа

Исключения:

IllegalArgumentException - если аргумент режима не равен ни одному из значений "r", "rw", "rws" или "rwd"

FileNotFoundException - если режим — "r", но заданная строка пути не указывает на существующий обычный файл, или если режим начинается с "rw", но заданная строка пути не указывает на существующий доступный для записи обычный файл и невозможно создать новый обычный файл по этому пути, или если при открытии либо создании файла возникает другая ошибка

public RandomAccessFile(File file, String mode) throws FileNotFoundException

Параметры:

file - объект файла

mode - режим доступа, описанный выше

Исключения:

IllegalArgumentException - если аргумент режима не равен ни одному из значений "r", "rw", "rws" или "rwd"

FileNotFoundException - если режим — "r", но заданный объект файла не указывает на существующий обычный файл, или если режим начинается с "rw", но заданный объект файла не указывает на существующий доступный для записи обычный файл и невозможно создать новый обычный файл по этому пути, или если при открытии либо создании файла возникает другая ошибка

См. также:

• FileChannel.force(boolean)

public final FileDescriptor getFD() throws IOException

Возвращает:

объект файлового дескриптора, связанный с этим потоком.

Исключения:

IOException - если произошла ошибка ввода-вывода.

См. также:

• FileDescriptor

public final FileChannel getChannel()

Возвращает:

файловый канал, связанный с этим файлом

Начиная с версии:

1.4

public int read() throws IOException

Возвращает:

следующий байт данных или -1, если достигнут конец файла.

Исключения:

IOException - если произошла ошибка ввода-вывода. Не выбрасывается при достижении конца файла.

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

Параметры:

b - буфер, в который считываются данные.

off - начальное смещение в массиве b, начиная с которого записываются данные.

len - максимальное количество считываемых байтов.

Возвращает:

общее количество байтов, считанных в буфер, или -1, если данных больше нет, поскольку достигнут конец файла.

Исключения:

IOException - если первый байт не удалось считать по любой причине, кроме конца файла, если файл с произвольным доступом был закрыт или если произошла другая ошибка ввода-вывода.

NullPointerException - если b имеет значение null.

IndexOutOfBoundsException - если off отрицательно, len отрицательно или len больше b.length - off

public int read(byte[] b) throws IOException

Параметры:

b - буфер, в который считываются данные.

Возвращает:

общее количество байтов, считанных в буфер, или -1, если данных больше нет, поскольку достигнут конец файла.

Исключения:

IOException - если первый байт не удалось считать по любой причине, кроме конца файла, если файл с произвольным доступом был закрыт или если произошла другая ошибка ввода-вывода.

NullPointerException - если b имеет значение null.

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

Определено в:

readFully в интерфейсе DataInput

Параметры:

b - буфер, в который считываются данные.

Исключения:

NullPointerException - если b имеет значение null.

EOFException - если этот файл достигает конца до того, как будут прочитаны все байты.

IOException - если произошла ошибка ввода-вывода.

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

Определено в:

readFully в интерфейсе DataInput

Параметры:

b - буфер, в который считываются данные.

off - начальное смещение в массиве данных b.

len - количество байтов для чтения.

Исключения:

NullPointerException - если b имеет значение null.

IndexOutOfBoundsException - если off отрицательно, len отрицательно или len больше b.length - off.

EOFException - если этот файл достигает конца до того, как будут прочитаны все байты.

IOException - если произошла ошибка ввода-вывода.

public int skipBytes(int n) throws IOException

Определено в:

skipBytes в интерфейсе DataInput

Параметры:

n - количество байтов, которые нужно пропустить.

Возвращает:

фактическое количество пропущенных байтов.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public void write(int b) throws IOException

Определено в:

write в интерфейсе DataOutput

Параметры:

b - записываемый byte.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public void write(byte[] b) throws IOException

Определено в:

write в интерфейсе DataOutput

Параметры:

b - данные.

Исключения:

IOException - если произошла ошибка ввода-вывода.

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

Определено в:

write в интерфейсе DataOutput

Параметры:

b - данные.

off - начальное смещение в данных.

len - количество байтов для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

IndexOutOfBoundsException - если off отрицательно, len отрицательно или len больше b.length - off

public long getFilePointer() throws IOException

Возвращает:

смещение в байтах от начала файла, с которого будет выполнена следующая операция чтения или записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public void seek(long pos) throws IOException

Параметры:

pos - позиция смещения в байтах от начала файла, в которую следует установить указатель файла.

Исключения:

IOException - если pos меньше 0 или произошла ошибка ввода-вывода.

public long length() throws IOException

Возвращает:

длину этого файла в байтах.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public void setLength(long newLength) throws IOException

Параметры:

newLength - требуемая длина файла

Исключения:

IOException - если аргумент отрицателен или произошла другая ошибка ввода-вывода

Начиная с версии:

1.2

public void close() throws IOException

Определено в:

close в интерфейсе AutoCloseable

Определено в:

close в интерфейсе Closeable

Примечание к API:

Если с этим потоком связан канал, данный метод закроет канал, который, в свою очередь, закроет этот поток. Подклассы, переопределяющие этот метод, должны быть готовы обработать возможный повторный вход в метод.

Исключения:

IOException - если произошла ошибка ввода-вывода.

public final boolean readBoolean() throws IOException

Определено в:

readBoolean в интерфейсе DataInput

Возвращает:

считанное значение boolean.

Исключения:

EOFException - если достигнут конец файла.

IOException - если произошла ошибка ввода-вывода.

public final byte readByte() throws IOException

    (byte)(b)

Определено в:

readByte в интерфейсе DataInput

Возвращает:

следующий байт этого файла как знаковое 8-битное значение byte.

Исключения:

EOFException - если достигнут конец файла.

IOException - если произошла ошибка ввода-вывода.

public final int readUnsignedByte() throws IOException

Определено в:

readUnsignedByte в интерфейсе DataInput

Возвращает:

следующий байт этого файла, интерпретированный как беззнаковое 8-битное число.

Исключения:

EOFException - если достигнут конец файла.

IOException - если произошла ошибка ввода-вывода.

public final short readShort() throws IOException

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

Определено в:

readShort в интерфейсе DataInput

Возвращает:

следующие два байта этого файла, интерпретированные как знаковое 16-битное число.

Исключения:

EOFException - если файл достигает конца до считывания двух байтов.

IOException - если произошла ошибка ввода-вывода.

public final int readUnsignedShort() throws IOException

    (b1 << 8) | b2

Определено в:

readUnsignedShort в интерфейсе DataInput

Возвращает:

следующие два байта этого файла, интерпретированные как беззнаковое 16-битное целое число.

Исключения:

EOFException - если файл достигает конца до считывания двух байтов.

IOException - если произошла ошибка ввода-вывода.

public final char readChar() throws IOException

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

Определено в:

readChar в интерфейсе DataInput

Возвращает:

следующие два байта этого файла, интерпретированные как char.

Исключения:

EOFException - если файл достигает конца до считывания двух байтов.

IOException - если произошла ошибка ввода-вывода.

public final int readInt() throws IOException

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

Определено в:

readInt в интерфейсе DataInput

Возвращает:

следующие четыре байта этого файла, интерпретированные как int.

Исключения:

EOFException - если файл достигает конца до считывания четырех байтов.

IOException - если произошла ошибка ввода-вывода.

public final long readLong() throws IOException

    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

Определено в:

readLong в интерфейсе DataInput

Возвращает:

следующие восемь байтов этого файла, интерпретированные как long.

Исключения:

EOFException - если файл достигает конца до считывания восьми байтов.

IOException - если произошла ошибка ввода-вывода.

public final float readFloat() throws IOException

Определено в:

readFloat в интерфейсе DataInput

Возвращает:

следующие четыре байта этого файла, интерпретированные как float.

Исключения:

EOFException - если файл достигает конца до считывания четырех байтов.

IOException - если произошла ошибка ввода-вывода.

См. также:

• readInt()
• Float.intBitsToFloat(int)

public final double readDouble() throws IOException

Определено в:

readDouble в интерфейсе DataInput

Возвращает:

следующие восемь байтов этого файла, интерпретированные как double.

Исключения:

EOFException - если файл достигает конца до считывания восьми байтов.

IOException - если произошла ошибка ввода-вывода.

См. также:

• readLong()
• Double.longBitsToDouble(long)

public final String readLine() throws IOException

Определено в:

readLine в интерфейсе DataInput

Возвращает:

следующую строку текста из этого файла или null, если достигнут конец файла до считывания хотя бы одного байта.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final String readUTF() throws IOException

Определено в:

readUTF в интерфейсе DataInput

Возвращает:

строку Unicode.

Выбрасывает:

EOFException — если этот файл достигает конца до считывания всех байтов.

IOException — если произошла ошибка ввода-вывода.

UTFDataFormatException — если байты не представляют допустимую строку Unicode в кодировке модифицированного UTF-8.

См. также:

• readUnsignedShort()

public final void writeBoolean(boolean v) throws IOException

Определено в:

writeBoolean в интерфейсе DataOutput

Параметры:

v — значение boolean для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeByte(int v) throws IOException

Определено в:

writeByte в интерфейсе DataOutput

Параметры:

v — значение byte для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeShort(int v) throws IOException

Определено в:

writeShort в интерфейсе DataOutput

Параметры:

v — значение short для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeChar(int v) throws IOException

Определено в:

writeChar в интерфейсе DataOutput

Параметры:

v — значение char для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeInt(int v) throws IOException

Определено в:

writeInt в интерфейсе DataOutput

Параметры:

v — значение int для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeLong(long v) throws IOException

Определено в:

writeLong в интерфейсе DataOutput

Параметры:

v — значение long для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeFloat(float v) throws IOException

Определено в:

writeFloat в интерфейсе DataOutput

Параметры:

v — значение float для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

См. также:

• Float.floatToIntBits(float)

public final void writeDouble(double v) throws IOException

Определено в:

writeDouble в интерфейсе DataOutput

Параметры:

v — значение double для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

См. также:

• Double.doubleToLongBits(double)

public final void writeBytes(String s) throws IOException

Определено в:

writeBytes в интерфейсе DataOutput

Параметры:

s — строка байтов для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

public final void writeChars(String s) throws IOException

Определено в:

writeChars в интерфейсе DataOutput

Параметры:

s — значение String для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.

См. также:

• writeChar(int)

public final void writeUTF(String str) throws IOException

Определено в:

writeUTF в интерфейсе DataOutput

Параметры:

str — строка для записи.

Выбрасывает:

IOException — если произошла ошибка ввода-вывода.