Класс LongBuffer

Позиция нового буфера будет равна нулю, его предел будет равен его емкости, метка будет неопределенной, каждый его элемент будет инициализирован нулём, а порядок байтов будет равен native order базового оборудования. Он будет иметь backing array, а его array offset будет равен нулю.

Новый буфер будет поддерживаться заданным массивом длинных целых чисел; то есть изменения в буфере приведут к изменению массива и наоборот. Емкость нового буфера будет равна array.length, его позиция будет равна offset, его предел будет равен offset + length, его метка будет неопределенной, а порядок байтов будет равен native order базового оборудования. Его backing array будет заданным массивом, а его array offset будет равен нулю.

Новый буфер будет поддерживаться заданным массивом длинных целых чисел; то есть изменения в буфере приведут к изменению массива и наоборот. Емкость и предел нового буфера будут равны array.length, его позиция будет равна нулю, его метка будет неопределенной, а порядок байтов будет равен native order базового оборудования. Его backing array будет заданным массивом, а его array offset будет равен нулю.

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

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

Содержимое нового буфера начнется с позиции index в этом буфере и будет содержать length элементов. Изменения в содержимом этого буфера будут видны в новом буфере, и наоборот; значения позиции, предела и метки двух буферов будут независимы.

Позиция нового буфера будет равна нулю, его емкость и предел будут равны length, его метка будет неопределённой, а порядок байтов будет идентичен порядку байтов этого буфера. Новый буфер будет прямым, если и только если этот буфер является прямым, и он будет только для чтения, если и только если этот буфер является только для чтения.

Содержимое нового буфера будет таким же, как содержимое этого буфера. Изменения в содержимом этого буфера будут видны в новом буфере, и наоборот; значения позиции, предела и метки двух буферов будут независимы.

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

Содержимое нового буфера будет таким же, как содержимое этого буфера. Изменения в содержимом этого буфера будут видны в новом буфере; однако сам новый буфер будет только для чтения и не позволит изменять общее содержимое. Значения позиции, предела и метки двух буферов будут независимы.

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

Если этот буфер сам по себе является только для чтения, то этот метод работает точно так же, как метод duplicate.

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

Записывает заданное длинное целое число в этот буфер по заданному индексу.

Этот метод копирует длинные целые числа из этого буфера в заданный массив назначения. Если в буфере осталось меньше длинных целых чисел, чем требуется для удовлетворения запроса, то есть, если length > remaining(), то длинные целые числа не копируются, и выбрасывается исключение BufferUnderflowException.

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

Другими словами, вызов этого метода в форме src.get(dst, off, len) имеет точно такой же эффект, как цикл

    for (int i = off; i < off + len; i++)
        dst[i] = src.get();

Этот метод переносит значения типа long из этого буфера в заданный массив. Вызов этого метода в виде src.get(a) ведет себя точно так же, как вызов

    src.get(a, 0, a.length)

Этот метод переносит length значений типа long из этого буфера в заданный массив, начиная с указанного индекса в буфере и с указанного смещения в массиве. Позиция этого буфера не изменяется.

Вызов этого метода в виде src.get(index, dst, offset, length) имеет точно такой же эффект, как следующий цикл, за исключением того, что он сначала проверяет согласованность переданных параметров и потенциально может быть значительно эффективнее:

    for (int i = offset, j = index; i < offset + length; i++, j++)
        dst[i] = src.get(j);

Этот метод переносит значения типа long из этого буфера в заданный массив назначения. Позиция буфера не меняется. Вызов метода в виде src.get(index, dst) ведет себя точно так же, как вызов:

    src.get(index, dst, 0, dst.length)

Этот метод копирует оставшиеся значения типа long из заданного буфера в этот буфер. Если оставшихся значений типа long в исходном буфере больше, чем в этом буфере, т.е., если src.remaining() > remaining(), то значения не копируются, и выбрасывается исключение BufferOverflowException.

В противном случае этот метод копирует n = src.remaining() значений типа long из заданного буфера в этот буфер, начиная с текущей позиции каждого буфера. Позиции обоих буферов затем увеличиваются на n.

Другими словами, вызов этого метода в форме dst.put(src) имеет точно такой же эффект, как цикл

    while (src.hasRemaining())
        dst.put(src.get());

Этот метод переносит length значений типа long в этот буфер из заданного исходного буфера, начиная с указанного offset в исходном буфере и указанного index в этом буфере. Позиции обоих буферов не изменяются.

Другими словами, вызов этого метода в виде dst.put(index, src, offset, length) имеет точно такой же эффект, как цикл

    for (int i = offset, j = index; i < offset + length; i++, j++)
        dst.put(j, src.get(i));

Этот метод переносит значения типа long в этот буфер из заданного массива. Если значений типа long для копирования из массива больше, чем осталось в этом буфере, т. е., если length > remaining(), то значения не копируются, и выбрасывается исключение BufferOverflowException.

В противном случае этот метод копирует length значений типа long из заданного массива в этот буфер, начиная с указанного смещения в массиве и с текущей позиции этого буфера. Позиция этого буфера затем увеличивается на length.

Другими словами, вызов этого метода в форме dst.put(src, off, len) имеет точно такой же эффект, как цикл

    for (int i = off; i < off + len; i++)
        dst.put(src[i]);

Этот метод переносит все содержимое заданного исходного массива long в этот буфер. Вызов метода в виде dst.put(a) ведет себя точно так же, как вызов

    dst.put(a, 0, a.length)

Этот метод переносит length значений типа long из заданного массива, начиная с указанного смещения в массиве и указанного индекса в этом буфере. Позиция этого буфера не изменяется.

Вызов метода в форме dst.put(index, src, offset, length) имеет точно такой же эффект, как следующий цикл, за исключением того, что он сначала проверяет согласованность переданных параметров и потенциально может быть значительно эффективнее:

    for (int i = offset, j = index; i < offset + length; i++, j++)
        dst.put(j, src[i]);

Этот метод копирует long-значения из заданного исходного массива в этот буфер. Положение этого буфера не изменяется. Вызов этого метода в формате dst.put(index, src) ведет себя точно так же, как вызов:

    dst.put(index, src, 0, src.length);

Если этот метод возвращает true, то методы array и arrayOffset могут быть безопасно вызваны.

Изменения в содержимом этого буфера приведут к изменению содержимого возвращаемого массива, и наоборот.

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

Если этот буфер поддерживается массивом, то позиция буфера p соответствует индексу массива p + arrayOffset().

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

Вызов этого метода не изменяет и не отбрасывает значение метки.

Вызовите этот метод перед использованием последовательности операций чтения канала или put для заполнения этого буфера. Например:

    buf.clear();     // Prepare buffer for reading
    in.read(buf);    // Read data

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

После последовательности операций чтения канала или put, вызовите этот метод, чтобы подготовиться к последовательности операций записи канала или относительных операций get. Например:

    buf.put(magic);    // Prepend header
    in.read(buf);      // Read data into rest of buffer
    buf.flip();        // Flip buffer
    out.write(buf);    // Write header + data to channel

Этот метод часто используется вместе с методом compact при передаче данных из одного места в другое.

Вызовите этот метод перед последовательностью операций записи канала или get, предполагая, что предел уже установлен соответствующим образом. Например:

    out.write(buf);    // Write remaining data
    buf.rewind();      // Rewind buffer
    buf.get(array);    // Copy data into array

Long-значения между текущей позицией буфера и его пределом, если таковые имеются, копируются в начало буфера. То есть, long с индексом p = position() копируется в индекс ноль, long с индексом p + 1 копируется в индекс один и так далее, пока long с индексом limit() - 1 не будет скопирован в индекс n = limit() - 1 - p. Позиция буфера затем устанавливается в n+1, а его предел устанавливается на его емкость. Метка, если определена, отбрасывается.

Позиция буфера устанавливается на количество скопированных long-значений, а не на ноль, так что за вызовом этого метода может сразу последовать вызов другого метода относительного put.

Хэш-код буфера long зависит только от его оставшихся элементов; то есть от элементов с position() до включительно элемента с limit() - 1.

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

Два буфера long равны тогда и только тогда, когда:

1. У них один и тот же тип элементов,

2. У них одинаковое количество оставшихся элементов, и

3. Две последовательности оставшихся элементов, рассматриваемые независимо от их начальных положений, точечно равны.

Буфер long не равен ни одному другому типу объекта.

Два буфера long сравниваются путём лексикографического сравнения последовательностей оставшихся элементов, не учитывая начальную позицию каждой последовательности в соответствующем буфере. Пары long элементов сравниваются так, как если бы вызывался метод Long.compare(long,long).

Буфер long нельзя сравнивать ни с каким другим типом объекта.

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

Порядок байтов буфера long, созданного путём выделения памяти или обёртки существующего long массива, является native order базового оборудования. Порядок байтов буфера long, созданного в виде представления буфера байтов, соответствует порядку байтов буфера байтов в момент создания представления.