Класс 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(), значения не переносятся и выбрасывается 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(), значения не переносятся и выбрасывается 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(), значения не переносятся и выбрасывается 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 на момент создания представления.