Класс FloatBuffer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Этот метод копирует значения float из заданного исходного массива в этот буфер. Позиция этого буфера не изменяется. Вызов этого метода в форме 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

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

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

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

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

Два буфера float равны тогда и только тогда, когда

1. они имеют один и тот же тип элементов;

2. в них осталось одинаковое число элементов;

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

Буфер float не равен объекту любого другого типа.

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

Буфер float нельзя сравнивать с объектами других типов.

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

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