Класс ByteBuffer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    buf.clear();          // Prepare buffer for use
    while (in.read(buf) >= 0 || buf.position != 0) {
        buf.flip();
        out.write(buf);
        buf.compact();    // In case of partial write
    }

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

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

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

1. они имеют одинаковый тип элементов;

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

3. две последовательности оставшихся элементов, рассматриваемые независимо от начальных позиций, равны поэлементно.

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

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

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

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

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

Возвращаемое значение неотрицательно и находится в диапазоне от 0 (включительно) до unitSize (не включительно); ноль означает, что адрес байта с указанным индексом выровнен по размеру единицы, а положительное значение — что адрес не выровнен. Если адрес байта с указанным индексом не выровнен, возвращаемое значение показывает, насколько нужно скорректировать индекс, чтобы найти байт по выровненному адресу. В частности, индекс следует либо уменьшить на возвращаемое значение, если оно не превышает index, либо увеличить на размер единицы за вычетом возвращаемого значения. Таким образом, для

    int value = alignmentOffset(index, unitSize)

    alignmentOffset(index - value, unitSize) == 0, value <= index

    alignmentOffset(index + (unitSize - value), unitSize) == 0

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

    nb.alignmentOffset(0, unitSize) == 0
    nb.alignmentOffset(nb.limit(), unitSize) == 0

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

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

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

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

Считывает два байта по заданному индексу и объединяет их в значение char в соответствии с текущим порядком байтов.

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

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

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

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

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

Считывает два байта по заданному индексу и объединяет их в значение short в соответствии с текущим порядком байтов.

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

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

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

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

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

Считывает четыре байта по заданному индексу и объединяет их в значение int в соответствии с текущим порядком байтов.

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

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

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

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

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

Считывает восемь байтов по заданному индексу и объединяет их в значение long в соответствии с текущим порядком байтов.

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

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

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

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

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

Считывает четыре байта по заданному индексу и объединяет их в значение float в соответствии с текущим порядком байтов.

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

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

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

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

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

Считывает восемь байтов по заданному индексу и объединяет их в значение double в соответствии с текущим порядком байтов.

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

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

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