Класс DoubleBuffer

public static DoubleBuffer allocate(int capacity)

Выделяет новый буфер double.

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

public static DoubleBuffer wrap(double[] array,
                                int offset,
                                int length)

Оборачивает массив double в буфер.

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

public static DoubleBuffer wrap(double[] array)

Оборачивает массив double в буфер.

Новый буфер будет поддерживаться заданным массивом double; то есть, изменения в буфере приведут к изменению массива и наоборот. Емкость и предел нового буфера будут array.length, его позиция будет нулевой, а его метка будет неопределённой. Его backing array будет заданным массивом, а его array offset> будет равен нулю.

public abstract DoubleBuffer slice()

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

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

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

public abstract DoubleBuffer duplicate()

Создаёт новый буфер double, который разделяет содержимое этого буфера.

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

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

public abstract DoubleBuffer asReadOnlyBuffer()

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

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

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

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

public abstract double get()

public abstract DoubleBuffer put(double d)

Относительный метод put (необязательная операция).

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

public abstract double get(int index)

public abstract DoubleBuffer put(int index,
                                 double d)

Абсолютный метод put (необязательная операция).

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

public DoubleBuffer get(double[] dst,
                        int offset,
                        int length)

Относительный метод get для обработки нескольких значений.

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

public DoubleBuffer get(double[] dst)

Относительный метод get для обработки нескольких значений.

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

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

public DoubleBuffer put(DoubleBuffer src)

Относительный метод put для обработки нескольких значений (необязательная операция).

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

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

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

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

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

public DoubleBuffer put(double[] src,
                        int offset,
                        int length)

Метод put для пакетной обработки относительных данных (дополнительная операция).

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

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

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

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

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

public final DoubleBuffer put(double[] src)

Метод put для пакетной обработки относительных данных (дополнительная операция).

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

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

public final boolean hasArray()

Указывает, поддерживается ли этот буфер доступным массивом значений double.

Если этот метод возвращает true, то методы array и arrayOffset могут быть безопасно вызваны.

public final double[] array()

Возвращает массив значений double, поддерживающий этот буфер (дополнительная операция).

Изменения в содержимом этого буфера приведут к изменению содержимого возвращаемого массива и наоборот.

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

public final int arrayOffset()

Возвращает смещение в поддерживающем массиве этого буфера первого элемента буфера (дополнительная операция).

Если этот буфер поддерживается массивом, то позиция буфера p соответствует индексу массива p + arrayOffset().

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

public abstract DoubleBuffer compact()

Уплотняет этот буфер (дополнительная операция).

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

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

public abstract boolean isDirect()

public String toString()

public int hashCode()

Возвращает текущий код хэша этого буфера.

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

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

public boolean equals(Object ob)

Указывает, равен ли этот буфер другому объекту.

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

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

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

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

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

public int compareTo(DoubleBuffer that)

Сравнивает этот буфер с другим.

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

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

public abstract ByteOrder order()

Извлекает порядок байтов этого буфера.

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