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

Хэш-код буфера с плавающей точкой зависит только от его оставшихся элементов; то есть, от элементов с 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.compare(double,double), за исключением того, что -0.0 и 0.0 считаются равными. Double.NaN считается в этом методе равным самому себе и больше всех остальных значений double (включая Double.POSITIVE_INFINITY).

Буфер с плавающей точкой не сравнивается ни с каким другим типом объекта.

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

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