Класс StringBuilder

java.lang.Object

java.lang.StringBuilder

Все реализуемые интерфейсы:: Serializable, Appendable, CharSequence, Comparable<StringBuilder>

public final class StringBuilder extends Object implements Appendable, Serializable, Comparable<StringBuilder>, CharSequence

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

Основные операции над StringBuilder — это методы append и insert, перегруженные для приема данных любого типа. Каждый из них преобразует заданное значение в строку, а затем добавляет или вставляет символы этой строки в построитель строк. Метод append всегда добавляет эти символы в конец построителя; метод insert добавляет символы в указанную позицию.

Например, если z ссылается на объект построителя строк с текущим содержимым "start", то вызов метода z.append("le") приведет к тому, что содержимым построителя строк станет "startle", тогда как z.insert(4, "le") изменит содержимое построителя строк на "starlet".

В общем случае, если sb ссылается на экземпляр StringBuilder, то sb.append(x) имеет тот же эффект, что и sb.insert(sb.length(), x).

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

Экземпляры StringBuilder не являются потокобезопасными. Если требуется синхронизация, рекомендуется использовать StringBuffer.

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

Примечание к API:

StringBuilder реализует Comparable, но не переопределяет equals. Поэтому естественный порядок сортировки StringBuilder не согласуется с методом equals. Следует соблюдать осторожность, если объекты StringBuilder используются в качестве ключей в SortedMap или элементов в SortedSet. Дополнительные сведения см. в описании Comparable, SortedMap или SortedSet.

Начиная с версии:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`StringBuilder()`	Создает построитель строк без символов с начальной емкостью 16 символов.
`StringBuilder(int capacity)`	Создает построитель строк без символов с начальной емкостью, заданной аргументом `capacity`.
`StringBuilder(CharSequence seq)`	Создает построитель строк, содержащий те же символы, что и указанный `CharSequence`.
`StringBuilder(String str)`	Создает построитель строк, инициализированный содержимым указанной строки.

Краткое описание методов

Модификатор и тип	Метод	Описание
`StringBuilder`	`append(boolean b)`	Добавляет строковое представление аргумента `boolean` в последовательность.
`StringBuilder`	`append(char c)`	Добавляет строковое представление аргумента `char` в эту последовательность.
`StringBuilder`	`append(char[] str)`	Добавляет строковое представление аргумента-массива `char` в эту последовательность.
`StringBuilder`	`append(char[] str, int offset, int len)`	Добавляет строковое представление подмассива аргумента-массива `char` в эту последовательность.
`StringBuilder`	`append(double d)`	Добавляет строковое представление аргумента `double` в эту последовательность.
`StringBuilder`	`append(float f)`	Добавляет строковое представление аргумента `float` в эту последовательность.
`StringBuilder`	`append(int i)`	Добавляет строковое представление аргумента `int` в эту последовательность.
`StringBuilder`	`append(long lng)`	Добавляет строковое представление аргумента `long` в эту последовательность.
`StringBuilder`	`append(CharSequence s)`	Добавляет указанную последовательность символов в этот `Appendable`.
`StringBuilder`	`append(CharSequence s, int start, int end)`	Добавляет подпоследовательность указанного `CharSequence` в эту последовательность.
`StringBuilder`	`append(Object obj)`	Добавляет строковое представление аргумента `Object`.
`StringBuilder`	`append(String str)`	Добавляет указанную строку в эту последовательность символов.
`StringBuilder`	`append(StringBuffer sb)`	Добавляет указанный `StringBuffer` в эту последовательность.
`StringBuilder`	`appendCodePoint(int codePoint)`	Добавляет строковое представление аргумента `codePoint` в эту последовательность.
`int`	`capacity()`	Возвращает текущую емкость.
`char`	`charAt(int index)`	Возвращает значение `char` в этой последовательности по указанному индексу.
`IntStream`	`chars()`	Возвращает поток значений `int`, дополняющий значения `char` из этой последовательности нулями до полного размера.
`int`	`codePointAt(int index)`	Возвращает символ (кодовую точку Unicode) по указанному индексу.
`int`	`codePointBefore(int index)`	Возвращает символ (кодовую точку Unicode) перед указанным индексом.
`int`	`codePointCount(int beginIndex, int endIndex)`	Возвращает количество кодовых точек Unicode в указанном диапазоне текста этой последовательности.
`IntStream`	`codePoints()`	Возвращает поток значений кодовых точек из этой последовательности.
`int`	`compareTo(StringBuilder another)`	Сравнивает два экземпляра `StringBuilder` в лексикографическом порядке.
`StringBuilder`	`delete(int start, int end)`	Удаляет символы из подстроки этой последовательности.
`StringBuilder`	`deleteCharAt(int index)`	Удаляет `char` в указанной позиции этой последовательности.
`void`	`ensureCapacity(int minimumCapacity)`	Гарантирует, что емкость будет не меньше указанного минимального значения.
`void`	`getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)`	Копирует символы из этой последовательности в указанный массив назначения.
`int`	`indexOf(String str)`	Возвращает индекс первого вхождения указанной подстроки в этой строке.
`int`	`indexOf(String str, int fromIndex)`	Возвращает индекс первого вхождения указанной подстроки в этой строке, начиная с указанного индекса.
`StringBuilder`	`insert(int offset, boolean b)`	Вставляет строковое представление аргумента `boolean` в эту последовательность.
`StringBuilder`	`insert(int offset, char c)`	Вставляет строковое представление аргумента `char` в эту последовательность.
`StringBuilder`	`insert(int offset, char[] str)`	Вставляет строковое представление аргумента-массива `char` в эту последовательность.
`StringBuilder`	`insert(int index, char[] str, int offset, int len)`	Вставляет строковое представление подмассива аргумента-массива `str` в эту последовательность.
`StringBuilder`	`insert(int offset, double d)`	Вставляет строковое представление аргумента `double` в эту последовательность.
`StringBuilder`	`insert(int offset, float f)`	Вставляет строковое представление аргумента `float` в эту последовательность.
`StringBuilder`	`insert(int offset, int i)`	Вставляет строковое представление второго аргумента `int` в эту последовательность.
`StringBuilder`	`insert(int offset, long l)`	Вставляет строковое представление аргумента `long` в эту последовательность.
`StringBuilder`	`insert(int dstOffset, CharSequence s)`	Вставляет указанный `CharSequence` в эту последовательность.
`StringBuilder`	`insert(int dstOffset, CharSequence s, int start, int end)`	Вставляет подпоследовательность указанного `CharSequence` в эту последовательность.
`StringBuilder`	`insert(int offset, Object obj)`	Вставляет строковое представление аргумента `Object` в эту последовательность символов.
`StringBuilder`	`insert(int offset, String str)`	Вставляет строку в эту последовательность символов.
`int`	`lastIndexOf(String str)`	Возвращает индекс последнего вхождения указанной подстроки в этой строке.
`int`	`lastIndexOf(String str, int fromIndex)`	Возвращает индекс последнего вхождения указанной подстроки в этой строке, выполняя обратный поиск начиная с указанного индекса.
`int`	`length()`	Возвращает длину (количество символов).
`int`	`offsetByCodePoints(int index, int codePointOffset)`	Возвращает индекс в этой последовательности, смещенный относительно заданного `index` на `codePointOffset` кодовых точек.
`StringBuilder`	`repeat(int codePoint, int count)`	Повторяет `count` раз строковое представление аргумента `codePoint` в этой последовательности.
`StringBuilder`	`repeat(CharSequence cs, int count)`	Добавляет в эту последовательность `count` копий указанного `CharSequence` `cs`.
`StringBuilder`	`replace(int start, int end, String str)`	Заменяет символы в подстроке этой последовательности символами из указанного `String`.
`StringBuilder`	`reverse()`	Заменяет эту последовательность символов ее обратной последовательностью.
`void`	`setCharAt(int index, char ch)`	Символ по указанному индексу устанавливается в значение `ch`.
`void`	`setLength(int newLength)`	Задает длину последовательности символов.
`CharSequence`	`subSequence(int start, int end)`	Возвращает последовательность символов, являющуюся подпоследовательностью этой последовательности.
`String`	`substring(int start)`	Возвращает `String`, содержащий подпоследовательность символов, в данный момент входящих в эту последовательность символов.
`String`	`substring(int start, int end)`	Возвращает `String`, содержащий подпоследовательность символов, в данный момент входящих в эту последовательность.
`String`	`toString()`	Возвращает строку, представляющую данные этой последовательности.
`void`	`trimToSize()`	Пытается уменьшить объем памяти, используемой для хранения последовательности символов.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного интервала реального времени.

Методы, объявленные в интерфейсе CharSequence

isEmpty

Модификатор и тип	Метод	Описание
`default boolean`	`isEmpty()`	Возвращает `true`, если эта последовательность символов пуста.

Подробное описание конструкторов

StringBuilder

public StringBuilder()

Создает строковый буфер без символов и с начальной емкостью 16 символов.

StringBuilder

public StringBuilder(int capacity)

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

Параметры:: capacity — начальная емкость.
Исключения:: NegativeArraySizeException — если аргумент capacity меньше 0.

StringBuilder

public StringBuilder(String str)

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

Параметры:: str — начальное содержимое буфера.

StringBuilder

public StringBuilder(CharSequence seq)

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

Параметры:: seq — последовательность для копирования.

Подробное описание методов

compareTo

public int compareTo(StringBuilder another)

Лексикографически сравнивает два экземпляра StringBuilder. Этот метод использует те же правила лексикографического сравнения, что и метод CharSequence.compare(this, another).

Для более точного сравнения строк с учетом языковых стандартов см. Collator.

Определено в:: compareTo в интерфейсе Comparable<StringBuilder>
Параметры:: another — объект StringBuilder для сравнения с текущим
Возвращает:: значение 0, если этот StringBuilder содержит ту же последовательность символов, что и аргумент StringBuilder; отрицательное целое число, если этот StringBuilder лексикографически меньше аргумента StringBuilder; или положительное целое число, если этот StringBuilder лексикографически больше аргумента StringBuilder.
Начиная с версии:: 11

append

public StringBuilder append(Object obj)

Добавляет строковое представление аргумента Object.

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(Object), после чего символы этой строки appended к этой последовательности символов.

Параметры:: obj — объект Object.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(String str)

Добавляет указанную строку к этой последовательности символов.

Символы аргумента String добавляются по порядку, увеличивая длину этой последовательности на длину аргумента. Если str равен null, добавляются четыре символа "null".

Пусть n — длина этой последовательности символов непосредственно перед выполнением метода append. Тогда символ с индексом k в новой последовательности символов совпадает с символом с индексом k в старой последовательности, если k меньше n; в противном случае он совпадает с символом с индексом k-n в аргументе str.

Параметры:: str — строка.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(StringBuffer sb)

Добавляет указанную последовательность StringBuffer к этой последовательности.

Символы аргумента StringBuffer добавляются к этой последовательности по порядку, увеличивая ее длину на длину аргумента. Если sb равен null, к этой последовательности добавляются четыре символа "null".

Параметры:: sb — последовательность StringBuffer для добавления.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(CharSequence s)

Описание скопировано из интерфейса: Appendable

Добавляет указанную последовательность символов к этому Appendable.

В зависимости от класса, реализующего последовательность символов csq, может быть добавлена не вся последовательность. Например, если csq — это CharBuffer, добавляемая подпоследовательность определяется позицией и пределом буфера.

Содержимое этого Appendable не определено, если CharSequence изменяется во время вызова метода или при доступе к CharSequence возникает исключение.

Определено в:: append в интерфейсе Appendable
Параметры:: s — последовательность символов для добавления. Если csq равен null, к этому Appendable добавляются четыре символа "null".
Возвращает:: ссылку на этот Appendable

append

public StringBuilder append(CharSequence s, int start, int end)

Добавляет подпоследовательность указанной последовательности CharSequence к этой последовательности.

Символы аргумента s, начиная с индекса start, добавляются по порядку к содержимому этой последовательности до индекса end (не включая его). Длина этой последовательности увеличивается на значение end - start.

Пусть n — длина этой последовательности символов непосредственно перед выполнением метода append. Тогда символ с индексом k в этой последовательности символов становится равен символу с индексом k в этой последовательности, если k меньше n; в противном случае он равен символу с индексом k+start-n в аргументе s.

Если s равен null, этот метод добавляет символы так, как если бы параметр s был последовательностью, содержащей четыре символа "null".

Содержимое не определено, если CharSequence изменяется во время вызова метода или при доступе к CharSequence возникает исключение.

Определено в:: append в интерфейсе Appendable
Параметры:: s — последовательность для добавления.; start — начальный индекс добавляемой подпоследовательности.; end — конечный индекс добавляемой подпоследовательности.
Возвращает:: ссылку на этот объект.
Исключения:: IndexOutOfBoundsException — если start отрицателен, или start больше end, или end больше s.length()

append

public StringBuilder append(char[] str)

Добавляет строковое представление массива char-аргумента к этой последовательности.

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

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(char[]), после чего символы этой строки appended к этой последовательности символов.

Параметры:: str — добавляемые символы.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(char[] str, int offset, int len)

Добавляет строковое представление подмассива аргумента — массива char — к этой последовательности.

Символы массива char str, начиная с индекса offset, добавляются по порядку к содержимому этой последовательности. Ее длина увеличивается на значение len.

Результат в точности совпадает с результатом преобразования аргументов в строку методом String.valueOf(char[],int,int), после чего символы этой строки appended к этой последовательности символов.

Параметры:: str — добавляемые символы.; offset — индекс первого добавляемого char.; len — количество добавляемых char.
Возвращает:: ссылку на этот объект.
Исключения:: IndexOutOfBoundsException — если offset < 0 или len < 0 или offset+len > str.length

append

public StringBuilder append(boolean b)

Добавляет строковое представление аргумента boolean к последовательности.

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(boolean), после чего символы этой строки appended к этой последовательности символов.

Параметры:: b — значение boolean.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(char c)

Добавляет строковое представление аргумента char к этой последовательности.

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

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(char), после чего символ из этой строки appended к этой последовательности символов.

Определено в:: append в интерфейсе Appendable
Параметры:: c — значение char.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(int i)

Добавляет строковое представление аргумента int к этой последовательности.

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(int), после чего символы этой строки appended к этой последовательности символов.

Параметры:: i — значение int.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(long lng)

Добавляет строковое представление аргумента long к этой последовательности.

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(long), после чего символы этой строки appended к этой последовательности символов.

Параметры:: lng — значение long.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(float f)

Добавляет строковое представление аргумента float к этой последовательности.

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(float), после чего символы этой строки appended к этой последовательности символов.

Параметры:: f — значение float.
Возвращает:: ссылку на этот объект.

append

public StringBuilder append(double d)

Добавляет строковое представление аргумента double к этой последовательности.

Результат в точности совпадает с результатом преобразования аргумента в строку методом String.valueOf(double), после чего символы этой строки appended к этой последовательности символов.

Параметры:: d — значение double.
Возвращает:: ссылку на этот объект.

appendCodePoint

public StringBuilder appendCodePoint(int codePoint)

Добавляет строковое представление аргумента codePoint к этой последовательности.

Аргумент добавляется к содержимому этой последовательности. Ее длина увеличивается на значение Character.charCount(codePoint).

Результат в точности совпадает с преобразованием аргумента в массив char методом Character.toChars(int) и последующим добавлением символа из этого массива appended к этой последовательности символов.

Параметры:: codePoint — кодовая точка Unicode
Возвращает:: ссылку на этот объект.
Начиная с версии:: 1.5

delete

public StringBuilder delete(int start, int end)

Удаляет символы из подстроки этой последовательности. Подстрока начинается с указанного start и продолжается до символа с индексом end - 1 или до конца последовательности, если такого символа нет. Если start равно end, изменения не вносятся.

Параметры:: start — начальный индекс включительно.; end — конечный индекс не включительно.
Возвращает:: этот объект.
Исключения:: StringIndexOutOfBoundsException — если start отрицателен, больше length() или больше end.

deleteCharAt

public StringBuilder deleteCharAt(int index)

Удаляет char в указанной позиции этой последовательности. Длина этой последовательности уменьшается на один char.

Примечание. Если символ по указанному индексу является дополнительным символом, этот метод не удаляет его целиком. Если требуется корректная обработка дополнительных символов, определите количество удаляемых char, вызвав Character.charCount(thisSequence.codePointAt(index)), где thisSequence — эта последовательность.

Параметры:: index — индекс удаляемого char
Возвращает:: этот объект.
Исключения:: StringIndexOutOfBoundsException — если index отрицателен или больше либо равен length().

replace

public StringBuilder replace(int start, int end, String str)

Заменяет символы в подстроке этой последовательности символами указанной строки String. Подстрока начинается с указанного start и продолжается до символа с индексом end - 1 или до конца последовательности, если такого символа нет. Сначала символы подстроки удаляются, а затем указанная строка String вставляется в позицию start. (При необходимости длина этой последовательности будет увеличена, чтобы вместить указанную строку.)

Параметры:: start — начальный индекс включительно.; end — конечный индекс не включительно.; str — строка, заменяющая предыдущее содержимое.
Возвращает:: этот объект.
Исключения:: StringIndexOutOfBoundsException — если start отрицателен, больше length() или больше end.

insert

public StringBuilder insert(int index, char[] str, int offset, int len)

Вставляет строковое представление подмассива аргумента — массива str — в эту последовательность. Подмассив начинается с указанного offset и содержит len char. Символы подмассива вставляются в эту последовательность в позицию, заданную index. Длина этой последовательности увеличивается на len char.

Параметры:: index — позиция для вставки подмассива.; str — массив char.; offset — индекс первого char во вставляемом подмассиве.; len — количество char во вставляемом подмассиве.
Возвращает:: этот объект
Исключения:: StringIndexOutOfBoundsException — если index отрицателен или больше length(), или offset либо len отрицательны, или (offset+len) больше str.length.

insert

public StringBuilder insert(int offset, Object obj)

Вставляет строковое представление аргумента Object в эту последовательность символов.

Результат в точности совпадает с преобразованием второго аргумента в строку методом String.valueOf(Object) и последующей вставкой символов этой строки inserted в эту последовательность символов по указанному смещению.

Аргумент offset должен быть больше или равен 0 и меньше либо равен длине этой последовательности.

Параметры:: offset — смещение.; obj — объект Object.
Возвращает:: ссылку на этот объект.
Исключения:: StringIndexOutOfBoundsException — если смещение недопустимо.

insert

public StringBuilder insert(int offset, String str)

Вставляет строку в эту последовательность символов.

Символы аргумента String вставляются по порядку в эту последовательность по указанному смещению, сдвигая символы, изначально расположенные выше этой позиции, и увеличивая длину последовательности на длину аргумента. Если str равно null, в эту последовательность вставляются четыре символа "null".

Символ с индексом k в новой последовательности символов равен:

символу с индексом k в старой последовательности символов, если k меньше offset
символу с индексом k-offset в аргументе str, если k не меньше offset, но меньше offset+str.length()
символу с индексом k-str.length() в старой последовательности символов, если k не меньше offset+str.length()

Аргумент offset должен быть больше или равен 0 и меньше либо равен длине этой последовательности.

Параметры:: offset — смещение.; str — строка.
Возвращает:: ссылку на этот объект.
Исключения:: StringIndexOutOfBoundsException — если смещение недопустимо.

insert

public StringBuilder insert(int offset, char[] str)

Вставляет строковое представление аргумента — массива char — в эту последовательность.

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

Результат в точности совпадает с преобразованием второго аргумента в строку методом String.valueOf(char[]) и последующей вставкой символов этой строки inserted в эту последовательность символов по указанному смещению.

Аргумент offset должен быть больше или равен 0 и меньше либо равен длине этой последовательности.

Параметры:: offset — смещение.; str — массив символов.
Возвращает:: ссылку на этот объект.
Исключения:: StringIndexOutOfBoundsException — если смещение недопустимо.

insert

public StringBuilder insert(int dstOffset, CharSequence s)

Вставляет указанную последовательность CharSequence в эту последовательность.

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

Результат этого метода в точности совпадает с результатом вызова метода объекта insert(dstOffset, s, 0, s.length()).

Если s равно null, в эту последовательность вставляются четыре символа "null".

Параметры:: dstOffset — смещение.; s — вставляемая последовательность
Возвращает:: ссылку на этот объект.
Исключения:: IndexOutOfBoundsException — если смещение недопустимо.

insert

public StringBuilder insert(int dstOffset, CharSequence s, int start, int end)

Вставляет подпоследовательность указанной последовательности CharSequence в эту последовательность.

Подпоследовательность аргумента s, заданная start и end, вставляется по порядку в эту последовательность по указанному смещению назначения, сдвигая символы, изначально расположенные выше этой позиции. Длина этой последовательности увеличивается на end - start.

Символ с индексом k в этой последовательности становится равен:

символу с индексом k в этой последовательности, если k меньше dstOffset
символу с индексом k+start-dstOffset в аргументе s, если k больше или равен dstOffset, но меньше dstOffset+end-start
символу с индексом k-(end-start) в этой последовательности, если k больше или равен dstOffset+end-start

Аргумент dstOffset должен быть больше или равен 0 и меньше либо равен длине этой последовательности.

Аргумент start должен быть неотрицательным и не превышать end.

Аргумент end должен быть больше или равен start и меньше либо равен длине s.

Если s равно null, этот метод вставляет символы так, как если бы параметр s был последовательностью, содержащей четыре символа "null".

Параметры:: dstOffset — смещение в этой последовательности.; s — вставляемая последовательность.; start — начальный индекс вставляемой подпоследовательности.; end — конечный индекс вставляемой подпоследовательности.
Возвращает:: ссылку на этот объект.
Исключения:: IndexOutOfBoundsException — если dstOffset отрицателен или больше this.length(), или start либо end отрицательны, или start больше end, или end больше s.length()

insert

public StringBuilder insert(int offset, boolean b)

Вставляет строковое представление аргумента boolean в эту последовательность.

Результат в точности совпадает с преобразованием второго аргумента в строку методом String.valueOf(boolean) и последующей вставкой символов этой строки inserted в эту последовательность символов по указанному смещению.

Аргумент offset должен быть больше или равен 0 и меньше либо равен длине этой последовательности.

Параметры:: offset — смещение.; b — значение boolean.
Возвращает:: ссылку на этот объект.
Исключения:: StringIndexOutOfBoundsException — если смещение недопустимо.

insert

public StringBuilder insert(int offset, char c)

Вставляет строковое представление аргумента char в эту последовательность.

Общий эффект точно такой же, как если бы второй аргумент был преобразован в строку методом String.valueOf(char), а символ из этой строки затем был inserted в эту последовательность символов по указанному смещению.