Класс ShortBuffer

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

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

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

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

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

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

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

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

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

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

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

Если этот буфер сам по себе является только для чтения, то этот метод работает точно так же, как метод 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]);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Короткий буфер не сравним ни с каким другим типом объекта.

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

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