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

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

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

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

С тех пор:

JDK1.0

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

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`StringBuffer`	`append(boolean b)` Добавляет строковое представление `boolean` параметр последовательности.
`StringBuffer`	`append(char c)` Добавляет строковое представление `char` параметр этой последовательности.
`StringBuffer`	`append(char[] str)` Добавляет строковое представление `char` параметр массива этой последовательности.
`StringBuffer`	`append(char[] str, int offset, int len)` Добавляет строковое представление подмассива `char` параметр массива этой последовательности.
`StringBuffer`	`append(CharSequence s)` Добавляет указанное `CharSequence` к этой последовательности.
`StringBuffer`	`append(CharSequence s, int start, int end)` Добавляет подпоследовательность указанного `CharSequence` к этой последовательности.
`StringBuffer`	`append(double d)` Добавляет строковое представление `double` параметр этой последовательности.
`StringBuffer`	`append(float f)` Добавляет строковое представление `float` параметр этой последовательности.
`StringBuffer`	`append(int i)` Добавляет строковое представление `int` параметр этой последовательности.
`StringBuffer`	`append(long lng)` Добавляет строковое представление `long` параметр этой последовательности.
`StringBuffer`	`append(Object obj)` Добавляет строковое представление `Object` параметр.
`StringBuffer`	`append(String str)` Добавляет указанную строку к этой символьной последовательности.
`StringBuffer`	`append(StringBuffer sb)` Добавляет указанный `StringBuffer` к этой последовательности.
`StringBuffer`	`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 в указанном текстовом диапазоне этой последовательности.
`StringBuffer`	`delete(int start, int end)` Удаляет символы в подстроке этой последовательности.
`StringBuffer`	`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)` Возвращает индекс в пределах этой строки первого возникновения указанной подстроки, запускающейся по указанному индексу.
`StringBuffer`	`insert(int offset, boolean b)` Вставляет строковое представление `boolean` параметр в эту последовательность.
`StringBuffer`	`insert(int offset, char c)` Вставляет строковое представление `char` параметр в эту последовательность.
`StringBuffer`	`insert(int offset, char[] str)` Вставляет строковое представление `char` параметр массива в эту последовательность.
`StringBuffer`	`insert(int index, char[] str, int offset, int len)` Вставляет строковое представление подмассива `str` параметр массива в эту последовательность.
`StringBuffer`	`insert(int dstOffset, CharSequence s)` Вставляет указанное `CharSequence` в эту последовательность.
`StringBuffer`	`insert(int dstOffset, CharSequence s, int start, int end)` Вставляет подпоследовательность указанного `CharSequence` в эту последовательность.
`StringBuffer`	`insert(int offset, double d)` Вставляет строковое представление `double` параметр в эту последовательность.
`StringBuffer`	`insert(int offset, float f)` Вставляет строковое представление `float` параметр в эту последовательность.
`StringBuffer`	`insert(int offset, int i)` Вставляет строковое представление второго `int` параметр в эту последовательность.
`StringBuffer`	`insert(int offset, long l)` Вставляет строковое представление `long` параметр в эту последовательность.
`StringBuffer`	`insert(int offset, Object obj)` Вставляет строковое представление `Object` параметр в эту символьную последовательность.
`StringBuffer`	`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` кодовые точки.
`StringBuffer`	`replace(int start, int end, String str)` Заменяет символы в подстроке этой последовательности с символами в указанном `String`.
`StringBuffer`	`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

- Деталь конструктора
  - StringBuffer
```
public StringBuffer()
```
    Создает строковый буфер без символов в этом и начальной емкости 16 символов.
  - StringBuffer
```
public StringBuffer(int capacity)
```
    Создает строковый буфер без символов в этом и указанной начальной емкости.
    
    Параметры:
    capacity - начальная емкость.
    
    Броски:
    
    NegativeArraySizeException - если capacity параметром являются меньше чем 0.
  - StringBuffer
```
public StringBuffer(String str)
```
    Создает строковый буфер, инициализированный к содержанию указанной строки. Начальная емкость строкового буфера 16 плюс длина строкового параметра.
    
    Параметры:
    str - начальное содержание буфера.
    
    Броски:
    
    NullPointerException - если str null
  - StringBuffer
```
public StringBuffer(CharSequence seq)
```
    Создает строковый буфер, который содержит те же самые символы как указанное CharSequence. Начальная емкость строкового буфера 16 плюс длина CharSequence параметр.
    Если длина указанного CharSequence меньше чем или равно нулю, затем пустой буфер емкости 16 возвращается.
    
    Параметры:
    seq - последовательность, чтобы скопировать.
    
    Броски:
    
    NullPointerException - если seq null
    С тех пор:
    
    1.5
- Деталь метода
  - длина
```
public int length()
```
    Возвращает длину (символьное количество).
    
    Определенный:
    
    length в интерфейсе CharSequence
    
    Возвраты:
    длина последовательности символов в настоящий момент представляется этим объектом
  - емкость
```
public int capacity()
```
    Возвращает текущую емкость. Емкость является количеством хранения, доступного для недавно вставленных символов, вне которых произойдет выделение.
    
    Возвраты:
    текущая емкость
  - ensureCapacity
```
public void ensureCapacity(int minimumCapacity)
```
    Гарантирует, что емкость, по крайней мере, равна указанному минимуму. Если текущая емкость является меньше чем параметр, то новый внутренний массив выделяется с большей емкостью. Новая емкость является большим из:
    - minimumCapacity параметр.
    - Дважды старая емкость, плюс 2.
    Если minimumCapacity параметр неположителен, этот метод не предпринимает мер и просто возвращается.
    Параметры:
    minimumCapacity - минимальная требуемая емкость.
  - trimToSize
```
public void trimToSize()
```
    Попытки уменьшить хранение, используемое для символьной последовательности. Если буфер является более крупным чем необходимый, чтобы содержать его текущую последовательность символов, то он может быть изменен, чтобы стать большим количеством эффективного пространства. Вызов этого метода, но не обязан, может влиять на значение, возвращенное последующим звонком capacity() метод.
    
    С тех пор:
    
    1.5
  - setLength
```
public void setLength(int newLength)
```
    Устанавливает длину символьной последовательности. Последовательность изменяется на новую символьную последовательность, длина которой определяется параметром. Для каждого неотрицательного индекса k меньше чем newLength, символ по индексу, k в новой символьной последовательности является тем же самым как символом по индексу k в старой последовательности, если k является меньше чем длина старой символьной последовательности; иначе, это - нулевой символ '\u0000'. Другими словами, если newLength параметром являются меньше чем текущая длина, длина изменяется на указанную длину.
    Если newLength параметр больше чем или равен текущей длине, достаточные нулевые символы ('\u0000') добавляются так, чтобы длина стала newLength параметр.
    newLength параметр должен быть больше чем или равным 0.
    
    Параметры:
    newLength - новая длина
    
    Броски:
    
    IndexOutOfBoundsException - если newLength параметр отрицателен.
    См. Также:
    length()
  - charAt
```
public char charAt(int index)
```
    Возвраты char значение в этой последовательности по указанному индексу. Первое char значение по индексу 0, следующее по индексу 1, и так далее, как в индексации массива.
    Индексный параметр должен быть больше чем или равным 0, и меньше чем длина этой последовательности.
    Если char значение, определенное индексом, является заместителем, суррогатное значение возвращается.
    
    Определенный:
    
    charAt в интерфейсе CharSequence
    
    Параметры:
    index - индекс требуемого char значение.
    
    Возвраты:
    char значение по указанному индексу.
    
    Броски:
    
    IndexOutOfBoundsException - если index отрицательно или больше чем или равен length().
    См. Также:
    length()
  - codePointAt
```
public int codePointAt(int index)
```
    Возвращает символ (кодовая точка Unicode) по указанному индексу. Индекс обращается к char значения (элементы кода Unicode) и диапазоны от 0 к length() - 1.
    Если char значение, определенное по данному индексу, находится в высоко-суррогатном диапазоне, следующий индекс является меньше чем длина этой последовательности, и char значение по следующему индексу находится в диапазоне низкого заместителя, тогда дополнительная кодовая точка, соответствующая этой суррогатной паре, возвращается. Иначе, char значение по данному индексу возвращается.
    
    Параметры:
    index - индекс к char значения
    
    Возвраты:
    значение кодовой точки символа в index
    С тех пор:
    
    1.5
  - codePointBefore
```
public int codePointBefore(int index)
```
    Возвращает символ (кодовая точка Unicode) перед указанным индексом. Индекс обращается к char значения (элементы кода Unicode) и диапазоны от 1 к length().
    Если char значение в (index - 1) находится в диапазоне низкого заместителя, (index - 2) не отрицательно, и char значение в (index - 2) находится в высоко-суррогатном диапазоне, тогда дополнительное значение кодовой точки суррогатной пары возвращается. Если char значение в index - 1 непарный низкий заместитель или высокий заместитель, суррогатное значение возвращается.
    
    Параметры:
    index - индекс после кодовой точки, которая должна быть возвращена
    
    Возвраты:
    значение кодовой точки Unicode перед данным индексом.
    С тех пор:
    
    1.5
  - codePointCount
```
public int codePointCount(int beginIndex,
                 int endIndex)
```
    Возвращает число кодовых точек Unicode в указанном текстовом диапазоне этой последовательности. Текстовый диапазон начинается в указанном beginIndex и расширяется на char по индексу endIndex - 1. Таким образом длина (в chars) из текста диапазон endIndex-beginIndex. Непарные заместители в пределах этой последовательности рассчитывают как одна кодовая точка каждый.
    
    Параметры:
    beginIndex - индекс к первому char из текстового диапазона.
    endIndex - индекс после последнего char из текстового диапазона.
    
    Возвраты:
    число кодовых точек Unicode в указанном текстовом диапазоне
    С тех пор:
    
    1.5
  - offsetByCodePoints
```
public int offsetByCodePoints(int index,
                     int codePointOffset)
```
    Возвращает индекс в пределах этой последовательности, которая смещается от данного index codePointOffset кодовые точки. Непарные заместители в пределах текстового диапазона, данного index и codePointOffset рассчитайте как одна кодовая точка каждый.
    
    Параметры:
    index - индекс, который будет смещен
    codePointOffset - смещение в кодовых точках
    
    Возвраты:
    индекс в пределах этой последовательности
    С тех пор:
    
    1.5
  - getChars
```
public void getChars(int srcBegin,
            int srcEnd,
            char[] dst,
            int dstBegin)
```
    Символы копируются с этой последовательности в целевой массив символа dst. Первый символ, который будет скопирован, по индексу srcBegin; последний знак, который будет скопирован, по индексу srcEnd-1. Общее количество символов, которые будут скопированы, srcEnd-srcBegin. Символы копируются в подмассив dst запуск по индексу dstBegin и окончание по индексу:
    dstbegin + (srcEnd-srcBegin) - 1
    Параметры:
    srcBegin - начните копировать при этом смещении.
    srcEnd - прекратите копировать при этом смещении.
    dst - массив, чтобы скопировать данные в.
    dstBegin - смещение в dst.
    
    Броски:
    
    NullPointerException - если dst null.
    IndexOutOfBoundsException - если какое-либо следующее является истиной:
    
    srcBegin отрицательно
    dstBegin отрицательно
    srcBegin параметр больше чем srcEnd параметр.
    srcEnd больше чем this.length().
    dstBegin+srcEnd-srcBegin больше чем dst.length
  - setCharAt
```
public void setCharAt(int index,
             char ch)
```
    Символ по указанному индексу устанавливается в ch. Эта последовательность изменяется, чтобы представить новую символьную последовательность, которая идентична старой символьной последовательности, за исключением того, что это содержит символ ch в позиции index.
    Индексный параметр должен быть больше чем или равным 0, и меньше чем длина этой последовательности.
    
    Параметры:
    index - индекс символа, чтобы изменить.
    ch - новый символ.
    
    Броски:
    
    IndexOutOfBoundsException - если index отрицательно или больше чем или равен length().
    См. Также:
    length()
  - добавить
```
public StringBuffer append(Object obj)
```
    Добавляет строковое представление Object параметр.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(Object), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    obj - Object.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer append(String str)
```
    Добавляет указанную строку к этой символьной последовательности.
    Символы String параметр добавляется, в порядке, увеличивая длину этой последовательности длиной параметра. Если str null, тогда эти четыре символа "null" добавляются.
    Позвольте n быть длиной этой символьной последовательности только до выполнения append метод. Затем символ по индексу, k в новой символьной последовательности равен символу по индексу k в старой символьной последовательности, если k является меньше чем n; иначе, это равно символу по индексу k-n в параметре str.
    
    Параметры:
    str - строка.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer append(StringBuffer sb)
```
    Добавляет указанный StringBuffer к этой последовательности.
    Символы параметра StringBuffer добавляются, в порядке, к содержанию этого StringBuffer, увеличивая длину этого StringBuffer длиной параметра. Если sb является null, то эти четыре символа "null" добавляются к этому StringBuffer.
    Позвольте n быть длиной старой символьной последовательности, тот, содержавшийся в StringBuffer только до выполнения метода append. Затем символ по индексу, k в новой символьной последовательности равен символу по индексу k в старой символьной последовательности, если k является меньше чем n; иначе, это равно символу по индексу k-n в параметре sb.
    Этот метод синхронизируется на this (место назначения), возражают, но не синхронизируется на источнике (sb).
    
    Параметры:
    sb - StringBuffer, чтобы добавить.
    
    Возвраты:
    ссылка на этот объект.
    С тех пор:
    
    1.4
  - добавить
```
public StringBuffer append(CharSequence s)
```
    Добавляет указанное CharSequence к этой последовательности.
    Символы CharSequence параметр добавляется, в порядке, увеличивая длину этой последовательности длиной параметра.
    Результатом этого метода является точно то же самое, как будто это был вызов this.append (s, 0, s.length ());
    Этот метод синхронизируется на этом (место назначения) возражают, но не синхронизируется на источнике (s).
    Если s null, тогда эти четыре символа "null" добавляются.
    
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    s - CharSequence добавлять.
    
    Возвраты:
    ссылка на этот объект.
    С тех пор:
    
    1.5
  - добавить
```
public StringBuffer 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()
    С тех пор:
    
    1.5
  - добавить
```
public StringBuffer append(char[] str)
```
    Добавляет строковое представление char параметр массива этой последовательности.
    Символы параметра массива добавляются, в порядке, к содержанию этой последовательности. Длина этой последовательности увеличивается длиной параметра.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(char[]), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    str - символы, которые будут добавлены.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer 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 StringBuffer append(boolean b)
```
    Добавляет строковое представление boolean параметр последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(boolean), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    b - a boolean.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer append(char c)
```
    Добавляет строковое представление char параметр этой последовательности.
    Параметр добавляется к содержанию этой последовательности. Длина этой последовательности увеличивается 1.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(char), и символ в той строке был тогда appended к этой символьной последовательности.
    
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    c - a char.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer append(int i)
```
    Добавляет строковое представление int параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(int), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    i - int.
    
    Возвраты:
    ссылка на этот объект.
  - appendCodePoint
```
public StringBuffer appendCodePoint(int codePoint)
```
    Добавляет строковое представление codePoint параметр этой последовательности.
    Параметр добавляется к содержанию этой последовательности. Длина этой последовательности увеличивается Character.charCount(codePoint).
    Полный эффект состоит точно в том, как будто параметр был преобразован в a char массив методом Character.toChars(int) и символ в том массиве был тогда appended к этой символьной последовательности.
    
    Параметры:
    codePoint - кодовая точка Unicode
    
    Возвраты:
    ссылка на этот объект.
    С тех пор:
    
    1.5
  - добавить
```
public StringBuffer append(long lng)
```
    Добавляет строковое представление long параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(long), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    lng - a long.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer append(float f)
```
    Добавляет строковое представление float параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(float), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    f - a float.
    
    Возвраты:
    ссылка на этот объект.
  - добавить
```
public StringBuffer append(double d)
```
    Добавляет строковое представление double параметр этой последовательности.
    Полный эффект состоит точно в том, как будто параметр был преобразован в строку методом String.valueOf(double), и символы той строки были тогда appended к этой символьной последовательности.
    
    Параметры:
    d - a double.
    
    Возвраты:
    ссылка на этот объект.
  - удалить
```
public StringBuffer delete(int start,
                  int end)
```
    Удаляет символы в подстроке этой последовательности. Подстрока начинается в указанном start и расширяется на символ по индексу end - 1 или до конца последовательности, если никакой такой символ не существует. Если start равно end, никакие изменения не производятся.
    
    Параметры:
    start - Начинающийся индекс, включительно.
    end - Конечный индекс, монопольный.
    
    Возвраты:
    Этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если start отрицательно, больше чем length(), или больше чем end.
    С тех пор:
    
    1.2
  - deleteCharAt
```
public StringBuffer deleteCharAt(int index)
```
    Удаляет char в указанной позиции в этой последовательности. Эта последовательность сокращается одним char.
    Отметьте: Если символ по данному индексу является дополнительным символом, этот метод не удаляет весь символ. Если корректная обработка дополнительных символов требуется, определите число chars, чтобы удалить, вызывая Character.charCount(thisSequence.codePointAt(index)), где thisSequence эта последовательность.
    
    Параметры:
    index - Индекс char удалить
    
    Возвраты:
    Этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если index отрицательно или больше чем или равен length().
    С тех пор:
    
    1.2
  - замена
```
public StringBuffer replace(int start,
                   int end,
                   String str)
```
    Заменяет символы в подстроке этой последовательности с символами в указанном String. Подстрока начинается в указанном start и расширяется на символ по индексу end - 1 или до конца последовательности, если никакой такой символ не существует. Сначала символы в подстроке удаляются и затем указанное String вставляется в start. (Эта последовательность будет удлинена, чтобы разместить указанную Строку в случае необходимости.)
    
    Параметры:
    start - Начинающийся индекс, включительно.
    end - Конечный индекс, монопольный.
    str - Строка, которая заменит предыдущее содержание.
    
    Возвраты:
    Этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если start отрицательно, больше чем length(), или больше чем end.
    С тех пор:
    
    1.2
  - подстрока
```
public String substring(int start)
```
    Возвращает новое String это содержит подпоследовательность символов, в настоящий момент содержавшихся в этой символьной последовательности. Подстрока начинается по указанному индексу и расширяется до конца этой последовательности.
    
    Параметры:
    start - Начинающийся индекс, включительно.
    
    Возвраты:
    Новая строка.
    
    Броски:
    
    StringIndexOutOfBoundsException - если start меньше чем нуль, или больше чем длина этого объекта.
    С тех пор:
    
    1.2
  - подпоследовательность
```
public CharSequence subSequence(int start,
                       int end)
```
    Возвращает новую символьную последовательность, которая является подпоследовательностью этой последовательности.
    Вызов этого метода формы
    sb.subSequence(begin, end)
    ведет себя точно таким же образом как вызов
    sb.substring(begin, end)
    Этот метод обеспечивается так, чтобы этот класс мог реализовать CharSequence интерфейс.
    Определенный:
    
    subSequence в интерфейсе CharSequence
    
    Параметры:
    start - индекс запуска, включительно.
    end - индекс конца, монопольный.
    
    Возвраты:
    указанная подпоследовательность.
    
    Броски:
    
    IndexOutOfBoundsException - если start или end отрицательны, если end больше чем length(), или если start больше чем end
    С тех пор:
    
    1.4
  - подстрока
```
public String substring(int start,
               int end)
```
    Возвращает новое String это содержит подпоследовательность символов, в настоящий момент содержавшихся в этой последовательности. Подстрока начинается в указанном start и расширяется на символ по индексу end - 1.
    
    Параметры:
    start - Начинающийся индекс, включительно.
    end - Конечный индекс, монопольный.
    
    Возвраты:
    Новая строка.
    
    Броски:
    
    StringIndexOutOfBoundsException - если start или end отрицательны или больше чем length(), или start больше чем end.
    С тех пор:
    
    1.2
  - вставить
```
public StringBuffer 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.
    С тех пор:
    
    1.2
  - вставить
```
public StringBuffer insert(int offset,
                  Object obj)
```
    Вставляет строковое представление Object параметр в эту символьную последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(Object), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    obj - Object.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer 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 StringBuffer insert(int offset,
                  char[] str)
```
    Вставляет строковое представление char параметр массива в эту последовательность.
    Символы параметра массива вставляются в содержание этой последовательности в позиции, обозначенной offset. Длина этой последовательности увеличивается длиной параметра.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(char[]), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    str - символьный массив.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer insert(int dstOffset,
                  CharSequence s)
```
    Вставляет указанное CharSequence в эту последовательность.
    Символы CharSequence параметр вставляется, в порядке, в эту последовательность при обозначенном смещении, перемещая любые символы вверх первоначально выше той позиции и увеличивая длину этой последовательности длиной параметра s.
    Результатом этого метода является точно то же самое, как будто это был вызов этого объекта insert(dstOffset, s, 0, s.length ()) метод.
    Если s null, тогда эти четыре символа "null" вставляются в эту последовательность.
    
    Параметры:
    dstOffset - смещение.
    s - последовательность, которая будет вставлена
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если смещение недопустимо.
    С тех пор:
    
    1.5
  - вставить
```
public StringBuffer 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()
    С тех пор:
    
    1.5
  - вставить
```
public StringBuffer insert(int offset,
                  boolean b)
```
    Вставляет строковое представление boolean параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(boolean), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    b - a boolean.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer insert(int offset,
                  char c)
```
    Вставляет строковое представление char параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(char), и символ в той строке был тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    c - a char.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    IndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer insert(int offset,
                  int i)
```
    Вставляет строковое представление второго int параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(int), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    i - int.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer insert(int offset,
                  long l)
```
    Вставляет строковое представление long параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(long), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    l - a long.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer insert(int offset,
                  float f)
```
    Вставляет строковое представление float параметр в эту последовательность.
    Полный эффект состоит точно в том, как будто второй параметр был преобразован в строку методом String.valueOf(float), и символы той строки были тогда inserted в эту символьную последовательность при обозначенном смещении.
    offset параметр должен быть больше чем или равным 0, и меньше чем или равный длине этой последовательности.
    
    Параметры:
    offset - смещение.
    f - a float.
    
    Возвраты:
    ссылка на этот объект.
    
    Броски:
    
    StringIndexOutOfBoundsException - если смещение недопустимо.
  - вставить
```
public StringBuffer 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.
    С тех пор:
    
    1.4
  - 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.
    С тех пор:
    
    1.4
  - lastIndexOf
```
public int lastIndexOf(String str)
```
    Возвращает индекс в пределах этой строки самого правого возникновения указанной подстроки. Самая правая пустая строка "", как полагают, происходит в индексном значении this.length(). Возвращенный индекс является самым большим значением k так, что
    this.toString().startsWith(str, k)
    истина.
    Параметры:
    str - подстрока, чтобы искать.
    
    Возвраты:
    если строковый параметр происходит один или более раз как подстрока в пределах этого объекта, то индекс первого символа последнего такая подстрока возвращается. Если это не происходит как подстрока, -1 возвращается.
    
    Броски:
    
    NullPointerException - если str null.
    С тех пор:
    
    1.4
  - 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.
    Since:
    
    1.4
  - reverse
```
public StringBuffer 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.
    Since:
    
    JDK1.0.2
  - 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.

Представьте ошибку или функцию
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.

Класс StringBuffer

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

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

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

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

StringBuffer

StringBuffer

StringBuffer

StringBuffer

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

длина

емкость

ensureCapacity

trimToSize

setLength

charAt

codePointAt

codePointBefore

codePointCount

offsetByCodePoints

getChars

setCharAt

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

добавить

appendCodePoint

добавить

добавить

добавить

удалить

deleteCharAt

замена

подстрока

подпоследовательность

подстрока

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

вставить

indexOf

indexOf

lastIndexOf

lastIndexOf

reverse

toString