RandomAccessFile (Платформа Java SE 8 b92)

java.lang. Объект
- java.io. RandomAccessFile

Все Реализованные Интерфейсы:

Closeable, DataInput, DataOutput, AutoCloseable
```
public class RandomAccessFile
extends Object
implements DataOutput, DataInput, Closeable
```
Экземпляры этого class поддерживают и чтение и запись в файл произвольного доступа. Файл произвольного доступа ведет себя как многочисленный массив байтов, сохраненных в файловой системе. Есть своего рода курсор, или индексируйте в подразумеваемый массив, названный указателем файла; входные байты чтения операций, запускающиеся в указателе файла и усовершенствовании указатель файла мимо байтов, читают. Если файл произвольного доступа создается в режиме чтения-записи, то выведенные операции также доступны; выходные операции пишут байты, запускающиеся в указателе файла, и совершенствуют указатель файла мимо записанных байтов. Выходные операции, которые пишут мимо текущего конца подразумеваемого массива, заставляют массив быть расширенным. Указатель файла может быть считан getFilePointer метод и набор seek метод.
Это обычно верно для всех подпрограмм чтения в этом class, что, если конец файла достигается прежде, чем требуемое число байтов было считано, EOFException (который является своего рода IOException) бросается. Если какой-либо байт не может быть считан ни по какой причине кроме конца файла, IOException кроме EOFException бросается. В частности IOException может быть брошен, если поток был закрыт.

С тех пор:

JDK1.0

Сводка конструктора

Конструкторы
Конструктор и Описание
`RandomAccessFile(File file, String mode)` Создает поток файла произвольного доступа, чтобы читать из, и дополнительно записать в, файл, определенный `File` параметр.
`RandomAccessFile(String name, String mode)` Создает поток файла произвольного доступа, чтобы читать из, и дополнительно записать в, файл с указанным именем.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`close()` Завершения этот поток файла произвольного доступа и выпуски любые системные ресурсы связались с потоком.
`FileChannel`	`getChannel()` Возвращает уникальное `FileChannel` объект связался с этим файлом.
`FileDescriptor`	`getFD()` Возвращает непрозрачный объект дескриптора файла, связанный с этим потоком.
`long`	`getFilePointer()` Возвращает текущее смещение в этом файле.
`long`	`length()` Возвращает длину этого файла.
`int`	`read()` Читает байт данных от этого файла.
`int`	`read(byte[] b)` Чтения до `b.length` байты данных от этого файла в массив байтов.
`int`	`read(byte[] b, int off, int len)` Чтения до `len` байты данных от этого файла в массив байтов.
`boolean`	`readBoolean()` Чтения a `boolean` от этого файла.
`byte`	`readByte()` Читает подписанное восьмиразрядное значение из этого файла.
`char`	`readChar()` Читает символ из этого файла.
`double`	`readDouble()` Чтения a `double` от этого файла.
`float`	`readFloat()` Чтения a `float` от этого файла.
`void`	`readFully(byte[] b)` Чтения `b.length` байты от этого файла в байтовый массив, запускающийся в текущем указателе файла.
`void`	`readFully(byte[] b, int off, int len)` Чтения точно `len` байты от этого файла в байтовый массив, запускающийся в текущем указателе файла.
`int`	`readInt()` Читает подписанное 32-разрядное целое число из этого файла.
`Строка`	`readLine()` Читает следующую строку текста от этого файла.
`long`	`readLong()` Читает подписанное 64-разрядное целое число из этого файла.
`short`	`readShort()` Читает подписанное 16-разрядное число из этого файла.
`int`	`readUnsignedByte()` Читает восьмиразрядное число без знака из этого файла.
`int`	`readUnsignedShort()` Читает 16-разрядное число без знака из этого файла.
`Строка`	`readUTF()` Чтения в строке от этого файла.
`void`	`seek(long pos)` Устанавливает смещение указателя файла, измеренное с начала этого файла, в котором происходят следующее чтение или запись.
`void`	`setLength(long newLength)` Устанавливает длину этого файла.
`int`	`skipBytes(int n)` Попытки перескочить `n` байты ввода, отбрасывающего пропущенные байты.
`void`	`write(byte[] b)` Записи `b.length` байты от указанного байтового массива до этого файла, запускающегося в текущем указателе файла.
`void`	`write(byte[] b, int off, int len)` Записи `len` байты от указанного байтового массива, запускающегося при смещении `off` к этому файлу.
`void`	`write(int b)` Пишет указанный байт в этот файл.
`void`	`writeBoolean(boolean v)` Записи a `boolean` к файлу как однобайтовое значение.
`void`	`writeByte(int v)` Записи a `byte` к файлу как однобайтовое значение.
`void`	`writeBytes(String s)` Пишет строка в файл как последовательность байтов.
`void`	`writeChar(int v)` Записи a `char` к файлу как двухбайтовое значение, высокий байт сначала.
`void`	`writeChars(String s)` Пишет строка в файл как последовательность символов.
`void`	`writeDouble(double v)` Преобразовывает двойной параметр a `long` использование `doubleToLongBits` метод в class `Double`, и затем записи это `long` оцените файлу как восьмибайтовое количество, высокий байт сначала.
`void`	`writeFloat(float v)` Преобразовывает аргумент с плавающей запятой в `int` использование `floatToIntBits` метод в class `Float`, и затем записи это `int` оцените файлу как четырехбайтовое количество, высокий байт сначала.
`void`	`writeInt(int v)` Записи `int` к файлу как четыре байта, высокий байт сначала.
`void`	`writeLong(long v)` Записи a `long` к файлу как восемь байтов, высокий байт сначала.
`void`	`writeShort(int v)` Записи a `short` к файлу как два байта, высокий байт сначала.
`void`	`writeUTF(String str)` Пишет строка в использование файла измененный UTF-8, кодирующий машинно-независимым способом.

Методы, наследованные от class java.lang. Объект
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).
Если есть менеджер безопасности, checkRead метод вызывают с name параметр как его параметр, чтобы видеть, позволяется ли доступ для чтения к файлу. Если режим позволяет писать, менеджер безопасности checkWrite метод также вызывают с name параметр как его параметр, чтобы видеть, позволяется ли доступ для записи к файлу.

Параметры:

name - системно-зависимое имя файла

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

Броски:

IllegalArgumentException - если параметр режима не равен одному из "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" Открытый для того, чтобы читать только. Вызов любого из методов write получающегося объекта вызовет IOException быть брошенным.

"rw" Открытый для чтения и записи. Если файл не будет уже существовать тогда, то попытка будет предпринята, чтобы создать его.

"rws" Открытый для чтения и записи, как с "rw", и также требуют, чтобы каждое обновление к контенту файла или метаданным было записано синхронно базовому устройству хранения.

"rwd" Открытый для чтения и записи, как с "rw", и также требуют, чтобы каждое обновление к контенту файла было записано синхронно базовому устройству хранения.

Значение	Значение
`"r"`	Открытый для того, чтобы читать только. Вызов любого из методов `write` получающегося объекта вызовет `IOException` быть брошенным.
`"rw"`	Открытый для чтения и записи. Если файл не будет уже существовать тогда, то попытка будет предпринята, чтобы создать его.
`"rws"`	Открытый для чтения и записи, как с `"rw"`, и также требуют, чтобы каждое обновление к контенту файла или метаданным было записано синхронно базовому устройству хранения.
`"rwd"`	Открытый для чтения и записи, как с `"rw"`, и также требуют, чтобы каждое обновление к контенту файла было записано синхронно базовому устройству хранения.

"rws" и режимы "rwd" работают очень как force(boolean) метод FileChannel class, передавая параметры true и false, соответственно, за исключением того, что они всегда применяются к каждой работе ввода-вывода и поэтому часто более эффективны. Если файл находится на локальном устройстве хранения тогда, когда вызов метода этого class возвраты, гарантируется, что все изменения, произведенные в файле тем вызовом, будут записаны тому устройству. Это полезно для обеспечения, что критическая информация не теряется в случае системного катастрофического отказа. Если файл не находится на локальном устройстве тогда, никакая такая гарантия не делается.

Режим "rwd" может использоваться, чтобы сократить количество выполняемых операций ввода-вывода. Используя "rwd" только требует, чтобы обновления к контенту файла были записаны хранению; использование "rws" требует, чтобы обновления и к контенту файла и к его метаданным были записаны, который обычно требует, по крайней мере, еще одной низкоуровневой работы ввода-вывода.

Если есть менеджер безопасности, checkRead метод вызывают с путем file параметр как его параметр, чтобы видеть, позволяется ли доступ для чтения к файлу. Если режим позволяет писать, менеджер безопасности checkWrite метод также вызывают с параметром пути, чтобы видеть, позволяется ли доступ для записи к файлу.

Параметры:: file - объект файла; mode - режим доступа, как описано выше
Броски:: IllegalArgumentException - если параметр режима не равен одному из "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 метод. Изменение смещения указателя файла этого объекта, или явно или читая или при записи байтов, изменит позицию канала, и наоборот. Изменение длины файла через этот объект изменит длину, замеченную через канал файла, и наоборот.
  
  Возвраты:
  
  канал файла связался с этим файлом
  
  С тех пор:
  
  1.4
- читать
```
public int read()
         throws IOException
```
  Читает байт данных от этого файла. Байт возвращается как целое число в диапазоне от 0 до 255 (0x00-0x0ff). Этот метод блокирует, если никакой ввод еще не доступен.
  Хотя RandomAccessFile не подкласс InputStream, этот метод ведет себя точно таким же образом как InputStream.read() метод InputStream.
  
  Возвраты:
  
  следующий байт данных, или -1 если конец файла был достигнут.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит. Не брошенный, если конец файла был достигнут.
- читать
```
public int read(byte[] b,
                int off,
                int len)
         throws IOException
```
  Чтения до len байты данных от этого файла в массив байтов. Этот метод блоки по крайней мере до одного байта ввода доступен.
  Хотя RandomAccessFile не подкласс InputStream, этот метод ведет себя точно таким же образом как InputStream.read(byte[], int, int) метод InputStream.
  
  Параметры:
  
  b - буфер, в который читаются данные.
  
  off - запуск смещается в массиве b в котором пишутся данные.
  
  len - максимальное количество байтов читало.
  
  Возвраты:
  
  общее количество чтения байтов в буфер, или -1 если нет больше данных, потому что конец файла был достигнут.
  
  Броски:
  
  IOException - Если первый байт не может быть считан ни по какой причине кроме конца файла, или если файл произвольного доступа был закрыт, или если некоторая другая ошибка ввода-вывода происходит.
  
  NullPointerException - Если b null.
  
  IndexOutOfBoundsException - Если off отрицательно, len отрицательно, или len больше чем b.length - off
- читать
```
public int read(byte[] b)
         throws IOException
```
  Чтения до b.length байты данных от этого файла в массив байтов. Этот метод блоки по крайней мере до одного байта ввода доступен.
  Хотя RandomAccessFile не подкласс InputStream, этот метод ведет себя точно таким же образом как InputStream.read(byte[]) метод InputStream.
  
  Параметры:
  
  b - буфер, в который читаются данные.
  
  Возвраты:
  
  общее количество чтения байтов в буфер, или -1 если нет больше данных, потому что конец этого файла был достигнут.
  
  Броски:
  
  IOException - Если первый байт не может быть считан ни по какой причине кроме конца файла, или если файл произвольного доступа был закрыт, или если некоторая другая ошибка ввода-вывода происходит.
  
  NullPointerException - Если b null.
- readFully
```
public final void readFully(byte[] b)
                     throws IOException
```
  Чтения b.length байты от этого файла в байтовый массив, запускающийся в текущем указателе файла. Этот метод неоднократно читает из файла, пока требуемое число байтов не читается. Этот метод блоки до требуемого числа байтов читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readFully в интерфейсе DataInput
  
  Параметры:
  
  b - буфер, в который читаются данные.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать все байты.
  
  IOException - если ошибка ввода-вывода происходит.
- readFully
```
public final void readFully(byte[] b,
                            int off,
                            int len)
                     throws IOException
```
  Чтения точно len байты от этого файла в байтовый массив, запускающийся в текущем указателе файла. Этот метод неоднократно читает из файла, пока требуемое число байтов не читается. Этот метод блоки до требуемого числа байтов читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readFully в интерфейсе DataInput
  
  Параметры:
  
  b - буфер, в который читаются данные.
  
  off - смещение запуска данных.
  
  len - число байтов, чтобы читать.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать все байты.
  
  IOException - если ошибка ввода-вывода происходит.
- skipBytes
```
public int skipBytes(int n)
              throws IOException
```
  Попытки перескочить n байты ввода, отбрасывающего пропущенные байты.
  Этот метод может перескочить через некоторое меньшее число байтов, возможно обнулить. Это может следовать из любого из многих условий; достижение конца файла прежде n байты были пропущены, только одна возможность. Этот метод никогда не бросает EOFException. Фактическое число пропущенных байтов возвращается. Если n отрицательно, никакие байты не пропускаются.
  
  Определенный:
  
  skipBytes в интерфейсе DataInput
  
  Параметры:
  
  n - число байтов, которые будут пропущены.
  
  Возвраты:
  
  фактическое число байтов пропускается.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- записать
```
public void write(int b)
           throws IOException
```
  Пишет указанный байт в этот файл. Запись запускается в текущем указателе файла.
  
  Определенный:
  
  write в интерфейсе DataOutput
  
  Параметры:
  
  b - byte быть записанным.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- записать
```
public void write(byte[] b)
           throws IOException
```
  Записи b.length байты от указанного байтового массива до этого файла, запускающегося в текущем указателе файла.
  
  Определенный:
  
  write в интерфейсе DataOutput
  
  Параметры:
  
  b - данные.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- записать
```
public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
```
  Записи len байты от указанного байтового массива, запускающегося при смещении off к этому файлу.
  
  Определенный:
  
  write в интерфейсе DataOutput
  
  Параметры:
  
  b - данные.
  
  off - запуск смещается в данных.
  
  len - число байтов, чтобы записать.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- getFilePointer
```
public long getFilePointer()
                    throws IOException
```
  Возвращает текущее смещение в этом файле.
  
  Возвраты:
  
  смещение с начала файла, в байтах, в которых происходят следующее чтение или запись.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- искать
```
public void seek(long pos)
          throws IOException
```
  Устанавливает смещение указателя файла, измеренное с начала этого файла, в котором происходят следующее чтение или запись. Смещение может быть установлено вне конца файла. Установка смещения вне конца файла не изменяет длину файла. Длина файла изменится только при записи после того, как смещение было установлено вне конца файла.
  
  Параметры:
  
  pos - позиция смещения, измеренная в байтах с начала файла, в котором можно установить указатель файла.
  
  Броски:
  
  IOException - если pos меньше чем 0 или если ошибка ввода-вывода происходит.
- длина
```
public long length()
            throws IOException
```
  Возвращает длину этого файла.
  
  Возвраты:
  
  длина этого файла, измеренного в байтах.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- setLength
```
public void setLength(long newLength)
               throws IOException
```
  Устанавливает длину этого файла.
  Если существующая длина файла как возвращено length метод больше чем newLength параметр тогда файл будет усеченным. В этом случае, если файловое смещение как возвращено getFilePointer метод больше чем newLength тогда после того, как этот метод возвращается, смещение будет равно newLength.
  Если существующая длина файла как возвращено length метод меньше чем newLength параметр тогда файл будет расширен. В этом случае содержание расширенной части файла не определяется.
  
  Параметры:
  
  newLength - Требуемая длина файла
  
  Броски:
  
  IOException - Если ошибка ввода-вывода происходит
  
  С тех пор:
  
  1.2
- близко
```
public void close()
           throws IOException
```
  Завершения этот поток файла произвольного доступа и выпуски любые системные ресурсы связались с потоком. Закрытый файл произвольного доступа не может выполнить операции ввода или вывода и не может быть вновь открыт.
  Если у этого файла есть связанный канал тогда, канал закрывается также.
  
  Определенный:
  
  close в интерфейсе Closeable
  
  Определенный:
  
  close в интерфейсе AutoCloseable
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- readBoolean
```
public final boolean readBoolean()
                          throws IOException
```
  Чтения a boolean от этого файла. Этот метод читает единственный байт из файла, запускающегося в текущем указателе файла. Значение 0 представляет false. Любое другое значение представляет true. Этот метод блоки до байта читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readBoolean в интерфейсе DataInput
  
  Возвраты:
  
  boolean значение читало.
  
  Броски:
  
  EOFException - если этот файл достиг конца.
  
  IOException - если ошибка ввода-вывода происходит.
- readByte
```
public final byte readByte()
                    throws IOException
```
  Читает подписанное восьмиразрядное значение из этого файла. Этот метод читает байт из файла, запускающегося с текущего указателя файла. Если побайтовое чтение b, где 0 <= b <= 255, тогда результат:
```
     (byte)(b)
 
```
  Этот метод блоки до байта читается, конец потока обнаруживается, или исключение выдается.
  Определенный:
  
  readByte в интерфейсе DataInput
  
  Возвраты:
  
  следующий байт этого файла как подписанное восьмиразрядное byte.
  
  Броски:
  
  EOFException - если этот файл достиг конца.
  
  IOException - если ошибка ввода-вывода происходит.
- readUnsignedByte
```
public final int readUnsignedByte()
                           throws IOException
```
  Читает восьмиразрядное число без знака из этого файла. Этот метод читает байт из этого файла, запускающегося в текущем указателе файла, и возвратах тот байт.
  Этот метод блоки до байта читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readUnsignedByte в интерфейсе DataInput
  
  Возвраты:
  
  следующий байт этого файла, интерпретируемого как восьмиразрядное число без знака.
  
  Броски:
  
  EOFException - если этот файл достиг конца.
  
  IOException - если ошибка ввода-вывода происходит.
- readShort
```
public final short readShort()
                      throws IOException
```
  Читает подписанное 16-разрядное число из этого файла. Метод читает два байта из этого файла, запускающегося в текущем указателе файла. Если двухбайтовое чтение, в порядке, b1 и b2, где каждое из двух значений между 0 и 255, включительно, тогда результат равен:
```
     (short)((b1 << 8) | b2)
 
```
  Этот метод блоки до двух байтов читается, конец потока обнаруживается, или исключение выдается.
  Определенный:
  
  readShort в интерфейсе DataInput
  
  Возвраты:
  
  следующие два байта этого файла, интерпретируемого как подписанное 16-разрядное число.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать два байта.
  
  IOException - если ошибка ввода-вывода происходит.
- readUnsignedShort
```
public final int readUnsignedShort()
                            throws IOException
```
  Читает 16-разрядное число без знака из этого файла. Этот метод читает два байта из файла, запускающегося в текущем указателе файла. Если считанные байты, в порядке, b1 и b2, где 0 <= b1, b2 <= 255, тогда результат равен:
```
     (b1 << 8) | b2
 
```
  Этот метод блоки до двух байтов читается, конец потока обнаруживается, или исключение выдается.
  Определенный:
  
  readUnsignedShort в интерфейсе DataInput
  
  Возвраты:
  
  следующие два байта этого файла, интерпретируемого как 16-разрядное целое число без знака.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать два байта.
  
  IOException - если ошибка ввода-вывода происходит.
- readChar
```
public final char readChar()
                    throws IOException
```
  Читает символ из этого файла. Этот метод читает два байта из файла, запускающегося в текущем указателе файла. Если считанные байты, в порядке, b1 и b2, где 0 <= b1, b2 <= 255, тогда результат равен:
```
     (char)((b1 << 8) | b2)
 
```
  Этот метод блоки до двух байтов читается, конец потока обнаруживается, или исключение выдается.
  Определенный:
  
  readChar в интерфейсе DataInput
  
  Возвраты:
  
  следующие два байта этого файла, интерпретируемого как a char.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать два байта.
  
  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
 
```
  Этот метод блоки до четырех байтов читается, конец потока обнаруживается, или исключение выдается.
  Определенный:
  
  readInt в интерфейсе DataInput
  
  Возвраты:
  
  следующие четыре байта этого файла, интерпретируемого как int.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать четыре байта.
  
  IOException - если ошибка ввода-вывода происходит.
- readLong
```
public final long readLong()
                    throws IOException
```
  Читает подписанное 64-разрядное целое число из этого файла. Этот метод читает восемь байтов из файла, запускающегося в текущем указателе файла. Если считанные байты, в порядке, 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
 
```
  Этот метод блоки до восьми байтов читается, конец потока обнаруживается, или исключение выдается.
  Определенный:
  
  readLong в интерфейсе DataInput
  
  Возвраты:
  
  следующие восемь байтов этого файла, интерпретируемого как a long.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать восемь байтов.
  
  IOException - если ошибка ввода-вывода происходит.
- readFloat
```
public final float readFloat()
                      throws IOException
```
  Чтения a float от этого файла. Этот метод читает int значение, запускающееся в текущем указателе файла, как будто readInt метод и затем преобразовывает это int к a float использование intBitsToFloat метод в class Float.
  Этот метод блоки до четырех байтов читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readFloat в интерфейсе DataInput
  
  Возвраты:
  
  следующие четыре байта этого файла, интерпретируемого как a float.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать четыре байта.
  
  IOException - если ошибка ввода-вывода происходит.
  
  См. Также:
  
  readInt(), Float.intBitsToFloat(int)
- readDouble
```
public final double readDouble()
                        throws IOException
```
  Чтения a double от этого файла. Этот метод читает a long значение, запускающееся в текущем указателе файла, как будто readLong метод и затем преобразовывает это long к a double использование longBitsToDouble метод в class Double.
  Этот метод блоки до восьми байтов читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readDouble в интерфейсе DataInput
  
  Возвраты:
  
  следующие восемь байтов этого файла, интерпретируемого как a double.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать восемь байтов.
  
  IOException - если ошибка ввода-вывода происходит.
  
  См. Также:
  
  readLong(), Double.longBitsToDouble(long)
- readLine
```
public final String readLine()
                      throws IOException
```
  Читает следующую строку текста от этого файла. Этот метод последовательно читает байты из файла, запускающегося в текущем указателе файла, пока это не достигает разделителя строки или конца файла. Каждый байт преобразовывается в символ, принимая значение байта для более низких восьми битов символа и устанавливая высокие восемь битов символа, чтобы обнулить. Этот метод, поэтому, не поддерживает полный набор символов Unicode.
  Строка текста завершается символом возврата каретки ('\r'), символ новой строки ('\n'), символ возврата каретки, сразу сопровождаемый символом новой строки, или концом файла. Оконечные знаки строки отбрасываются и не включаются как часть возвращенной строки.
  Этот метод блоки до символа новой строки читается, возврат каретки и байт после него читаются (чтобы видеть, является ли это новая строка), конец файла достигается, или исключение выдается.
  
  Определенный:
  
  readLine в интерфейсе DataInput
  
  Возвраты:
  
  следующая строка текста от этого файла, или нуль, если с концом файла встречаются прежде даже один байт, читается.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- readUTF
```
public final String readUTF()
                     throws IOException
```
  Чтения в строке от этого файла. Строка была закодирована, используя измененный формат UTF-8.
  Первые два байта читаются, запускаясь с текущего указателя файла, как будто readUnsignedShort. Это значение дает число следующих байтов, которые находятся в закодированной строке, не длине получающейся строки. Следующие байты тогда интерпретируются, поскольку байты, кодирующие символы в измененном UTF-8, форматируют и преобразовываются в символы.
  Этот метод блоки до всех байтов читается, конец потока обнаруживается, или исключение выдается.
  
  Определенный:
  
  readUTF в интерфейсе DataInput
  
  Возвраты:
  
  строка Unicode.
  
  Броски:
  
  EOFException - если этот файл достигает конца прежде, чем считать все байты.
  
  IOException - если ошибка ввода-вывода происходит.
  
  UTFDataFormatException - если байты не представляют допустимый, изменил кодирование UTF-8 строки Unicode.
  
  См. Также:
  
  readUnsignedShort()
- writeBoolean
```
public final void writeBoolean(boolean v)
                        throws IOException
```
  Записи a boolean к файлу как однобайтовое значение. Значение true выписывается как значение (byte)1; значение false выписывается как значение (byte)0. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeBoolean в интерфейсе DataOutput
  
  Параметры:
  
  v - a boolean значение, которое будет записано.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeByte
```
public final void writeByte(int v)
                     throws IOException
```
  Записи a byte к файлу как однобайтовое значение. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeByte в интерфейсе DataOutput
  
  Параметры:
  
  v - a byte значение, которое будет записано.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeShort
```
public final void writeShort(int v)
                      throws IOException
```
  Записи a short к файлу как два байта, высокий байт сначала. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeShort в интерфейсе DataOutput
  
  Параметры:
  
  v - a short быть записанным.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeChar
```
public final void writeChar(int v)
                     throws IOException
```
  Записи a char к файлу как двухбайтовое значение, высокий байт сначала. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeChar в интерфейсе DataOutput
  
  Параметры:
  
  v - a char значение, которое будет записано.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeInt
```
public final void writeInt(int v)
                    throws IOException
```
  Записи int к файлу как четыре байта, высокий байт сначала. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeInt в интерфейсе DataOutput
  
  Параметры:
  
  v - int быть записанным.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeLong
```
public final void writeLong(long v)
                     throws IOException
```
  Записи a long к файлу как восемь байтов, высокий байт сначала. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeLong в интерфейсе DataOutput
  
  Параметры:
  
  v - a long быть записанным.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeFloat
```
public final void writeFloat(float v)
                      throws IOException
```
  Преобразовывает аргумент с плавающей запятой в int использование floatToIntBits метод в class Float, и затем записи это int оцените файлу как четырехбайтовое количество, высокий байт сначала. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeFloat в интерфейсе DataOutput
  
  Параметры:
  
  v - a float значение, которое будет записано.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
  
  См. Также:
  
  Float.floatToIntBits(float)
- writeDouble
```
public final void writeDouble(double v)
                       throws IOException
```
  Преобразовывает двойной параметр a long использование doubleToLongBits метод в class Double, и затем записи это long оцените файлу как восьмибайтовое количество, высокий байт сначала. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeDouble в интерфейсе DataOutput
  
  Параметры:
  
  v - a double значение, которое будет записано.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
  
  См. Также:
  
  Double.doubleToLongBits(double)
- writeBytes
```
public final void writeBytes(String s)
                      throws IOException
```
  Пишет строка в файл как последовательность байтов. Каждый символ в строке выписывается, в последовательности, отбрасывая ее высокие восемь битов. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeBytes в интерфейсе DataOutput
  
  Параметры:
  
  s - строка байтов, которые будут записаны.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
- writeChars
```
public final void writeChars(String s)
                      throws IOException
```
  Пишет строка в файл как последовательность символов. Каждый символ пишется потоку вывода данных как будто writeChar метод. Запись запускается в текущей позиции указателя файла.
  
  Определенный:
  
  writeChars в интерфейсе DataOutput
  
  Параметры:
  
  s - a String значение, которое будет записано.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.
  
  См. Также:
  
  writeChar(int)
- writeUTF
```
public final void writeUTF(String str)
                    throws IOException
```
  Пишет строка в использование файла измененный UTF-8, кодирующий машинно-независимым способом.
  Во-первых, два байта пишутся файлу, запускающемуся в текущем указателе файла, как будто writeShort метод, дающий число байтов, чтобы следовать. Это значение является числом байтов, фактически выписанных, не длина строки. После длины каждый символ строки выводится, в последовательности, используя измененный UTF-8, кодирующий для каждого символа.
  
  Определенный:
  
  writeUTF в интерфейсе DataOutput
  
  Параметры:
  
  str - строка, которая будет записана.
  
  Броски:
  
  IOException - если ошибка ввода-вывода происходит.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс RandomAccessFile

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь конструктора

RandomAccessFile

RandomAccessFile

Деталь метода

getFD

getChannel

читать

читать

читать

readFully

readFully

skipBytes

записать

записать

записать

getFilePointer

искать

длина

setLength

близко

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readLong

readFloat

readDouble

readLine

readUTF

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF