Класс 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]);

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

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

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

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

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

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

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

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

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

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

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