Класс FloatBuffer

public static FloatBuffer allocate(int capacity)

Выделяет новый буфер с плавающей запятой.

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

public static FloatBuffer wrap(float[] array,
                               int offset,
                               int length)

Оборачивает массив чисел с плавающей запятой в буфер.

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

public static FloatBuffer wrap(float[] array)

Оборачивает массив чисел с плавающей запятой в буфер.

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

public abstract FloatBuffer slice()

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

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

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

public abstract FloatBuffer duplicate()

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

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

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

public abstract FloatBuffer asReadOnlyBuffer()

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

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

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

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

public abstract float get()

public abstract FloatBuffer put(float f)

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

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

public abstract float get(int index)

public abstract FloatBuffer put(int index,
                                float f)

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

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

public FloatBuffer get(float[] dst,
                       int offset,
                       int length)

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

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

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

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

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

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

public FloatBuffer get(float[] dst)

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

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

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

public FloatBuffer put(FloatBuffer src)

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

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

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

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

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

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

public FloatBuffer put(float[] src,
                       int offset,
                       int length)

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

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

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

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

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

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

public final FloatBuffer put(float[] src)

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

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

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

public final boolean hasArray()

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

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

public final float[] array()

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

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

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

public final int arrayOffset()

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

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

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

public abstract FloatBuffer compact()

Сжимает этот буфер (необязательная операция).

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

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

public abstract boolean isDirect()

public String toString()

public int hashCode()

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

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

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

public boolean equals(Object ob)

Определяет, равен ли этот буфер другому объекту.

Два буфера чисел с плавающей точкой равны тогда и только тогда, когда

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

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

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

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

public int compareTo(FloatBuffer that)

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

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

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

public abstract ByteOrder order()

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

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