Класс FloatBuffer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вызов этого метода не изменяет и не отбрасывает значение метки.

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

    buf.clear();     // Prepare buffer for reading
    in.read(buf);    // Read data

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

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

    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 при передаче данных из одного места в другое.

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

    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.

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

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

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

1. Они имеют тот же тип элементов,

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

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

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

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

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

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

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