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