Класс IntBuffer

public static IntBuffer allocate(int capacity)

Выделяет новый буфер int.

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

public static IntBuffer wrap(int[] array,
                             int offset,
                             int length)

Оборачивает массив int в буфер.

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

public static IntBuffer wrap(int[] array)

Оборачивает массив int в буфер.

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

public abstract IntBuffer slice()

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

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

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

public abstract IntBuffer duplicate()

Создаёт новый буфер int, который разделяет содержимое этого буфера.

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

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

public abstract IntBuffer asReadOnlyBuffer()

Создаёт новый буфер int только для чтения, который разделяет содержимое этого буфера.

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

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

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

public abstract int get()

public abstract IntBuffer put(int i)

Метод относительного записи (необязательная операция).

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

public abstract int get(int index)

public abstract IntBuffer put(int index,
                              int i)

Метод абсолютной записи (необязательная операция).

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

public IntBuffer get(int[] dst,
                     int offset,
                     int length)

Метод относительного массового получения.

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

public IntBuffer get(int[] dst)

Метод относительного массового получения.

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

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

public IntBuffer put(IntBuffer src)

Метод относительного массового записи (необязательная операция).

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

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

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

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

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

public IntBuffer put(int[] src,
                     int offset,
                     int length)

Метод put для копирования массива значений (необязательная операция).

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

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

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

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

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

public final IntBuffer put(int[] src)

Метод put для копирования массива значений (необязательная операция).

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

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

public final boolean hasArray()

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

Если этот метод возвращает true, то методы array и arrayOffset могут быть безопасно вызваны.

public final int[] array()

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

Изменения в содержимом этого буфера приведут к изменению содержимого возвращённого массива, и наоборот.

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

public final int arrayOffset()

Возвращает смещение в поддерживающем массиве этого буфера первого элемента буфера (необязательная операция).

Если этот буфер поддерживается массивом, то позиция буфера p соответствует индексу массива p + arrayOffset().

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

public abstract IntBuffer compact()

Уплотняет этот буфер (необязательная операция).

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

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

public abstract boolean isDirect()

public String toString()

public int hashCode()

Возвращает текущий хэш-код этого буфера.

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

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

public boolean equals(Object ob)

Указывает, равен ли этот буфер другому объекту.

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

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

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

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

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

public int compareTo(IntBuffer that)

Сравнивает этот буфер с другим.

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

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

public abstract ByteOrder order()

Возвращает порядок байтов этого буфера.

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