Класс LongBuffer

public static LongBuffer allocate(int capacity)

Выделяет новый буфер long.

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

public static LongBuffer wrap(long[] array,
                              int offset,
                              int length)

Оборачивает массив long в буфер.

Новый буфер будет опираться на заданный массив long; другими словами, изменения в буфере приведут к изменениям в массиве и наоборот. Емкость нового буфера будет array.length, его позиция — offset, его предел — offset + length, а его метка — неопределённая. Его backing array будет заданным массивом, а его array offset — нулём.

public static LongBuffer wrap(long[] array)

Оборачивает массив long в буфер.

Новый буфер будет опираться на заданный массив long; другими словами, изменения в буфере приведут к изменениям в массиве и наоборот. Емкость и предел нового буфера будут array.length, его позиция — нулём, а его метка — неопределённой. Его backing array будет заданным массивом, а его array offset> — нулём.

public abstract LongBuffer slice()

Создаёт новый буфер long, чьё содержимое — совместная подпоследовательность содержимого этого буфера.

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

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

public abstract LongBuffer duplicate()

Создаёт новый буфер long, который разделяет содержимое этого буфера.

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

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

public abstract LongBuffer asReadOnlyBuffer()

Создаёт новый, только для чтения буфер long, который разделяет содержимое этого буфера.

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

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

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

public abstract long get()

public abstract LongBuffer put(long l)

Относительный метод put (необязательная операция).

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

public abstract long get(int index)

public abstract LongBuffer put(int index,
                               long l)

Абсолютный метод put (необязательная операция).

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

public LongBuffer get(long[] dst,
                      int offset,
                      int length)

Относительный метод массового получения get.

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

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

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

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

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

public LongBuffer get(long[] dst)

Относительный метод массового получения get.

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

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

public LongBuffer put(LongBuffer src)

Относительный метод массовой записи put (необязательная операция).

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

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

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

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

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

public LongBuffer put(long[] src,
                      int offset,
                      int length)

Метод put для блочного копирования (необязательная операция).

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

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

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

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

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

public final LongBuffer put(long[] src)

Метод put для блочного копирования (необязательная операция).

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

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

public final boolean hasArray()

Указывает, поддерживается ли этот буфер массивом значений типа long, доступным для чтения/записи.

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

public final long[] array()

Возвращает массив значений типа long, поддерживающий этот буфер (необязательная операция).

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

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

public final int arrayOffset()

Возвращает смещение в поддерживающем массив этого буфера первого элемента буфера (необязательная операция).

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

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

public abstract LongBuffer compact()

Компактирует этот буфер (необязательная операция).

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

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

public abstract boolean isDirect()

public String toString()

public int hashCode()

Возвращает текущий код хэширования этого буфера.

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

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

public boolean equals(Object ob)

Указывает, равен ли этот буфер другому объекту.

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

1. У них одинаковый тип элементов,

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

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

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

public int compareTo(LongBuffer that)

Сравнивает этот буфер с другим.

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

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

public abstract ByteOrder order()

Возвращает порядок байтов этого буфера.

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