Класс DoubleBuffer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Этот метод переносит length значений double из указанного исходного буфера в этот буфер, начиная с указанной 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));

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

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

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

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

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

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

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

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

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

Этот метод копирует значения double в этот буфер из указанного исходного массива. Позиция этого буфера не меняется. Вызов этого метода в форме 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

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

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

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

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

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

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

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

3. две последовательности оставшихся элементов, рассматриваемые независимо от начальных позиций, равны поэлементно. Этот метод считает два элемента double a и b равными, если (a == b) || (Double.isNaN(a) && Double.isNaN(b)). Значения -0.0 и +0.0 считаются равными, в отличие от Double.equals(Object).

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

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

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

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

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