StringBuilder (Платформа Java SE 7)

java.lang. Объект
- java.lang. StringBuilder

Все Реализованные Интерфейсы:

Сериализуемый, Appendable, CharSequence
```
public final class StringBuilder
extends Object
implements Serializable, CharSequence
```
Изменчивая последовательность символов. Этот класс обеспечивает API, совместимый с StringBuffer, но без гарантии синхронизации. Этот класс разрабатывается для использования в качестве понижения замены для StringBuffer в местах, где строковый буфер использовался единственным потоком (как обычно имеет место). Где только возможно рекомендуется, чтобы этот класс использовался в предпочтении к StringBuffer поскольку это будет быстрее являться объектом большинства реализаций.
Основные операции на a StringBuilder append и insert методы, которые перегружаются, чтобы принять данные любого типа. Каждый эффективно преобразовывает данную данную величину в строку и затем добавляет или вставляет символы той строки строковому разработчику. append метод всегда добавляет эти символы в конце разработчика; insert метод добавляет символы в указанной точке.
Например, если z отсылает к строковому разработчику объект, текущее содержание которого"start", тогда вызов метода z.append("le") заставил бы строкового разработчика содержать"startle", тогда как z.insert(4, "le") изменил бы строкового разработчика, чтобы содержать"starlet".
Вообще, если сурьма обращается к экземпляру a StringBuilder, тогда sb.append(x) имеет тот же самый эффект как sb.insert(sb.length(), x). У каждого строкового разработчика есть емкость. Пока длина символьной последовательности, содержавшейся в строковом разработчике, не превышает емкость, не необходимо выделить новый внутренний буфер. Если внутреннее переполнение буфера, это автоматически делается больше.
Экземпляры StringBuilder не безопасны для использования многократными потоками. Если такая синхронизация требуется тогда, ей рекомендуют это StringBuffer использоваться.

С тех пор:

1.5

См. Также:
StringBuffer, String, Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`StringBuilder()` Создает строкового разработчика без символов в этом и начальной емкости 16 символов.
`StringBuilder(CharSequence seq)` Создает строкового разработчика, который содержит те же самые символы как указанное `CharSequence`.
`StringBuilder(int capacity)` Создает строкового разработчика без символов в этом и начальной емкости, определенной `capacity` параметр.
`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(CharSequence s)` Добавляет указанную символьную последовательность к этому `Appendable`.
`StringBuilder`	`append(CharSequence s, int start, int end)` Добавляет подпоследовательность указанного `CharSequence` к этой последовательности.
`StringBuilder`	`append(double d)` Добавляет строковое представление `double` параметр этой последовательности.
`StringBuilder`	`append(float f)` Добавляет строковое представление `float` параметр этой последовательности.
`StringBuilder`	`append(int i)` Добавляет строковое представление `int` параметр этой последовательности.
`StringBuilder`	`append(long lng)` Добавляет строковое представление `long` параметр этой последовательности.
`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` значение в этой последовательности по указанному индексу.
`int`	`codePointAt(int index)` Возвращает символ (кодовая точка Unicode) по указанному индексу.
`int`	`codePointBefore(int index)` Возвращает символ (кодовая точка Unicode) перед указанным индексом.
`int`	`codePointCount(int beginIndex, int endIndex)` Возвращает число кодовых точек Unicode в указанном текстовом диапазоне этой последовательности.
`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)` Символы копируются с этой последовательности в целевой массив символа `dst`.
`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 dstOffset, CharSequence s)` Вставляет указанное `CharSequence` в эту последовательность.
`StringBuilder`	`insert(int dstOffset, CharSequence s, int start, int end)` Вставляет подпоследовательность указанного `CharSequence` в эту последовательность.
`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 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`	`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)` Возвращает новую символьную последовательность, которая является подпоследовательностью этой последовательности.
`Строка`	`substring(int start)` Возвращает новое `String` это содержит подпоследовательность символов, в настоящий момент содержавшихся в этой символьной последовательности.
`Строка`	`substring(int start, int end)` Возвращает новое `String` это содержит подпоследовательность символов, в настоящий момент содержавшихся в этой последовательности.
`Строка`	`toString()` Возвращает строку, представляющую данные в этой последовательности.
`void`	`trimToSize()` Попытки уменьшить хранение, используемое для символьной последовательности.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.lang. CharSequence
charAt, length, subSequence

- Деталь конструктора
  - StringBuilder
```
public StringBuilder()
```
    Создает строкового разработчика без символов в этом и начальной емкости 16 символов.
  - StringBuilder
```
public StringBuilder(int capacity)
```
    Создает строкового разработчика без символов в этом и начальной емкости, определенной capacity параметр.
    
    Параметры:
    capacity - начальная емкость.
    
    Броски:
    
    NegativeArraySizeException - если capacity параметром являются меньше чем 0.
  - StringBuilder
```
public StringBuilder(String str)
```
    Создает строкового разработчика, инициализированного к содержанию указанной строки. Начальная емкость строкового разработчика 16 плюс длина строкового параметра.
    
    Параметры:
    str - начальное содержание буфера.
    
    Броски:
    
    NullPointerException - если str null
  - StringBuilder
```
public StringBuilder(CharSequence seq)
```
    Создает строкового разработчика, который содержит те же самые символы как указанное CharSequence. Начальная емкость строкового разработчика 16 плюс длина CharSequence параметр.
    
    Параметры:
    seq - последовательность, чтобы скопировать.
    
    Броски:
    
    NullPointerException - если seq null
- Деталь метода
  - добавить
```
public StringBuilder append(Object obj)
```
    Добавляет строковое представление Object параметр.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(Object), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    obj - Object.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(String str)
```
    Добавляет указанную строку к этой символьной последовательности.
    Символы String параметр добавляется, в порядке, увеличивая длину этой последовательности длиной параметра. Если str null, тогда эти четыре символа "null" добавляются.
    Позвольте n быть длиной этой символьной последовательности только до выполнения append метод. Затем символ по индексу, k в новой символьной последовательности равен символу по индексу k в старой символьной последовательности, если k является меньше чем n; иначе, это равно символу по индексу k-n в параметре str.
    
    Параметры:
    str - строка.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(StringBuffer sb)
```
    Добавляет указанный StringBuffer к этой последовательности.
    Символы параметра StringBuffer добавляются, в порядке, к этой последовательности, увеличивая длину этой последовательности длиной параметра. Если sb является null, то эти четыре символа "null" добавляются к этой последовательности.
    Позвольте n быть длиной этой символьной последовательности только до выполнения метода append. Затем символ по индексу, k в новой символьной последовательности равен символу по индексу k в старой символьной последовательности, если k является меньше чем n; иначе, это равно символу по индексу k-n в параметре sb.
    
    Параметры:
    sb - StringBuffer, чтобы добавить.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(CharSequence s)
```
    Описание скопировало с интерфейса: Appendable
    
    Добавляет указанную символьную последовательность к этому Appendable.
    В зависимости от которого класс реализует символьную последовательность csq, вся последовательность не может быть добавлена. Например, если csq является a CharBuffer тогда подпоследовательность, чтобы добавить определяется позицией буфера и пределом.
    
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    s - Символьная последовательность, чтобы добавить. Если csq является null, то эти четыре символа "null" добавляются к этому Appendable.
    
    Возвраты:
    Ссылка на этот Appendable
  - добавить
```
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".
    
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    s - последовательность, чтобы добавить.
    start - начальное значение индекса подпоследовательности, которая будет добавлена.
    end - индекс конца подпоследовательности, которая будет добавлена.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если start отрицательно, или start больше чем end или end больше чем s.length()
  - добавить
```
public StringBuilder append(char[] str)
```
    Добавляет строковое представление char параметр массива этой последовательности.
    Символы параметра массива добавляются, в порядке, к содержанию этой последовательности. Длина этой последовательности увеличивается длиной параметра.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(char[]), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    str - символы, которые будут добавлены.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(char[] str,
                   int offset,
                   int len)
```
    Добавляет строковое представление подмассива char параметр массива этой последовательности.
    Символы char массив str, запуск по индексу offset, добавляются, в порядке, к содержанию этой последовательности. Длина этой последовательности увеличивается значением len.
    Полный эффект состоит точно в том, как будто параметры были преобразованы в строку методом String.valueOf(char[],int,int), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    str - символы, которые будут добавлены.
    offset - индекс первого char добавлять.
    len - число chars, чтобы добавить.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если offset < 0 или len < 0 или offset+len > str.length
  - добавить
```
public StringBuilder append(boolean b)
```
    Добавляет строковое представление boolean параметр последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(boolean), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    b - a boolean.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(char c)
```
    Добавляет строковое представление char параметр этой последовательности.
    Параметр добавляется к содержанию этой последовательности. Длина этой последовательности увеличивается 1.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(char), и символ в той строке был тогда appended к этой символьной последовательности.
    
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    c - a char.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(int i)
```
    Добавляет строковое представление int параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(int), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    i - int.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(long lng)
```
    Добавляет строковое представление long параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(long), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    lng - a long.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(float f)
```
    Добавляет строковое представление float параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(float), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    f - a float.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuilder append(double d)
```
    Добавляет строковое представление double параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(double), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    d - a double.
    
    Возвраты:
    ссылка на этот объект.
  - appendCodePoint
```
public StringBuilder appendCodePoint(int codePoint)
```
    Добавляет строковое представление codePoint параметр этой последовательности.
    Параметр добавляется к содержанию этой последовательности. Длина этой последовательности увеличивается Character.charCount(codePoint).
    Полный эффект состоит точно в том, как будто параметр был преобразован в a char массив методом Character.toChars(int) и символ в том массиве был тогда appended к этой символьной последовательности.
    
    Параметры:
    codePoint - кодовая точка Unicode
    
    Возвраты:
    ссылка на этот объект.
    С тех пор:
    
    1.5
  - удалить
```
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.
    Отметьте: Если символ по данному индексу является дополнительным символом, этот метод не удаляет весь символ. Если корректная обработка дополнительных символов требуется, определите число chars, чтобы удалить, вызывая Character.charCount(thisSequence.codePointAt(index)), где thisSequence эта последовательность.
    
    Параметры:
    index - Индекс char удалить
    
    Возвраты:
    Этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если index отрицательно или больше чем или равен length().
  - замена
```
public StringBuilder replace(int start,
                    int end,
                    String str)
```
    Заменяет символы в подстроке этой последовательности с символами в указанном String. Подстрока начинается в указанном start и расширяется на символ по индексу end - 1 или до конца последовательности, если никакой такой символ не существует. Сначала символы в подстроке удаляются и затем указанное String вставляется в start. (Эта последовательность будет удлинена, чтобы разместить указанную Строку в случае необходимости.)
    
    Параметры:
    start - Начинающийся индекс, включительно.
    end - Конечный индекс, монопольный.
    str - Строка, которая заменит предыдущее содержание.
    
    Возвраты:
    Этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если start отрицательно, больше чем length(), или больше чем end.
  - вставить
```
public StringBuilder insert(int index,
                   char[] str,
                   int offset,
                   int len)
```
    Вставляет строковое представление подмассива str параметр массива в эту последовательность. Подмассив начинается в указанном offset и расширяется len chars. Символы подмассива вставляются в эту последовательность в позиции, обозначенной index. Длина этой последовательности увеличивается len chars.
    
    Параметры:
    index - позиция, в которой можно вставить подмассив.
    str - A char массив.
    offset - индекс первого char в подмассиве, который будет вставлен.
    len - число chars в подмассиве, который будет вставлен.
    
    Возвраты:
    Этот объект
    
    Броски:
    
    StringIndexOutOfBoundsException - если index отрицательно или больше чем length(), или offset или len отрицательны, или (offset+len) больше чем str.length.
  - вставить
```
public StringBuilder insert(int offset,
                   Object obj)
```
    Вставляет строковое представление Object параметр в эту символьную последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(Object), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    obj - Object.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
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 - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int offset,
                   char[] str)
```
    Вставляет строковое представление char параметр массива в эту последовательность.
    Символы параметра массива вставляются в содержание этой последовательности в позиции, обозначенной offset. Длина этой последовательности увеличивается длиной параметра.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(char[]), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    str - символьный массив.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int dstOffset,
                   CharSequence s)
```
    Вставляет указанное CharSequence в эту последовательность.
    Символы CharSequence параметр вставляется, в порядке, в эту последовательность при обозначенном смещении, перемещая любые символы вверх первоначально выше той позиции и увеличивая длину этой последовательности длиной параметра s.
    Результатом этого метода является точно то же самое, как будто это был вызов этого объекта insert(dstOffset, s, 0, s.length ()) метод.
    Если s null, тогда эти четыре символа "null" вставляются в эту последовательность.
    
    Параметры:
    dstOffset - смещение.
    s - последовательность, которая будет вставлена
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
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, и меньше чем или равный длине этой последовательности.
    Параметр запуска должен быть неотрицательным, и не больше чем end.
    Параметр конца должен быть больше чем или равным start, и меньше чем или равный длине s.
    Если s null, тогда этот метод вставляет символы, как будто s параметр был последовательностью, содержащей эти четыре символа "null".
    Параметры:
    dstOffset - смещение в этой последовательности.
    s - последовательность, которая будет вставлена.
    start - начальное значение индекса подпоследовательности, которая будет вставлена.
    end - индекс конца подпоследовательности, которая будет вставлена.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если dstOffset отрицательно или больше чем this.length(), или start или end отрицательны, или start больше чем end или end больше чем s.length()
  - вставить
```
public StringBuilder insert(int offset,
                   boolean b)
```
    Вставляет строковое представление boolean параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(boolean), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    b - a boolean.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int offset,
                   char c)
```
    Вставляет строковое представление char параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(char), и символ в той строке был тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    c - a char.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int offset,
                   int i)
```
    Вставляет строковое представление второго int параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(int), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    i - int.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int offset,
                   long l)
```
    Вставляет строковое представление long параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(long), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    l - a long.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int offset,
                   float f)
```
    Вставляет строковое представление float параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(float), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    f - a float.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuilder insert(int offset,
                   double d)
```
    Вставляет строковое представление double параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(double), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    d - a double.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - indexOf
```
public int indexOf(String str)
```
    Возвращает индекс в пределах этой строки первого возникновения указанной подстроки. Возвращенное целое число является самым маленьким значением k так, что:
    this.toString().startsWith(str, k)
    true.
    Параметры:
    str - любая строка.
    
    Возвраты:
    если строковый параметр происходит как подстрока в пределах этого объекта, то индекс первого символа первого такая подстрока возвращается; если это не происходит как подстрока, -1 возвращается.
    
    Броски:
    
    NullPointerException - если str null.
  - indexOf
```
public int indexOf(String str,
          int fromIndex)
```
    Возвращает индекс в пределах этой строки первого возникновения указанной подстроки, запускающейся по указанному индексу. Возвращенное целое число является самым маленьким значением k для который:
    k >= Math.min(fromIndex, str.length()) && this.toString().startsWith(str, k)
    Если никакое такое значение k не существует, то-1 возвращается.
    Параметры:
    str - подстрока, которую можно искать.
    fromIndex - индекс, с которого можно запустить поиск.
    
    Возвраты:
    индекс в пределах этой строки первого возникновения указанной подстроки, запускающейся по указанному индексу.
    
    Броски:
    
    NullPointerException - если str null.
  - lastIndexOf
```
public int lastIndexOf(String str)
```
    Возвращает индекс в пределах этой строки самого правого возникновения указанной подстроки. Самая правая пустая строка "", как полагают, происходит в индексном значении this.length(). Возвращенный индекс является самым большим значением k так, что
    this.toString().startsWith(str, k)
    истина.
    Параметры:
    str - подстрока, чтобы искать.
    
    Возвраты:
    если строковый параметр происходит один или более раз как подстрока в пределах этого объекта, то индекс первого символа последнего такая подстрока возвращается. Если это не происходит как подстрока, -1 возвращается.
    
    Броски:
    
    NullPointerException - если str null.
  - lastIndexOf
```
public int lastIndexOf(String str,
              int fromIndex)
```
    Возвращает индекс в пределах этой строки последнего вхождения указанной подстроки. Возвращенное целое число является самым большим значением k так, что:
    k <= Math.min(fromIndex, str.length()) && this.toString().startsWith(str, k)
    If no such value of k exists, then -1 is returned.
    Parameters:
    str - the substring to search for.
    fromIndex - the index to start the search from.
    
    Returns:
    the index within this sequence of the last occurrence of the specified substring.
    
    Throws:
    
    NullPointerException - if str is null.
  - reverse
```
public StringBuilder reverse()
```
    Causes this character sequence to be replaced by the reverse of the sequence. If there are any surrogate pairs included in the sequence, these are treated as single characters for the reverse operation. Thus, the order of the high-low surrogates is never reversed. Let n be the character length of this character sequence (not the length in char values) just prior to execution of the reverse method. Then the character at index k in the new character sequence is equal to the character at index n-k-1 in the old character sequence.
    Note that the reverse operation may result in producing surrogate pairs that were unpaired low-surrogates and high-surrogates before the operation. For example, reversing "\uDC00\uD800" produces "\uD800\uDC00" which is a valid surrogate pair.
    
    Returns:
    a reference to this object.
  - toString
```
public String toString()
```
    Returns a string representing the data in this sequence. A new String object is allocated and initialized to contain the character sequence currently represented by this object. This String is then returned. Subsequent changes to this sequence do not affect the contents of the String.
    
    Specified by:
    
    toString in interface CharSequence
    
    Returns:
    a string representation of this sequence of characters.
  - length
```
public int length()
```
    Returns the length (character count).
    
    Specified by:
    
    length in interface CharSequence
    
    Returns:
    the length of the sequence of characters currently represented by this object
  - capacity
```
public int capacity()
```
    Returns the current capacity. The capacity is the amount of storage available for newly inserted characters, beyond which an allocation will occur.
    
    Returns:
    the current capacity
  - ensureCapacity
```
public void ensureCapacity(int minimumCapacity)
```
    Ensures that the capacity is at least equal to the specified minimum. If the current capacity is less than the argument, then a new internal array is allocated with greater capacity. The new capacity is the larger of:
    - The minimumCapacity argument.
    - Twice the old capacity, plus 2.
    If the minimumCapacity argument is nonpositive, this method takes no action and simply returns.
    Parameters:
    minimumCapacity - the minimum desired capacity.
  - trimToSize
```
public void trimToSize()
```
    Attempts to reduce storage used for the character sequence. If the buffer is larger than necessary to hold its current sequence of characters, then it may be resized to become more space efficient. Calling this method may, but is not required to, affect the value returned by a subsequent call to the capacity() method.
  - setLength
```
public void setLength(int newLength)
```
    Sets the length of the character sequence. The sequence is changed to a new character sequence whose length is specified by the argument. For every nonnegative index k less than newLength, the character at index k in the new character sequence is the same as the character at index k in the old sequence if k is less than the length of the old character sequence; otherwise, it is the null character '\u0000'. In other words, if the newLength argument is less than the current length, the length is changed to the specified length.
    If the newLength argument is greater than or equal to the current length, sufficient null characters ('\u0000') are appended so that length becomes the newLength argument.
    The newLength argument must be greater than or equal to 0.
    
    Parameters:
    newLength - the new length
    
    Throws:
    
    IndexOutOfBoundsException - if the newLength argument is negative.
  - charAt
```
public char charAt(int index)
```
    Returns the char value in this sequence at the specified index. The first char value is at index 0, the next at index 1, and so on, as in array indexing.
    The index argument must be greater than or equal to 0, and less than the length of this sequence.
    If the char value specified by the index is a surrogate, the surrogate value is returned.
    
    Specified by:
    
    charAt in interface CharSequence
    
    Parameters:
    index - the index of the desired char value.
    
    Returns:
    the char value at the specified index.
    
    Throws:
    
    IndexOutOfBoundsException - if index is negative or greater than or equal to length().
  - codePointAt
```
public int codePointAt(int index)
```
    Returns the character (Unicode code point) at the specified index. The index refers to char values (Unicode code units) and ranges from 0 to length() - 1.
    If the char value specified at the given index is in the high-surrogate range, the following index is less than the length of this sequence, and the char value at the following index is in the low-surrogate range, then the supplementary code point corresponding to this surrogate pair is returned. Otherwise, the char value at the given index is returned.
    
    Parameters:
    index - the index to the char values
    
    Returns:
    the code point value of the character at the index
    
    Throws:
    
    IndexOutOfBoundsException - if the index argument is negative or not less than the length of this sequence.
  - codePointBefore
```
public int codePointBefore(int index)
```
    Returns the character (Unicode code point) before the specified index. The index refers to char values (Unicode code units) and ranges from 1 to length().
    If the char value at (index - 1) is in the low-surrogate range, (index - 2) is not negative, and the char value at (index - 2) is in the high-surrogate range, then the supplementary code point value of the surrogate pair is returned. If the char value at index - 1 is an unpaired low-surrogate or a high-surrogate, the surrogate value is returned.
    
    Parameters:
    index - the index following the code point that should be returned
    
    Returns:
    the Unicode code point value before the given index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index argument is less than 1 or greater than the length of this sequence.
  - codePointCount
```
public int codePointCount(int beginIndex,
                 int endIndex)
```
    Returns the number of Unicode code points in the specified text range of this sequence. The text range begins at the specified beginIndex and extends to the char at index endIndex - 1. Thus the length (in chars) of the text range is endIndex-beginIndex. Unpaired surrogates within this sequence count as one code point each.
    
    Parameters:
    beginIndex - the index to the first char of the text range.
    endIndex - the index after the last char of the text range.
    
    Returns:
    the number of Unicode code points in the specified text range
    
    Throws:
    
    IndexOutOfBoundsException - if the beginIndex is negative, or endIndex is larger than the length of this sequence, or beginIndex is larger than endIndex.
  - offsetByCodePoints
```
public int offsetByCodePoints(int index,
                     int codePointOffset)
```
    Returns the index within this sequence that is offset from the given index by codePointOffset code points. Unpaired surrogates within the text range given by index and codePointOffset count as one code point each.
    
    Parameters:
    index - the index to be offset
    codePointOffset - the offset in code points
    
    Returns:
    the index within this sequence
    
    Throws:
    
    IndexOutOfBoundsException - if index is negative or larger then the length of this sequence, or if codePointOffset is positive and the subsequence starting with index has fewer than codePointOffset code points, or if codePointOffset is negative and the subsequence before index has fewer than the absolute value of codePointOffset code points.
  - getChars
```
public void getChars(int srcBegin,
            int srcEnd,
            char[] dst,
            int dstBegin)
```
    Characters are copied from this sequence into the destination character array dst. The first character to be copied is at index srcBegin; the last character to be copied is at index srcEnd-1. The total number of characters to be copied is srcEnd-srcBegin. The characters are copied into the subarray of dst starting at index dstBegin and ending at index:
    dstbegin + (srcEnd-srcBegin) - 1
    Parameters:
    srcBegin - start copying at this offset.
    srcEnd - stop copying at this offset.
    dst - the array to copy the data into.
    dstBegin - offset into dst.
    
    Throws:
    
    NullPointerException - if dst is null.
    IndexOutOfBoundsException - if any of the following is true:
    
    srcBegin is negative
    dstBegin is negative
    the srcBegin argument is greater than the srcEnd argument.
    srcEnd is greater than this.length().
    dstBegin+srcEnd-srcBegin is greater than dst.length
  - setCharAt
```
public void setCharAt(int index,
             char ch)
```
    The character at the specified index is set to ch. This sequence is altered to represent a new character sequence that is identical to the old character sequence, except that it contains the character ch at position index.
    The index argument must be greater than or equal to 0, and less than the length of this sequence.
    
    Parameters:
    index - the index of the character to modify.
    ch - the new character.
    
    Throws:
    
    IndexOutOfBoundsException - if index is negative or greater than or equal to length().
  - substring
```
public String substring(int start)
```
    Returns a new String that contains a subsequence of characters currently contained in this character sequence. The substring begins at the specified index and extends to the end of this sequence.
    
    Parameters:
    start - The beginning index, inclusive.
    
    Returns:
    The new string.
    
    Throws:
    
    StringIndexOutOfBoundsException - if start is less than zero, or greater than the length of this object.
  - subSequence
```
public CharSequence subSequence(int start,
                       int end)
```
    Returns a new character sequence that is a subsequence of this sequence.
    An invocation of this method of the form
    sb.subSequence(begin, end)
    behaves in exactly the same way as the invocation
    sb.substring(begin, end)
    This method is provided so that this class can implement the CharSequence interface.
    Specified by:
    
    subSequence in interface CharSequence
    
    Parameters:
    start - the start index, inclusive.
    end - the end index, exclusive.
    
    Returns:
    the specified subsequence.
    
    Throws:
    
    IndexOutOfBoundsException - if start or end are negative, if end is greater than length(), or if start is greater than end
  - substring
```
public String substring(int start,
               int end)
```
    Returns a new String that contains a subsequence of characters currently contained in this sequence. The substring begins at the specified start and extends to the character at index end - 1.
    
    Parameters:
    start - The beginning index, inclusive.
    end - The ending index, exclusive.
    
    Returns:
    The new string.
    
    Throws:
    
    StringIndexOutOfBoundsException - if start or end are negative or greater than length(), or start is greater than end.

Представьте ошибку или функцию
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.

Класс StringBuilder

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Методы, наследованные от интерфейса java.lang. CharSequence

Деталь конструктора

StringBuilder

StringBuilder

StringBuilder

StringBuilder

Деталь метода

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

appendCodePoint

удалить

deleteCharAt

замена

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

indexOf

indexOf

lastIndexOf

lastIndexOf

reverse

toString

length

capacity

ensureCapacity

trimToSize

setLength

charAt

codePointAt

codePointBefore

codePointCount

offsetByCodePoints

getChars

setCharAt

substring

subSequence

substring