Класс IntBuffer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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