Класс CharBuffer

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

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

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

Содержимое нового, только для чтения буфера будет содержимым данной последовательности символов. Емкость буфера будет csq.length(), его позиция будет start, его предел будет end, а его метка будет неопределённой.

Содержимое нового, только для чтения буфера будет содержимым данной последовательности символов. Емкость и предел нового буфера будут csq.length(), его позиция будет равна нулю, а его метка будет неопределённой.

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

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

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

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

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

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

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

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

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

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

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

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

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

В противном случае этот метод копирует n = end - start символов из заданной строки в этот буфер, начиная с заданного индекса start и текущей позиции этого буфера. Позиция этого буфера затем увеличивается на n.

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

    for (int i = start; i < end; i++)
        dst.put(src.charAt(i));

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

    dst.put(s, 0, s.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. Две последовательности оставшихся элементов, рассматриваемые независимо от своих начальных позиций, точечно равны.

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

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

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

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

Первый символ результирующей строки будет символом в позиции этого буфера, а последний символ будет символом с индексом limit() - 1. Вызов этого метода не изменяет позицию буфера.

Если рассматривать как последовательность символов, длина буфера символов — это просто количество символов между позицией (включительно) и пределом (исключительно); то есть, это эквивалентно remaining().

Новый буфер будет совместно использовать содержимое этого буфера; то есть, если содержимое этого буфера изменяемо, то изменения в одном буфере приведут к изменению другого. Ёмкость нового буфера будет соответствовать ёмкости этого буфера, его позиция будет position() + start, его предел будет position() + end, и порядок байтов будет идентичен порядку байтов этого буфера. Новый буфер будет прямым, если и только если этот буфер является прямым, и он будет только для чтения, если и только если этот буфер является только для чтения.

Вызов этого метода в виде dst.append(csq) ведёт себя точно так же, как вызов

    dst.put(csq.toString())

В зависимости от спецификации toString для последовательности символов csq, вся последовательность может не быть добавлена. Например, вызов метода toString буфера символов вернёт подпоследовательность, содержимое которой зависит от позиции и предела буфера.

Вызов этого метода в виде dst.append(csq, start, end) когда csq не равно null, ведёт себя точно так же, как вызов

    dst.put(csq.subSequence(start, end).toString())

Вызов этого метода в виде dst.append(c) ведёт себя точно так же, как вызов

    dst.put(c)

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