Класс ShortBuffer

public static ShortBuffer allocate(int capacity)

Выделяет новый буфер коротких целых чисел.

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

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

Оборачивает массив коротких целых чисел в буфер.

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

public static ShortBuffer wrap(short[] array)

Оборачивает массив коротких целых чисел в буфер.

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

public abstract ShortBuffer slice()

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

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

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

public abstract ShortBuffer duplicate()

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

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

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

public abstract ShortBuffer asReadOnlyBuffer()

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

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

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

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

public abstract short get()

public abstract ShortBuffer put(short s)

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

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

public abstract short get(int index)

public abstract ShortBuffer put(int index,
                                short s)

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

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

public ShortBuffer get(short[] dst,
                       int offset,
                       int length)

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

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

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

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

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

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

public ShortBuffer get(short[] dst)

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

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

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

public ShortBuffer put(ShortBuffer src)

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

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

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

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

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

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

public ShortBuffer put(short[] 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 ShortBuffer put(short[] src)

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

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

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

public final boolean hasArray()

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

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

public final short[] array()

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

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

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

public final int arrayOffset()

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

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

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

public abstract ShortBuffer 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(ShortBuffer that)

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

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

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

public abstract ByteOrder order()

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

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