Класс 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

Возвращает:

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

Исключения:

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

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

public final int readUnsignedByte() throws IOException

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

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

Возвращает:

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

Исключения:

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 — если возникает ошибка ввода-вывода.