Класс 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 в этот буфер по заданному индексу.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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