Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class StringBuffer extends Object implements Serializable, CharSequence
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)
.
Всякий раз, когда работа происходит, включая исходную последовательность (такую как добавление или вставка от исходной последовательности), этот class синхронизирует только на строковом буфере выполнение работы, не на источнике. Отметьте это в то время как StringBuffer
разрабатывается, чтобы быть безопасным использовать одновременно от многократных потоков, если конструктор или append
или insert
работу передают исходная последовательность, которая совместно используется через потоки, код вызова должен гарантировать, что у работы есть непротиворечивое и неизменное представление исходной последовательности для продолжительности работы. Это могло быть удовлетворено вызывающей стороной, содержащей блокировку во время вызова работы, при использовании неизменной исходной последовательности, или не совместно используя исходную последовательность через потоки.
У каждого строкового буфера есть емкость. Пока длина символьной последовательности, содержавшейся в строковом буфере, не превышает емкость, не необходимо выделить новый внутренний буферный массив. Если внутреннее переполнение буфера, это автоматически делается больше.
Если не указано иное, передача a null
параметр конструктору или методу в этом class вызовет a NullPointerException
быть брошенным.
С выпуска JDK 5, этот class был добавлен с эквивалентным class, разработанным для использования единственным потоком, StringBuilder
. StringBuilder
class должен обычно использоваться в предпочтении к этому, поскольку он поддерживает все те же самые операции, но это быстрее, поскольку он не выполняет синхронизации.
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()
Попытки уменьшить хранение, используемое для символьной последовательности.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
chars, codePoints
public StringBuffer()
public StringBuffer(int capacity)
capacity
- начальная емкость.NegativeArraySizeException
- если capacity
параметром являются меньше чем 0
.public StringBuffer(String str)
16
плюс длина строкового параметра.str
- начальное содержание буфера.public StringBuffer(CharSequence seq)
CharSequence
. Начальная емкость строкового буфера 16
плюс длина CharSequence
параметр. Если длина указанного CharSequence
меньше чем или равно нулю, затем пустой буфер емкости 16
возвращается.
seq
- последовательность, чтобы скопировать.public int length()
length
в интерфейсе CharSequence
public int capacity()
public void ensureCapacity(int minimumCapacity)
minimumCapacity
параметр. 2
. minimumCapacity
параметр неположителен, этот метод не предпринимает мер и просто возвращается. Отметьте, что последующие операции на этом объекте могут уменьшить фактическую емкость ниже, которое требуют здесь.minimumCapacity
- минимальная требуемая емкость.public void trimToSize()
capacity()
метод.public void setLength(int newLength)
newLength
, символ в индексирует k в новой символьной последовательности, то же самое, поскольку символ в индексирует k в старой последовательности, если k является меньше чем длина старой символьной последовательности; иначе, это - нулевой символ '\u0000'
. Другими словами, если newLength
параметром являются меньше чем текущая длина, длина изменяется на указанную длину. Если newLength
параметр больше чем или равен текущей длине, достаточные нулевые символы ('\u0000'
) добавляются так, чтобы длина стала newLength
параметр.
newLength
параметр должен быть больше чем или равным 0
.
newLength
- новая длинаIndexOutOfBoundsException
- если newLength
параметр отрицателен.length()
public char charAt(int index)
char
значение в этой последовательности в указанном индексирует. Первое char
значение в, индексируют 0
, следующие в индексируют 1
, и так далее, как в индексации массива. Индексировать параметр должен быть больше чем или равным 0
, и меньше чем длина этой последовательности.
Если char
значение, определенное индексированием, является заместителем, суррогатное значение возвращается.
charAt
в интерфейсе CharSequence
index
- индексирование требуемого char
значение.char
значение в указанном индексирует.IndexOutOfBoundsException
- если index
отрицательно или больше чем или равен length()
.length()
public int codePointAt(int index)
char
значения (элементы кода Unicode) и диапазоны от 0
к length()
- 1
. Если char
значение, определенное в данном, индексирует, находится в высоко-суррогатном диапазоне, следующее индексируют, меньше чем длина этой последовательности, и char
значение в следующем индексирует, находится в диапазоне низкого заместителя, тогда дополнительная кодовая точка, соответствующая этой суррогатной паре, возвращается. Иначе, char
значение в данном индексирует, возвращается.
index
- индексирование к char
значенияindex
public int codePointBefore(int index)
char
значения (элементы кода Unicode) и диапазоны от 1
к length()
. Если char
значение в (index - 1)
находится в диапазоне низкого заместителя, (index - 2)
не отрицательно, и char
значение в (index - 2)
находится в высоко-суррогатном диапазоне, тогда дополнительное значение кодовой точки суррогатной пары возвращается. Если char
значение в index - 1
непарный низкий заместитель или высокий заместитель, суррогатное значение возвращается.
index
- индексирование после кодовой точки, которая должна быть возвращенаpublic int codePointCount(int beginIndex, int endIndex)
beginIndex
и расширяется на char
в индексируют endIndex - 1
. Таким образом длина (в char
s) из текста диапазон endIndex-beginIndex
. Непарные заместители в пределах этой последовательности рассчитывают как одна кодовая точка каждый.beginIndex
- индексирование к первому char
из текстового диапазона.endIndex
- индексирование после последнего char
из текстового диапазона.public int offsetByCodePoints(int index, int codePointOffset)
index
codePointOffset
кодовые точки. Непарные заместители в пределах текстового диапазона, данного index
и codePointOffset
рассчитайте как одна кодовая точка каждый.index
- индексирование, которое будет смещеноcodePointOffset
- смещение в кодовых точках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
.IndexOutOfBoundsException
- если какое-либо следующее является истиной: srcBegin
отрицательно dstBegin
отрицательно srcBegin
параметр больше чем srcEnd
параметр. srcEnd
больше чем this.length()
. dstBegin+srcEnd-srcBegin
больше чем dst.length
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
добавлять.public StringBuffer append(CharSequence s)
CharSequence
к этой последовательности. Символы CharSequence
параметр добавляется, в порядке, увеличивая длину этой последовательности длиной параметра.
Результатом этого метода является точно то же самое, как будто это был вызов this.append (s, 0, s.length ());
Этот метод синхронизируется на this
, целевой объект, но не синхронизируется на источнике (s
).
Если s
null
, тогда эти четыре символа "null"
добавляются.
append
в интерфейсе Appendable
s
- CharSequence
добавлять.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()
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
- число char
s, чтобы добавить.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
.public StringBuffer appendCodePoint(int codePoint)
codePoint
параметр этой последовательности. Параметр добавляется к содержанию этой последовательности. Длина этой последовательности увеличивается Character.charCount(codePoint)
.
Полный эффект состоит точно в том, как будто параметр был преобразован в a char
массив методом Character.toChars(int)
и символ в том массиве был тогда appended
к этой символьной последовательности.
codePoint
- кодовая точка Unicodepublic 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
.public StringBuffer deleteCharAt(int index)
char
в указанной позиции в этой последовательности. Эта последовательность сокращается одним char
. Отметьте: Если символ в данном индексирует, дополнительный символ, этот метод не удаляет весь символ. Если корректная обработка дополнительных символов требуется, определите число char
s, чтобы удалить, вызывая Character.charCount(thisSequence.codePointAt(index))
, где thisSequence
эта последовательность.
index
- Индексируйте char
удалитьStringIndexOutOfBoundsException
- если index
отрицательно или больше чем или равен length()
.public StringBuffer replace(int start, int end, String str)
String
. Подстрока начинается в указанном start
и расширяется на символ в, индексируют end - 1
или до конца последовательности, если никакой такой символ не существует. Сначала символы в подстроке удаляются и затем указанное String
вставляется в start
. (Эта последовательность будет удлинена, чтобы разместить указанную Строку в случае необходимости.)start
- Начало индексирует, включительно.end
- Окончание индексирует, монопольный.str
- Строка, которая заменит предыдущее содержание.StringIndexOutOfBoundsException
- если start
отрицательно, больше чем length()
, или больше чем end
.public String substring(int start)
String
это содержит подпоследовательность символов, в настоящий момент содержавшихся в этой символьной последовательности. Подстрока начинается в указанном, индексируют, и расширяется до конца этой последовательности.start
- Начало индексирует, включительно.StringIndexOutOfBoundsException
- если start
меньше чем нуль, или больше чем длина этого объекта.public CharSequence subSequence(int start, int end)
Вызов этого метода формы
ведет себя точно таким же образом как вызовsb.subSequence(begin, end)
Этот метод обеспечивается так, чтобы этот class мог реализоватьsb.substring(begin, end)
CharSequence
интерфейс. subSequence
в интерфейсе CharSequence
start
- запуск индексирует, включительно.end
- конец индексирует, монопольный.IndexOutOfBoundsException
- если start
или end
отрицательны, если end
больше чем length()
, или если start
больше чем end
public String substring(int start, int end)
String
это содержит подпоследовательность символов, в настоящий момент содержавшихся в этой последовательности. Подстрока начинается в указанном start
и расширяется на символ в, индексируют end - 1
.start
- Начало индексирует, включительно.end
- Окончание индексирует, монопольный.StringIndexOutOfBoundsException
- если start
или end
отрицательны или больше чем length()
, или start
больше чем end
.public StringBuffer insert(int index, char[] str, int offset, int len)
str
параметр массива в эту последовательность. Подмассив начинается в указанном offset
и расширяется len
char
s. Символы подмассива вставляются в эту последовательность в позиции, обозначенной index
. Длина этой последовательности увеличивается len
char
s.index
- позиция, в которой можно вставить подмассив.str
- A char
массив.offset
- индексирование первого char
в подмассиве, который будет вставлен.len
- число char
s в подмассиве, который будет вставлен.StringIndexOutOfBoundsException
- если index
отрицательно или больше чем length()
, или offset
или len
отрицательны, или (offset+len)
больше чем str.length
.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 в новой символьной последовательности, равно:
offset
-offset
в параметре str
, если k не является меньше чем offset
но меньше чем offset+str.length()
-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
- если смещение недопустимо.public StringBuffer insert(int dstOffset, CharSequence s, int start, int end)
CharSequence
в эту последовательность. Подпоследовательность параметра s
определенный start
и end
вставляются, в порядке, в эту последовательность при указанном целевом смещении, перемещая любые символы вверх первоначально выше той позиции. Длина этой последовательности увеличивается end - start
.
Символ в индексирует k в этой последовательности, становится равным:
dstOffset
+start-dstOffset
в параметре s
, если k больше чем или равен dstOffset
но меньше чем dstOffset+end-start
-(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 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
- если смещение недопустимо.public int indexOf(String str)
this.toString().startsWith(str, k)
true
.str
- любая строка.-1
возвращается.public int indexOf(String str, int fromIndex)
k
для которого: Если никакое такое значение k не существует, то-1 возвращается.k >= Math.min(fromIndex, str.length()) && this.toString().startsWith(str, k)
str
- подстрока, которую можно искать.fromIndex
- индексирование, с которого можно запустить поиск.public int lastIndexOf(String str)
this.length()
. Возвращенные индексируют, самое большое значение k так, что истина.this.toString().startsWith(str, k)
str
- подстрока, чтобы искать.-1
возвращается.public int lastIndexOf(String str, int fromIndex)
If no such value of k exists, then -1 is returned.k <= Math.min(fromIndex, str.length()) && this.toString().startsWith(str, k)
str
- the substring to search for.fromIndex
- the index to start the search from.public StringBuffer reverse()
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.
public String toString()
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
.toString
in interface CharSequence
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, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92