Класс ShortBuffer

public static ShortBuffer allocate(int capacity)

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

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

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

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

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

public static ShortBuffer wrap(short[] array)

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

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

public abstract ShortBuffer slice()

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

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

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

public abstract ShortBuffer slice(int index, int length)

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

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

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

public abstract ShortBuffer duplicate()

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

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

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

public abstract ShortBuffer asReadOnlyBuffer()

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

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

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

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

public abstract short get()

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

public abstract ShortBuffer put(short s)

Относительный метод put (необязательная операция).

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

public abstract short get(int index)

Абсолютный метод get. Читает короткий целый по заданному индексу.

public abstract ShortBuffer put(int index, short s)

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

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

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

Относительный метод пакетного чтения get.

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

Метод get для относительного копирования.

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

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

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

Метод get для абсолютного копирования.

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

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

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

public ShortBuffer get(int index, short[] dst)

Метод get для абсолютного копирования.

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

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

public ShortBuffer put(ShortBuffer src)

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

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

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

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

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

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

public ShortBuffer put(int index, ShortBuffer src, int offset, int length)

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

Этот метод копирует 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));
 

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

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(src[i]);
 

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

public final ShortBuffer put(short[] src)

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

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

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

public ShortBuffer put(int index, short[] src, int offset, int length)

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

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

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

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

public ShortBuffer put(int index, short[] src)

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

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

     dst.put(index, src, 0, src.length); 

public final boolean hasArray()

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

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

public final short[] array()

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

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

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

public final int arrayOffset()

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

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

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

public final ShortBuffer position(int newPosition)

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

public final ShortBuffer limit(int newLimit)

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

public final ShortBuffer mark()

Устанавливает метку этого буфера в его позиции.

public final ShortBuffer reset()

Возвращает позицию этого буфера к ранее помеченной позиции.

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

public final ShortBuffer clear()

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

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

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

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

public final ShortBuffer flip()

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

После последовательности операций чтения из канала или операций 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 при передаче данных из одного места в другое.

public final ShortBuffer rewind()

Перематывает этот буфер. Позиция устанавливается в ноль, и метка отбрасывается.

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

 out.write(buf);    // Write remaining data
 buf.rewind();      // Rewind buffer
 buf.get(array);    // Copy data into array

public abstract ShortBuffer compact()

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

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

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

public abstract boolean isDirect()

Указывает, является ли этот буфер типа short прямым.

public String toString()

Возвращает строку, обобщающую состояние этого буфера.

public int hashCode()

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

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

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

public boolean equals(Object ob)

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

Два буфера типа short равны тогда и только тогда, когда:

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

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

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

Буфер типа short не равен никакому другому типу объекта.

public int compareTo(ShortBuffer that)

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

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

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

public int mismatch(ShortBuffer that)

Находит и возвращает относительный индекс первого несовпадения между этим буфером и заданным буфером. Индекс относится к position каждого буфера и будет находиться в диапазоне от 0 (включительно) до меньшего из remaining элементов в каждом буфере (исключительно).

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

public abstract ByteOrder order()

Получает порядок байтов этого буфера.

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