Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class StringBuilder extends Object implements Serializable, CharSequence
StringBuffer
, но без гарантии синхронизации. Этот class разрабатывается для использования в качестве понижения замены для StringBuffer
в местах, где строковый буфер использовался единственным потоком (как обычно имеет место). Где только возможно рекомендуется, чтобы этот class использовался в предпочтении к 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
использоваться.
Если не указано иное, передача a null
параметр конструктору или методу в этом class вызовет a NullPointerException
быть брошенным.
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()
Попытки уменьшить хранение, используемое для символьной последовательности.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
charAt, chars, codePoints, length, subSequence
public StringBuilder()
public StringBuilder(int capacity)
capacity
параметр.capacity
- начальная емкость.NegativeArraySizeException
- если capacity
параметром являются меньше чем 0
.public StringBuilder(String str)
16
плюс длина строкового параметра.str
- начальное содержание буфера.public StringBuilder(CharSequence seq)
CharSequence
. Начальная емкость строкового разработчика 16
плюс длина CharSequence
параметр.seq
- последовательность, чтобы скопировать.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
В зависимости от которого class реализует символьную последовательность csq, вся последовательность не может быть добавлена. Например, если csq является a CharBuffer
тогда подпоследовательность, чтобы добавить определяется позицией буфера и пределом.
append
в интерфейсе Appendable
s
- Символьная последовательность, чтобы добавить. Если csq является null, то эти четыре символа "null" добавляются к этому 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
- число char
s, чтобы добавить.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
.public StringBuilder appendCodePoint(int codePoint)
codePoint
параметр этой последовательности. Параметр добавляется к содержанию этой последовательности. Длина этой последовательности увеличивается Character.charCount(codePoint)
.
Полный эффект состоит точно в том, как будто параметр был преобразован в a char
массив методом Character.toChars(int)
и символ в том массиве был тогда appended
к этой символьной последовательности.
codePoint
- кодовая точка Unicodepublic StringBuilder delete(int start, int end)
start
и расширяется на символ в, индексируют end - 1
или до конца последовательности, если никакой такой символ не существует. Если start
равно end
, никакие изменения не производятся.start
- Начало индексирует, включительно.end
- Окончание индексирует, монопольный.StringIndexOutOfBoundsException
- если start
отрицательно, больше чем length()
, или больше чем end
.public StringBuilder deleteCharAt(int index)
char
в указанной позиции в этой последовательности. Эта последовательность сокращается одним char
. Отметьте: Если символ в данном индексирует, дополнительный символ, этот метод не удаляет весь символ. Если корректная обработка дополнительных символов требуется, определите число char
s, чтобы удалить, вызывая 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
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 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 в новой символьной последовательности, равно:
offset
-offset
в параметре str
, если k не является меньше чем offset
но меньше чем offset+str.length()
-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 в этой последовательности, становится равным:
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 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
- если смещение недопустимо.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 StringBuilder 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
public int length()
length
in interface CharSequence
public int capacity()
public void ensureCapacity(int minimumCapacity)
minimumCapacity
argument.
2
.
minimumCapacity
argument is nonpositive, this
method takes no action and simply returns.
Note that subsequent operations on this object can reduce the
actual capacity below that requested here.minimumCapacity
- the minimum desired capacity.public void trimToSize()
capacity()
method.public void setLength(int newLength)
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
.
newLength
- the new lengthIndexOutOfBoundsException
- if the
newLength
argument is negative.public char charAt(int index)
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.
charAt
in interface CharSequence
index
- the index of the desired char
value.char
value at the specified index.IndexOutOfBoundsException
- if index
is
negative or greater than or equal to length()
.public int codePointAt(int index)
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.
index
- the index to the char
valuesindex
IndexOutOfBoundsException
- if the index
argument is negative or not less than the length of this
sequence.public int codePointBefore(int index)
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.
index
- the index following the code point that should be returnedIndexOutOfBoundsException
- if the index
argument is less than 1 or greater than the length
of this sequence.public int codePointCount(int beginIndex, int endIndex)
beginIndex
and extends to the char
at
index endIndex - 1
. Thus the length (in
char
s) of the text range is
endIndex-beginIndex
. Unpaired surrogates within
this sequence count as one code point each.beginIndex
- the index to the first char
of
the text range.endIndex
- the index after the last char
of
the text range.IndexOutOfBoundsException
- if the
beginIndex
is negative, or endIndex
is larger than the length of this sequence, or
beginIndex
is larger than endIndex
.public int offsetByCodePoints(int index, int codePointOffset)
index
by codePointOffset
code
points. Unpaired surrogates within the text range given by
index
and codePointOffset
count as
one code point each.index
- the index to be offsetcodePointOffset
- the offset in code pointsIndexOutOfBoundsException
- 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.public void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)
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
srcBegin
- start copying at this offset.srcEnd
- stop copying at this offset.dst
- the array to copy the data into.dstBegin
- offset into dst
.IndexOutOfBoundsException
- if any of the following is true:
srcBegin
is negative
dstBegin
is negative
srcBegin
argument is greater than
the srcEnd
argument.
srcEnd
is greater than
this.length()
.
dstBegin+srcEnd-srcBegin
is greater than
dst.length
public void setCharAt(int index, char ch)
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.
index
- the index of the character to modify.ch
- the new character.IndexOutOfBoundsException
- if index
is
negative or greater than or equal to length()
.public String substring(int start)
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.start
- The beginning index, inclusive.StringIndexOutOfBoundsException
- if start
is
less than zero, or greater than the length of this object.public CharSequence subSequence(int start, int end)
An invocation of this method of the form
behaves in exactly the same way as the invocationsb.subSequence(begin, end)
This method is provided so that this class can implement thesb.substring(begin, end)
CharSequence
interface. subSequence
in interface CharSequence
start
- the start index, inclusive.end
- the end index, exclusive.IndexOutOfBoundsException
- if start
or end
are negative,
if end
is greater than length()
,
or if start
is greater than end
public String substring(int start, int end)
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
.start
- The beginning index, inclusive.end
- The ending index, exclusive.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, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92