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

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

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

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

В противном случае, этот метод копирует length значения long из этого буфера в заданный массив, начиная с текущей позиции этого буфера и с заданного смещения в массиве. Позиция этого буфера затем увеличивается на 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 перед вызовом этого метода, чтобы убедиться, что этот буфер имеет доступный поддерживающий массив.

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

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

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

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

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

    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 при передаче данных из одного места в другое.

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

    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, а не на ноль, так что вызов этого метода может быть сразу же последует вызов другого метода относительного копирования.

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

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

Два длинных буфера равны, если и только если

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

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

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

Длинный буфер не равен никакому другому типу объекта.

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

Длинный буфер не может быть сравнен ни с каким другим типом объекта.

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

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