Все реализованные интерфейсы
Serializable ， CharSequence ， Comparable<String>
```
public final class String
extends Object
implements Serializable, Comparable<String>, CharSequence
```
StringКласс представляет строки. Все строковые литералы в программах Java, например"abc", являются экземплярами этого класса. Строки неизменяемые. Их значение нельзя изменить после создания. Строковые буферы поддерживают изменяемые строки. Объекты String неизменяемые, поэтому их можно совместно использовать. Например:
```
     String str = "abc";
 
```
эквивалентно:
```
     char data[] = {'a', 'b', 'c'};
     String str = new String(data);
 
```
Вот несколько примеров использования строк:
```
     System.out.println("abc");
     String cde = "cde";
     System.out.println("abc" + cde);
     String c = "abc".substring(2,3);
     String d = cde.substring(1, 2);
 
```
КлассStringвключает методы для проверки отдельных символов последовательности, сравнения строк, поиска в строках, извлечения подстрок и создания копии строки, где все символы переведены в верхний или нижний регистр. Сопоставление регистров основано на версии стандарта Unicode, заданной классомCharacter.
В языке Java оператор конкатенации строк (+) имеет специальную поддержку. Он также преобразует другие объекты в строки. Дополнительные сведения о конкатенации и преобразовании строк смотрите в спецификации языка Java.
Если не указано иное, передачаnullаргумента вnullконструктор или метод вNullPointerExceptionприводит к выбросу исключения
.StringКлассCharacterпредставляет строку в формате UTF-16, где дополнительные символы обозначаются суррогатными парами. Подробнее смотрите раздел Unicode Character Representations вchar. Значения индексов относятся кStringкодовым единицам, поэтому дополнительный символ занимает две позиции.

StringКласс предоставляет методы для обработки кодовых точек Unicode (то есть символов) и кодовых единиц Unicode (то естьcharметод со значением).
Если не указано иное, методы сравнения строк не учитывают региональные настройки.CollatorКласс предоставляет методы сравнения String с более точной гранулярностью и учётом региона.
Примечание к реализации: реализация оператора конкатенации строк определяется компилятором Java, если компилятор в итоге соответствует спецификации языка Java. Например,
javacКомпилятор реализует операторы.StringBuffer ， StringBuilder ，或java.lang.invoke.StringConcatFactoryЗависит от версии JDK. Преобразование строк обычно реализуется через методtoString , изObjectОпределён и наследуется всеми классами в Java.
Object.toString(),StringBuffer,StringBuilder,Charset, Serialized Form См. The Java™ Language Specification: 15.18.1 Оператор конкатенации строк +

字段汇总

Поле | Тип переменной | Поле | Описание

`static Comparator<String>`	`CASE_INSENSITIVE_ORDER`	Из`compareToIgnoreCase`Заказ `String`Сравнение объектов `compareToIgnoreCase` 。

构造方法摘要

构造方法
构造器	Описание
`String()`	Инициализирует newly созданный`String`объект так, чтобы он представлял пустую последовательность символов.
`String(byte[] bytes)`	Создаёт новый`String` 。
`String(byte[] ascii, int hibyte)`	Устарело. Этот метод некорректно преобразует байты в символы.
`String(byte[] bytes, int offset, int length)`	Создаёт новый`String` 。
`String(byte[] ascii, int hibyte, int offset, int count)`	Устарело. Этот метод неправильно преобразует байты в символы.
`String(byte[] bytes, int offset, int length, String charsetName)`	Метод декодирует указанный подмассив байтов с помощью указанной кодировки`String`и создает новый `String` 。
`String(byte[] bytes, int offset, int length, Charset charset)`	Метод декодирует указанный подмассив байтов с помощью указанного charset`String`и создает новую строку String.
`String(byte[] bytes, String charsetName)`	Метод создает новый`String`объект, декодируя указанный массив байтов с помощью указанной кодировки charset.
`String(byte[] bytes, Charset charset)`	Метод создает новый`String`объект, декодируя указанный массив байтов с помощью указанной кодировки charset.
`String(char[] value)`	Выделяет новый`String` , чтобы он представлял последовательность символов, содержащуюся сейчас в параметре-массиве символов.
`String(char[] value, int offset, int count)`	Выделяет новый`String` , который содержит символы из подмассива параметра-массива символов.
`String(int[] codePoints, int offset, int count)`	Выделяет новый`String`, который содержит символы из подмассива параметра-массива Unicode code point.
`String(String original)`	Инициализирует новый созданный`String`объект так, чтобы он представлял ту же последовательность символов, что и параметр. Другими словами, новая строка является копией строки-параметра.
`String(StringBuffer buffer)`	Выделяет новую строку, которая содержит последовательность символов, содержащуюся сейчас в параметре-буфере строк.
`String(StringBuilder builder)`	Выделяет новую строку, которая содержит последовательность символов, содержащуюся сейчас в параметре-построителе строк.

方法摘要

Все методы Статические методы Методы экземпляра Конкретные методы Устаревшие методы Переменные и типы Метод Описание

`char`	`charAt(int index)`	Возвращает значение по указанному индексу.`char`Значение.
`IntStream`	`chars()`	Возвращает поток`int`с нулевым расширением значений `char`из этой последовательности.
`int`	`codePointAt(int index)`	Возвращает символ (кодовую точку Unicode) по указанному индексу.
`int`	`codePointBefore(int index)`	Возвращает символ (кодовую точку Unicode) перед указанным индексом.
`int`	`codePointCount(int beginIndex, int endIndex)`	Возвращает этот`String`Количество кодовых точек Unicode в указанном диапазоне текста.
`IntStream`	`codePoints()`	Возвращает поток значений кодовых точек в этой последовательности.
`int`	`compareTo(String anotherString)`	Сравнивает две строки в лексикографическом порядке.
`int`	`compareToIgnoreCase(String str)`	Сравнивает две строки в лексикографическом порядке, игнорируя различия в регистре.
`String`	`concat(String str)`	Присоединяет указанную строку к концу этой строки.
`boolean`	`contains(CharSequence s)`	Возвращает true, только если эта строка содержит указанную последовательность значений char.
`boolean`	`contentEquals(CharSequence cs)`	Сравнивает эту строку с указанной`CharSequence` 。
`boolean`	`contentEquals(StringBuffer sb)`	Сравнивает эту строку с указанной`StringBuffer` 。
`static String`	`copyValueOf(char[] data)`	Эквивалентно`valueOf(char[])` 。
`static String`	`copyValueOf(char[] data, int offset, int count)`	Эквивалентно`valueOf(char[], int, int)` 。
`boolean`	`endsWith(String suffix)`	Проверяет, заканчивается ли эта строка указанным суффиксом.
`boolean`	`equals(Object anObject)`	Сравнивает эту строку с указанным объектом.
`boolean`	`equalsIgnoreCase(String anotherString)`	Сравнивает эту`String`с другой `String`, игнорируя регистр.
`static String`	`format(String format, Object... args)`	Возвращает отформатированную строку с использованием указанной строки формата и аргументов.
`static String`	`format(Locale l, String format, Object... args)`	Возвращает отформатированную строку с использованием указанной локали, строки формата и аргументов.
`byte[]`	`getBytes()`	Кодирует эту`String`в последовательность байтов, используя кодировку платформы по умолчанию, и сохраняет результат в новый массив байтов.
`void`	`getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)`	Устарело. Этот метод не преобразует символы в байты корректно.
`byte[]`	`getBytes(String charsetName)`	Кодирует эту`String`в последовательность байтов, используя указанную по имени кодировку, и сохраняет результат в новый массив байтов.
`byte[]`	`getBytes(Charset charset)`	Кодирует эту`String`в последовательность байтов, используя заданный charset, и сохраняет результат в новый массив байтов.
`void`	`getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)`	Копирует символы этой строки в целевой массив символов.
`int`	`hashCode()`	Возвращает хеш-код этой строки.
`int`	`indexOf(int ch)`	Возвращает индекс первого вхождения указанного символа в строке.
`int`	`indexOf(int ch, int fromIndex)`	Возвращает индекс первого вхождения указанного символа в этой строке. Поиск начинается с указанного индекса.
`int`	`indexOf(String str)`	Возвращает индекс первого вхождения указанной подстроки в строке.
`int`	`indexOf(String str, int fromIndex)`	Возвращает индекс первого вхождения указанной подстроки в строке. Поиск начинается с указанного индекса.
`String`	`intern()`	Возвращает каноническое представление строкового объекта.
`boolean`	`isBlank()`	Возвращает`white space`, если строка пуста или содержит только`true` кодовые точки, иначе возвращает `false` 。
`boolean`	`isEmpty()`	Возвращает`true`тогда и только тогда, когда`length()`является`0` 。
`static String`	`join(CharSequence delimiter, CharSequence... elements)`	Возвращает новую строку String, состоящую из копии`CharSequence elements`, соединённой с копией указанного `delimiter`.
`static String`	`join(CharSequence delimiter, Iterable<? extends CharSequence> elements)`	Возвращает новый`String`, состоящий из копии `String` , в которой `CharSequence elements`указанная `delimiter`копию.
`int`	`lastIndexOf(int ch)`	Возвращает индекс последнего вхождения указанного символа в строке.
`int`	`lastIndexOf(int ch, int fromIndex)`	Возвращает индекс последнего вхождения указанного символа в строке. Поиск начинается с указанного индекса и идёт назад.
`int`	`lastIndexOf(String str)`	Возвращает индекс последнего вхождения указанной подстроки в строке.
`int`	`lastIndexOf(String str, int fromIndex)`	Возвращает индекс последнего вхождения указанной подстроки в строке. Поиск начинается с указанного индекса и идёт назад.
`int`	`length()`	Возвращает длину этой строки.
`Stream<String>`	`lines()`	Возвращает поток строк, извлечённых из этой строки и разделённых терминаторами строк.
`boolean`	`matches(String regex)`	Проверяет, соответствует ли эта строка заданному regular expression.
`int`	`offsetByCodePoints(int index, int codePointOffset)`	Возвращает индекс в этой`String`строке. Индекс отсчитывается от заданного `index`смещения `codePointOffset`в кодовых точках.
`boolean`	`regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)`	Проверяет, равны ли области двух строк.
`boolean`	`regionMatches(int toffset, String other, int ooffset, int len)`	Проверяет, равны ли области двух строк.
`String`	`repeat(int count)`	Возвращает строку, значение которой является повторением этой строки`count`раз.
`String`	`replace(char oldChar, char newChar)`	Возвращает строку, в которой заменены все вхождения`oldChar`в этой строке `newChar` 。
`String`	`replace(CharSequence target, CharSequence replacement)`	Заменяет каждую подстроку этой строки, совпадающую с целевой литеральной последовательностью, на указанную литеральную последовательность замены.
`String`	`replaceAll(String regex, String replacement)`	Заменяет каждую подстроку этой строки, совпадающую с заданным regular expression, на заданную замену.
`String`	`replaceFirst(String regex, String replacement)`	Заменяет первую подстроку этой строки, совпадающую с заданным regular expression, на заданную замену.
`String[]`	`split(String regex)`	Разделяет эту строку по совпадениям с заданным regular expression.
`String[]`	`split(String regex, int limit)`	Разделяет эту строку по совпадениям с заданным regular expression.
`boolean`	`startsWith(String prefix)`	Проверяет, начинается ли эта строка с указанного префикса.
`boolean`	`startsWith(String prefix, int toffset)`	Проверяет, начинается ли подстрока этой строки с указанного индекса с указанного префикса.
`String`	`strip()`	Возвращает строку, значение которой равно этой строке без всех начальных и конечных`white space` 。
`String`	`stripLeading()`	Возвращает строку, значение которой равно этой строке без всех начальных`white space` 。
`String`	`stripTrailing()`	Возвращает строку, значение которой равно этой строке без всех конечных`white space` 。
`CharSequence`	`subSequence(int beginIndex, int endIndex)`	Возвращает последовательность символов, являющуюся подпоследовательностью этой последовательности.
`String`	`substring(int beginIndex)`	Возвращает строку, которая является подстрокой этой строки.
`String`	`substring(int beginIndex, int endIndex)`	Возвращает строку, которая является подстрокой этой строки.
`char[]`	`toCharArray()`	Преобразует эту строку в новый массив символов.
`String`	`toLowerCase()`	Преобразует все символы этой`String`строки в нижний регистр по правилам локали по умолчанию.
`String`	`toLowerCase(Locale locale)`	Преобразует эту строку по правилам заданной`Locale`的规则将此 `String`Все символы преобразуются в `Locale` 。
`String`	`toString()`	Этот объект (уже является строкой!)
`String`	`toUpperCase()`	Преобразует все символы этого`String`所有字符转换为大写。
`String`	`toUpperCase(Locale locale)`	Преобразует все символы этого`Locale`的规则将此 `String`所有字符转换为大写。
`String`	`trim()`	Возвращает строку со значением этой строки, удаляя все начальные и конечные пробелы. Пробел — это любой символ, кодовая точка которого меньше или равна`'U+0020'` (символ пробела).
`static String`	`valueOf(boolean b)`	Возвращает`boolean`参数的字符串表示形式。
`static String`	`valueOf(char c)`	Возвращает`char`参数的字符串表示形式。
`static String`	`valueOf(char[] data)`	Возвращает`char`строковое представление параметра массива.
`static String`	`valueOf(char[] data, int offset, int count)`	Возвращает`char`строковое представление указанного подмассива параметра массива.
`static String`	`valueOf(double d)`	Возвращает`double`参数的字符串表示形式。
`static String`	`valueOf(float f)`	Возвращает`float`参数的字符串表示形式。
`static String`	`valueOf(int i)`	Возвращает`int`参数的字符串表示形式。
`static String`	`valueOf(long l)`	Возвращает`long`参数的字符串表示形式。
`static String`	`valueOf(Object obj)`	Возвращает`Object`参数的字符串表示形式。

声明方法的类 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息
- CASE_INSENSITIVE_ORDER
```
public static final Comparator<String> CASE_INSENSITIVE_ORDER
```
  Сравнение объектов,compareToIgnoreCaseупорядоченноеStringс помощьюcompareToIgnoreCase。 Этот компаратор сериализуем. Обратите внимание, что компаратор не учитывает локаль. Поэтому сортировка для некоторых локалей может быть неудовлетворительной.
  CollatorКласс предоставляет сравнение с учётом локали.
  
  Начиная с версии: 1.2 См. также:
  Collator

构造方法详细信息
- String
```
public String()
```
  Инициализирует новый созданныйStringобъект, чтобы он представлял пустую последовательность символов. Обратите внимание, что строки неизменяемы, поэтому этот конструктор не нужен.
- String
```
public String(String original)
```
  Инициализирует newly созданныйStringобъект так, чтобы он представлял ту же последовательность символов, что и аргумент. Иначе говоря, newly созданная строка является копией строки-аргумента. Если явная копияoriginalне требуется, originalэтот конструктор использовать не нужно, потому что строки неизменяемы.
  Параметры
  original - A String
- String
```
public String(char[] value)
```
  Выделяет новыйStringобъект, чтобы он представлял последовательность символов, содержащуюся в аргументе-массиве символов. Содержимое массива копируется. Последующие изменения массива не влияют на newly созданную строку.
  Параметры
  value- начальное значение строки
- String
```
public String(char[] value,
              int offset,
              int count)
```
  Выделяет новыйStringобъект, содержащий символы из подмассива аргумента-массива символов.offset参数是子countмассива, а аргумент count参数指定子countмассива. Содержимое подмассива копируется. Последующие изменения массива не влияют на newly созданную строку.
  Параметры
  value- массив, служащий источником символов
  offset- начальное смещение
  count- длина. Исключения
  IndexOutOfBoundsException - 如果 offset为负数，则 count为负数，或 offset为大于 value.length - count
- String
```
public String(int[] codePoints,
              int offset,
              int count)
```
  Выделяет новыйStringобъект, содержащий символы из подмассива аргумента-массива кодовых точек Unicode.offset参数是子countмассива, а аргумент count参数指定子countмассива. Содержимое подмассива преобразуется вchars. Последующие измененияintмассива не влияют на newly созданную строку.
  Параметры
  codePoints- массив, служащий источником кодовых точек Unicode
  offset- начальное смещение
  count- Исключение длины
  IllegalArgumentException - Если в codePointsнайден любой недопустимый код Unicode
  IndexOutOfBoundsException - 如果 offset为负数，则 count为负数，或 offset为大于 codePoints.length - count
  Начиная с версии: 1.5
- String
```
@Deprecated(since="1.1")
public String(byte[] ascii,
              int hibyte,
              int offset,
              int count)
```
  Устарело. Этот метод неправильно преобразует байты в символы. Начиная с JDK 1.1, предпочтительный способ сделать это через
  Stringконструкторы, которые принимаютCharset, имя кодировки, или используют кодировку платформы по умолчанию.
  
  Выделяет новыйString, состоящий из подмассива массива 8-битных целых значений.
  offset参数是子countзадаёт индекс первого байта подмассива, count参数指定子count的长度。
  Каждыйbyteпри преобразовании подмассиваcharКак указанныйString(byte[],int)конструктор.
  
  Параметры
  ascii- байты, которые нужно преобразовать в символы
  hibyte- первые 8 бит каждого 16-битного кодового блока Unicode
  offset- начальное смещение
  count- длина. Исключения
  IndexOutOfBoundsException - 如果 offset为负数， count为负数，或 offsetотрицательный ascii.length - count
  Смотрите также:
  String(byte[], int),String(byte[], int, int, java.lang.String),String(byte[], int, int, java.nio.charset.Charset),String(byte[], int, int)Пожалуйста, пришлите текст для перевода.String(byte[], java.lang.String),String(byte[], java.nio.charset.Charset),String(byte[])
- String
```
@Deprecated(since="1.1")
public String(byte[] ascii,
              int hibyte)
```
  Устарело. Этот метод неправильно преобразует байты в символы. Начиная с JDK 1.1, предпочтительный способ — использовать
  Stringконструкторы, которые принимаютCharset, имя кодировки, или используют кодировку платформы по умолчанию.
  Выделяет новуюString, которая содержит символы из массива 8-битных целых значенийString. Каждый символ c в результирующей строке строится из соответствующего элемента b массива байтов, так что:
  c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))
  Параметры
  ascii- байты для преобразования в символы
  hibyte- старшие 8 бит каждого 16-битного кодового элемента Unicode. См. также:
  String(byte[], int, int, java.lang.String),String(byte[], int, int, java.nio.charset.Charset),String(byte[], int, int),String(byte[], java.lang.String),String(byte[], java.nio.charset.Charset),String(byte[])
- String
```
public String(byte[] bytes,
              int offset,
              int length,
              String charsetName)
       throws UnsupportedEncodingException
```
  Конструирует новуюString构造新的String. Длина новойStringзависит от кодировки, поэтому может не равняться длине подмассива. Если данные байты недопустимы в данной кодировке, поведение этого конструктора не определено. Когда нужен больший контроль над процессом декодирования, используйте класс
  CharsetDecoder.
  
  Параметры
  bytes- байты для декодирования в символы
  offset- индекс первого байта для декодирования
  length- количество байтов для декодирования
  charsetName- имя поддерживаемой charset. Исключения
  UnsupportedEncodingException- если указанная кодировка не поддерживается
  IndexOutOfBoundsException - 如果 offset为负数， length为负数，或 offset为大于 bytes.length - length
  Начиная с версии: 1.1
- String
```
public String(byte[] bytes,
              int offset,
              int length,
              Charset charset)
```
  Конструирует новуюString, декодируя указанный подмассив байтов с помощью charset. Длина новойStringзависит от кодировки, поэтому может не равняться длине подмассиваString. Этот метод всегда заменяет некорректные входные данные и несопоставимые последовательности символов строкой замены по умолчанию этой кодировки. Когда нужен больший контроль над процессом декодирования, используйте класс
  CharsetDecoder.
  
  Параметры
  bytes- байты для декодирования в символы
  offset- индекс первого байта для декодирования
  length- количество байтов для декодирования
  charset- Этот charset используется для декодированияbytes
  Исключение
  IndexOutOfBoundsException - 如果 offset为负数， length为负数，或 offset为大于 bytes.length - length
  Начиная с версии: 1.6
- String
```
public String(byte[] bytes,
              String charsetName)
       throws UnsupportedEncodingException
```
  Создайте новыйStringДекодирует массив байтов с использованием указанной кодировки charset.StringДлина является функцией набора символов и поэтому может не совпадать с длиной массива байтов. Поведение этого конструктора не определено, если заданные байты недопустимы в заданном наборе символов. Когда требуется больше контроля над процессом декодирования, используйте
  CharsetDecoderКласс.
  
  Параметры
  bytes- Байты для декодирования в символы
  charsetName- Название поддерживаемой кодировки, исключение
  UnsupportedEncodingException- Если указанная кодировка не поддерживается
- String
```
public String(byte[] bytes,
              Charset charset)
```
  Создайте новыйStringДекодирует массив байтов с использованием указанного charset.StringДлина является функцией набора символов и поэтому может не совпадать с длиной массива байтов. Этот метод всегда заменяет некорректные входные данные и несопоставимые последовательности символов строкой замены по умолчанию для данного charset. Когда требуется больше контроля над процессом декодирования, используйте
  CharsetDecoderКласс.
  
  Параметры
  bytesБайты для декодирования в символы
  charsetЭтот charset используется для декодированияbytes
  Начиная с версии: 1.6
- String
```
public String(byte[] bytes,
              int offset,
              int length)
```
  Создаёт новую строку путём декодирования указанного подмассива байтов с использованием набора символов платформы по умолчанию.StringНовый.StringДлина является функцией набора символов, поэтому может не совпадать с длиной подстроки.StringПоведение этого конструктора не определено, если заданные байты недопустимы в кодировке по умолчанию. Когда требуется больше контроля над процессом декодирования, используйте
  CharsetDecoderКласс.
  
  Параметры
  bytes- Байты для декодирования в символы
  offsetИндекс первого байта для декодирования
  lengthКоличество байтов для декодирования — ошибка
  IndexOutOfBoundsException - 如果 offset为负数，则 length为负数，或 offset为大于 bytes.length - length
  Начиная с версии: 1.1
- String
```
public String(byte[] bytes)
```
  Декодирует указанный массив байтов, используя набор символов платформы по умолчанию, и создаёт новыйString. Длина новогоStringзависит от набора символов, поэтому может не совпадать с длиной массива байтов. Поведение конструктора не определено, если заданные байты недопустимы в наборе символов по умолчанию. Для большего контроля над декодированием используйте класс
  CharsetDecoder.
  
  Параметры
  bytes- байты, которые декодируются в символы. Начиная с версии: 1.1
- String
```
public String(StringBuffer buffer)
```
  Выделяет новую строку, содержащую последовательность символов, которая сейчас находится в параметре-буфере строк. Содержимое буфера строк копируется. Последующие изменения буфера строк не влияют на новую строку.
  Параметры
  buffer - A StringBuffer
- String
```
public String(StringBuilder builder)
```
  Выделяет новую строку, содержащую последовательность символов, которая сейчас находится в параметре-конструкторе строк. Содержимое конструктора строк копируется. Последующие изменения конструктора строк не влияют на новую строку. Этот конструктор упрощает миграцию на
  StringBuilder. Получение строки из конструктора строк методомtoStringможет работать быстрее, поэтому обычно предпочтительнее.
  
  Параметры
  builder - A StringBuilder
  Начиная с версии: 1.5

方法详细信息

length
```
public int length()
```
Возвращает длину этой строки. Длина равна количеству Unicode code units в строке.
Specified by:
length在界面 CharSequence
Результат: длина последовательности символов, которую представляет этот объект.

isEmpty
```
public boolean isEmpty()
```
Возвращаетtrueтогда и только тогда, когдаlength()是 0 。
Результат
trueеслиlength()равно0 , иначе false
Начиная с версии: 1.6

charAt
```
public char charAt(int index)
```
Возвращает значениеcharпо указанному индексу. Индекс находится в диапазоне от0至length() - 1. Первыйchar值位于索引0 ， следующий находится по индексу1， и так далее, как индексы массива. Если
charзначение по указанному индексу является surrogate, возвращается указанное замещающее значение.

Specified by:
charAtв интерфейсе CharSequence
Параметры
index - charиндекс значения. Результат
charзначение по указанному индексу этой строки. Первоеchar值位于索引0. Исключения
IndexOutOfBoundsException - 如果 indexаргумент отрицательный или не меньше длины этой строки.

codePointAt
```
public int codePointAt(int index)
```
Возвращает символ (кодовую точку Unicode) по указанному индексу. Индекс ссылается наcharзначения (кодовые единицы Unicode) в диапазоне от0доlength() - 1. Если
charзначение по данному индексу находится в диапазоне старших суррогатов, следующий индекс меньше длины этойStringстроки, аcharзначение по следующему индексу находится в диапазоне младших суррогатов, возвращается дополнительная кодовая точка, соответствующая этой суррогатной паре. Иначе возвращаетсяchar值。

Параметры
index - charиндекс значения. Результат
indexзначение кодовой точки символа по данному индексу. Исключения
IndexOutOfBoundsException - 如果 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- index — индекс перед кодовой точкой Unicode, значение которой нужно вернуть. Исключения
IndexOutOfBoundsException - 如果 indexпараметр меньше 1 или больше длины этой строки. Начиная с версии: 1.5

codePointCount
```
public int codePointCount(int beginIndex,
                          int endIndex)
```
Возвращает количество кодовых точек Unicode в указанном текстовом диапазоне этойStringстроки. Текстовый диапазон начинается с указанногоbeginIndexзначения и продолжается доchar индексаendIndex - 1. Таким образом, длина текстового диапазона (вchar символах) равнаendIndex-beginIndex. Непарные суррогаты в текстовом диапазоне считаются по одной кодовой точке каждая.
Параметры
beginIndex - beginIndex — индекс первого charсимвола текстового диапазона.
endIndex - endIndex — индекс после последнего charсимвола текстового диапазона. Результат — количество кодовых точек Unicode в указанном текстовом диапазоне. Исключения
IndexOutOfBoundsException - 如果 beginIndex为负数，或者 endIndex大于此 String的长度，或者 beginIndex大于 endIndexendIndex. Начиная с версии: 1.5

offsetByCodePoints
```
public int offsetByCodePoints(int index,
                              int codePointOffset)
```
Возвращает индекс в этойStringстроке, смещённый от заданногоindex偏移codePointOffsetкодовых точек. Непарные суррогаты в текстовом диапазоне, заданномindex和codePointOffsetи
, считаются по одной кодовой точке каждая.
indexПараметры
codePointOffset- index — индекс, который нужно сместить
String
- codePointOffset — смещение в кодовых точках. Результат — индекс в этой
IndexOutOfBoundsException - 如果 index- если Stringindex отрицателен или больше длины этой codePointOffsetстроки, или если indexcodePointOffset положителен и подстрока, начинающаяся с codePointOffsetindex, содержит меньше кодовых точек, или если codePointOffsetОтрицательно и indexподстрока до этого содержит меньше, чем абсолютное значение codePointOffsetкодовых точек. Начиная с версии: 1.5

getChars
```
public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)
```
Копирует символы из этой строки в целевой массив символов. Первый копируемый символ имеет индекс
srcBegin; последний копируемый символ находится по индексуsrcEnd-1 (поэтому общее число копируемых символов равноsrcEnd-srcBegin). Символы копируются вdst的子dst从索引dstBeginНачинается с индекса и заканчивается им:
```
     dstBegin + (srcEnd-srcBegin) - 1
 
```
Параметры
srcBegin- Индекс первого символа копируемой части строки.
srcEnd- Индекс, следующий за последним символом копируемой части строки.
dst- Целевой массив.
dstBegin- Начальное смещение в целевом массиве. Исключения
IndexOutOfBoundsException- Если выполняется любое из следующих условий:
- srcBeginОтрицательное значение.
- srcBegin大于srcEnd
- srcEndБольше длины этой строки
- dstBegin是否定的
- dstBegin+(srcEnd-srcBegin)大于dst.length

getBytes
```
@Deprecated(since="1.1")
public void getBytes(int srcBegin,
                     int srcEnd,
                     byte[] dst,
                     int dstBegin)
```
Deprecated. This method does not properly convert characters into bytes. As of JDK 1.1, the preferred way to do this is via the
getBytes()метод, который использует кодировку платформы по умолчанию.
Копирует символы из этой строки в целевой массив байтов. Каждый байт получает 8 младших битов соответствующего символа. Восемь старших битов каждого символа не копируются и никак не участвуют в передаче. Первый копируемый символ имеет индекс
srcBegin; последний копируемый символ находится по индексуsrcEnd-1. Общее число копируемых символов равноsrcEnd-srcBegin. Символы, преобразованные в байты, копируются вdst的子dst从索引dstBeginи заканчивая индексом:
```
     dstBegin + (srcEnd-srcBegin) - 1
 
```
Параметры
srcBegin- индекс первого символа копируемой строки
srcEnd- индекс после последнего символа копируемой строки
dst- целевой массив
dstBegin- начальное смещение в целевом массиве Исключения
IndexOutOfBoundsException- если выполняется любое из условий:
- srcBegin是否定的
- srcBegin大于srcEnd
- srcEndбольше длины этой String
- dstBegin是否定的
- dstBegin+(srcEnd-srcBegin)大于dst.length

getBytes
```
public byte[] getBytes(String charsetName)
                throws UnsupportedEncodingException
```
Кодирует этуStringв последовательность байтов, используя указанную кодировку, и сохраняет результат в новый массив байтов. Поведение метода не определено, если эту строку нельзя закодировать в заданной кодировке. Когда нужен больший контроль над процессом кодирования, используйте класс
CharsetEncoder.

Параметры
charsetName- имя поддерживаемого charset. Результат: массив байтов результата. Исключения
UnsupportedEncodingException- если указанный charset не поддерживается. Начиная с версии: 1.1

getBytes
```
public byte[] getBytes(Charset charset)
```
Кодирует этуStringв последовательность байтов, используя заданный charset, и сохраняет результат в новый массив байтов. Метод всегда заменяет некорректный ввод и несопоставимые последовательности символов массивом байтов замены по умолчанию этого charset. Когда нужен больший контроль над процессом кодирования, используйте класс
CharsetEncoder.

Параметры
charset- Charset, используемый для кодированияString
Результат: массив байтов результата. Начиная с версии: 1.6

getBytes
```
public byte[] getBytes()
```
Кодирует этуStringв последовательность байтов, используя кодировку платформы по умолчанию, и сохраняет результат в новый массив байтов. Поведение метода не определено, если эту строку нельзя закодировать в кодировке по умолчанию. Когда нужен больший контроль над процессом кодирования, используйте класс
CharsetEncoder.

Результат: массив байтов результата. Начиная с версии: 1.1

equals
```
public boolean equals(Object anObject)
```
Сравнивает эту строку с указанным объектом. Результат равенnullтогда и только тогда, когда аргумент неStringи является объектомtrueпредставляющим ту же последовательность символов, что и этот объект. Для более точного сравнения строк смотрите
Collator.

Переопределяет:
equals在类 Object
Параметры
anObject - объект для сравнения StringРезультат
trueесли данный объект представляет Stringстроку, эквивалентную этой строке, falseиначе. Смотрите также:
compareTo(String),equalsIgnoreCase(String)

contentEquals
```
public boolean contentEquals(StringBuffer sb)
```
Сравнивает эту строку с указаннымStringBuffer. Результатtrue ， то есть если это толькоStringозначает, что символы образуют ту же последовательность, что и указаннаяStringBuffer. Этот метод синхронизируется наStringBuffer. Для более точного сравнения строк обратитесь к
Collator.

Параметры
sb - 用 StringBuffer来比较这 String
Результат
true如果此 Stringстрока представляет ту же последовательность символов, что и указанная StringBuffer, иначе false false
Начиная с версии: 1.4

contentEquals
```
public boolean contentEquals(CharSequence cs)
```
Сравнивает эту строку с указаннойCharSequence. Результат равен true тогда и только тогда, когда этаStringстрока представляет ту же последовательность значений char, что и указанная последовательностьtrue. Обратите внимание, что еслиCharSequence是StringBuffer, то метод синхронизируется на ней. Для более точного сравнения строк обратитесь к
Collator.

Параметры
cs - последовательность, с которой сравнивается эта Stringстрока. Результат
true如果此 Stringстрока представляет ту же последовательность значений char, что и указанная последовательность, иначе false false
Начиная с версии: 1.5

equalsIgnoreCase
```
public boolean equalsIgnoreCase(String anotherString)
```
Сравнивает этуStringстроку с другойStringстрокой, игнорируя регистр. Две строки считаются равными при игнорировании регистра, если они имеют одинаковую длину и соответствующие символы равны без учёта регистра. Два символа
c1和c2считаются одинаковыми при игнорировании регистра, если выполняется хотя бы одно из условий:
- два символа одинаковы (сравниваются оператором==)
- вызовCharacter.toLowerCase(Character.toUpperCase(char))для каждого символа даёт одинаковый результат
Обратите внимание, что этот метод не учитывает локаль и может давать неудовлетворительные результаты для конкретной локали.CollatorКласс предоставляет сравнение с учётом локали.
Параметры
anotherString - 用 String来比较这 StringРезультат сравнения.
trueЕсли аргумент неnullи он представляет эквивалентнуюStringстроку без учета регистра, иначеfalse
См. также:
equals(Object)

compareTo
```
public int compareTo(String anotherString)
```
Сравнивает две строки лексикографически. Сравнение основано на значении Unicode каждого символа строки. Символьная последовательность, представленная этимStringобъектом, сравнивается лексикографически с последовательностью символов строки-аргумента. Если этотStringобъект лексикографически предшествует строке-аргументу, результат — отрицательное целое число. Если этотStringобъект лексикографически следует за строкой-аргументом, результат — положительное целое число. Если строки равны, результат равен нулю.compareToВequals(Object)метод возвращает0точно возвращаетtrue. Это определение лексикографического порядка. Если две строки различны, то в некотором индексе у них разные символы. Этот индекс является допустимым индексом обеих строк, либо их длины различны, либо и то и другое. Если у них есть разные символы в одном или нескольких индексах, пусть k будет наименьшим таким индексом. Тогда строка, символ в позиции k которой имеет меньшее значение, определенное с помощью
<оператора, лексикографически предшествует другой строке. В этом случаеcompareToвозвращает разность значений двух символов в позицииkв двух строках,kто есть значение:
```
 this.charAt(k)-anotherString.charAt(k)
 
```
Если индексов с различающимися символами нет, то более короткая строка лексикографически предшествует более длинной. В этом случаеcompareToвозвращает разность длин строк, то есть значение:
```
 this.length()-anotherString.length()
 
```
Для более тонкого сравнения строк см.Collator.
Specified by:
compareToВ Comparable<String>
Параметры
anotherString - 待比较的 String. Результат Если строка-аргумент равна этой строке, значение
0; если эта строка лексикографически меньше строки-аргумента, значение меньше0; если эта строка лексикографически больше строки-аргумента, значение больше0.

compareToIgnoreCase
```
public int compareToIgnoreCase(String str)
```
Сравнивает две строки лексикографически, игнорируя различия в регистре. Этот метод возвращает целое число, знак которого совпадает со знаком вызоваcompareToс нормализованными версиями строк, где различия в регистре устранены вызовомCharacter.toLowerCase(Character.toUpperCase(character))для каждого символа. Обратите внимание, что этот метод не учитывает locale и может давать неудовлетворительный порядок для некоторых языков.
CollatorКласс предоставляет сравнение с учетом locale.

Параметры
str - 待比较的 String. Результат Отрицательное целое число, ноль или положительное целое число, если указанная String больше, равна или меньше этой String без учета регистра. Начиная с версии: 1.2 См. также:
Collator

regionMatches
```
public boolean regionMatches(int toffset,
                             String other,
                             int ooffset,
                             int len)
```
Проверяет, равны ли две области строк. Подстрока этого
Stringобъекта сравнивается с подстрокой параметра other. Если подстроки представляют одинаковую последовательность символов, результат равен true. Подстрока этогоString对象的子字符串从索引toffset开始，长度为len. Подстрока параметра other начинается с индексаooffset开始，长度为len. Результат равен true тогда и только тогда, когда выполняется хотя бы одно из условий:false:
- toffsetотрицательно.
- ooffsetотрицательно.
- toffset+len大于此Stringобъекта.
- ooffset+lenбольше длины другого параметра.
- Существует неотрицательное целое число k, меньшееlen , такое что: this.charAt(toffset + k ) != other.charAt(ooffset + k )
Обратите внимание, этот метод не учитывает локаль.CollatorКласс предоставляет сравнение с учётом локали.
Параметры
toffset - 此字符串 toffsetначальное смещение области.
other- строковый параметр.
ooffset - 字符串参数 ooffsetстрокового параметра.
len- количество сравниваемых символов. Результат
trueравен true, если указанная область этой строки полностью совпадает с указанной областью строкового параметра, иначе равенfalse.

regionMatches
```
public boolean regionMatches(boolean ignoreCase,
                             int toffset,
                             String other,
                             int ooffset,
                             int len)
```
Проверяет, равны ли две области строк. Подстрока этого
Stringобъекта сравнивается с подстрокой параметраother. Если подстроки представляют одинаковую последовательность символов, результат равенother, тогда и только тогда, когдаtrue равен true, регистр игнорируется. Подстрока этогоignoreCaseобъекта начинается с индексаString对象的子字符串从索引toffset开始，长度为lenначинается с индексаother从索引ooffset开始，长度为len. Результат равенfalseтогда и только тогда, когда выполняется хотя бы одно из следующих условий:
- toffsetотрицательно.
- ooffsetотрицательно.
- toffset+len大于此Stringобъекта.
- ooffset+lenбольше длины другого аргумента.
- ignoreCase是falseи существует неотрицательное целое число k, меньшееlenтакое, что:
  this.charAt(toffset+k) != other.charAt(ooffset+k)
- ignoreCase是trueи существует неотрицательное целое число k, меньшееlenтакое, что:
  Character.toLowerCase(Character.toUpperCase(this.charAt(toffset+k))) != Character.toLowerCase(Character.toUpperCase(other.charAt(ooffset+k)))
Обратите внимание, что этот метод не учитывает локаль и даёт неудовлетворительные результаты для определённых локалей, когдаignoreCase为true.CollatorКласс Collator выполняет сравнение с учётом локали.
Аргументы
ignoreCase - если равно true, при сравнении символов регистр игнорируется.
toffset - 此字符串 toffsetНачальное смещение области.
other- строковый аргумент.
ooffset - 字符串参数 ooffsetНачальное смещение области.
len- количество сравниваемых символов. Результат
trueравен true, если указанная подобласть этой строки совпадает с указанной подобластью строкового аргумента, иначе равенfalse. Совпадение точное или без учёта регистра зависит отignoreCaseаргумента.

startsWith
```
public boolean startsWith(String prefix,
                          int toffset)
```
Проверяет, начинается ли подстрока этой строки с указанного индекса с указанного префикса.
Аргументы
prefix- префикс.
toffset- с чего начать просмотр этой строки. Результат
trueравен true, если последовательность символов, заданная аргументом, является префиксом подстроки этого объекта, начинающейся с индексаtoffset, иначе равенfalse. Еслиtoffsetотрицательно или больше длины этогоStringобъекта, результат равенfalse; иначе результат совпадает с результатом выражения
```
  this.substring(toffset).startsWith(prefix) 
```

startsWith
```
public boolean startsWith(String prefix)
```
Проверяет, начинается ли эта строка с указанного префикса.
Параметры
prefix- префикс. Результат
truetrue, если последовательность символов, заданная аргументом, является префиксом последовательности символов этой строки; иначеfalsefalse. Также обратите внимание:trueесли аргумент — пустая строка или равен строке, будет возвращеноStringзначение, определяемое методомequals(Object)объекта. Начиная с версии: 1.0

endsWith
```
public boolean endsWith(String suffix)
```
Проверяет, заканчивается ли эта строка указанным суффиксом.
Параметры
suffix- суффикс. Результат
truetrue, если последовательность символов, заданная аргументом, является суффиксом последовательности символов этого объекта; иначеfalsefalse. Обратите внимание, что результат будетtruetrue, если аргумент — пустая строка или равен строкеStringэтого объекта, определяемой методомequals(Object).

hashCode
```
public int hashCode()
```
Возвращает хеш-код этой строки.StringХеш-код объекта вычисляется как
```
 s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
 
```
使用intарифметики, гдеs[i]— i-й символ строки,n— длина строки, ^обозначает возведение в степень. (Хеш-код пустой строки равен нулю.)
Переопределяет:
hashCode在类 Object
Результат: значение хеш-кода этого объекта. См. также:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)

indexOf
```
public int indexOf(int ch)
```
Возвращает индекс первого вхождения указанного символа в строке. Если символ со значениемStringвстречается в последовательности символов, которую представляет этотchобъект, возвращается индекс первого такого вхождения (в единицах кода Unicode). Для значений в диапазоне от 0 до 0xFFFF (включительно)chэто наименьшее значение k, при котором:
```
 this.charAt(k) == ch
 
```
истинно. Дляchдругих значений это наименьшее значение k, при котором:
```
 this.codePointAt(k) == ch
 
```
истинно. В любом случае, если такой символ не встречается в этой строке, возвращается-1 。
Параметры
ch- символ (кодовая точка Unicode). Результат: индекс первого вхождения символа в последовательность символов этого объекта, если символ не встречается,
-1.

indexOf
```
public int indexOf(int ch,
                   int fromIndex)
```
Возвращает индекс первого вхождения указанного символа в эту строку, начиная поиск с указанного индекса. Если в последовательности символов этого
fromIndex объекта существует символ со значениемString, то возвращается индекс первого такого вхождения. Для значенийchв диапазоне от 0 до 0xFFFF (включительно) это наименьшее значение k, при котором:chистинно. Для
```
 (this.charAt(k) == ch) && (k >= fromIndex)
 
```
других значений это наименьшее значение k, при котором:chистинно. В любом случае, если такой символ не встречается в строке в позиции
```
 (this.codePointAt(k) == ch) && (k >= fromIndex)
 
```
или позже, возвращаетсяfromIndex.-1 。
fromIndex.-1 。
значениях (кодовых единицах Unicode).charПараметры
- символ (кодовая точка Unicode).
ch- индекс, с которого начинается поиск. Результат: индекс первого вхождения символа в последовательность символов этого объекта, большего или равного
fromIndex, если символ не встречается,
fromIndex . -1.

lastIndexOf
```
public int lastIndexOf(int ch)
```
Возвращает индекс последнего вхождения указанного символа в строку. Для значенийchв диапазоне от 0 до 0xFFFF (включительно) chиндекс (в кодовых единицах Unicode) является наибольшим значением k, при котором:
```
 this.charAt(k) == ch
 
```
истинно. Дляchдругих значений это наибольшее значение k, при котором:
```
 this.codePointAt(k) == ch
 
```
истинно. В любом случае, если такой символ не встречается в этой строке, возвращается-1. Поиск ведётся с последнего символа назадString 。
Параметры
ch- символ (кодовая точка Unicode). Результат: индекс последнего вхождения символа в последовательность символов этого объекта, если символ не встречается,
-1.

lastIndexOf
```
public int lastIndexOf(int ch,
                       int fromIndex)
```
Возвращает индекс последнего вхождения указанного символа в строку, поиск ведётся назад от указанного индекса. Для значенийchв диапазоне от 0 до 0xFFFF (включительно) возвращаемый индекс является наибольшим значением k, при котором:
```
 (this.charAt(k) == ch) && (k <= fromIndex)
 
```
истинно. Дляchдругих значений это наибольшее значение k, при котором:
```
 (this.codePointAt(k) == ch) && (k <= fromIndex)
 
```
Это верно. В любом случае, если такой символ не встречается в этой строке в позицииfromIndexили раньше, возвращается-1. Все индексы задаются
charзначениями (единицами кода Unicode).
Параметры
ch- символ (кодовая точка Unicode).
fromIndex- индекс, с которого начинается поиск.fromIndexЗначение не ограничено. Если оно больше или равно длине строки, эффект такой же, как если бы оно равнялось длине минус один: поиск идёт по всей строке. Если оно отрицательное, эффект такой же, как при -1: возвращается -1. Результат: индекс последнего вхождения символа в последовательность символов, представляемую этим объектом, не превышающий
fromIndex , или -1, если символ до этой позиции не встречается, -1.

indexOf
```
public int indexOf(String str)
```
Возвращает индекс первого вхождения указанной подстроки в строку. Возвращаемый индекс — минимальное значение
k ，其中：
```
   this.startsWith(str, k)  
```
Если такого значенияk存在，那么-1返回。
Параметры
str- искомая подстрока. Результат: индекс первого вхождения указанной подстроки, или -1, если вхождения нет,
-1.

indexOf
```
public int indexOf(String str,
                   int fromIndex)
```
Возвращает индекс первого вхождения указанной подстроки в строку, начиная с указанного индекса. Возвращаемый индекс — минимальное значение
k ，其中：
```
   k >= Math.min(fromIndex, this.length()) && this.startsWith(str, k)  
```
Если такого значенияk存在，那么-1返回。
Параметры
str- искомая подстрока.
fromIndex- индекс, с которого начинается поиск. Результат: индекс первого вхождения указанной подстроки, начиная с указанного индекса, или -1, если вхождения нет
-1.

lastIndexOf
```
public int lastIndexOf(String str)
```
Возвращает индекс последнего вхождения указанной подстроки в строку. Последнее вхождение пустой строки "" считается происходящим при значении индексаthis.length(). Возвращаемый индекс — максимальное значение
k ，其中：
```
   this.startsWith(str, k)  
```
Если такого значенияk存在，那么-1返回。
Параметры
str- искомая подстрока. Результат: индекс последнего вхождения указанной подстроки, или -1, если вхождения нет,
-1.

lastIndexOf
```
public int lastIndexOf(String str,
                       int fromIndex)
```
Возвращает индекс последнего вхождения указанной подстроки в строке. Поиск начинается с указанного индекса и идёт назад. Возвращаемый индекс — максимальное значение
k ，其中：
```
   k <= Math.min(fromIndex, this.length()) && this.startsWith(str, k)  
```
если такого значенияk存在，那么-1返回。
Параметры
str- подстрока для поиска.
fromIndex- индекс, с которого начинается поиск. Результат Индекс последнего вхождения указанной подстроки при поиске назад от указанного индекса. Если вхождения нет, то
-1.

substring
```
public String substring(int beginIndex)
```
Возвращает строку, которая является подстрокой данной строки. Подстрока начинается с символа по указанному индексу и продолжается до конца строки. Пример:
```
 "unhappy".substring(2) returns "happy"
 "Harbison".substring(3) returns "bison"
 "emptiness".substring(9) returns "" (an empty string)
 
```
Параметры
beginIndex- начальный индекс, включительно. Результат Указанная подстрока. Исключения
IndexOutOfBoundsException - 如果 beginIndexотрицательное или больше длины этого Stringобъекта.

substring
```
public String substring(int beginIndex,
                        int endIndex)
```
Возвращает строку, которая является подстрокой данной строки. Подстрока начинается с указанногоbeginIndexи продолжается до символа с индексомendIndex - 1. Поэтому длина подстроки равнаendIndex-beginIndex. Пример:
```
 "hamburger".substring(4, 8) returns "urge"
 "smiles".substring(1, 5) returns "mile"
 
```
Параметры
beginIndex- начальный индекс, включительно.
endIndex- конечный индекс, не включительно. Результат Указанная подстрока. Исключения
IndexOutOfBoundsException - 如果 beginIndex为负数，或者 endIndex大于此 Stringобъекта, или beginIndex大于 endIndex.

subSequence
```
public CharSequence subSequence(int beginIndex,
                                int endIndex)
```
Возвращает последовательность символов, которая является подпоследовательностью данной последовательности. Вызов этого метода в форме
```
 str.subSequence(begin, end)
```
ведёт себя точно так же, как вызов
```
 str.substring(begin, end)
```
Specified by:
subSequence在界面 CharSequence
API Note: Этот метод определён, чтобы
Stringкласс мог реализоватьCharSequenceинтерфейс. Параметры
beginIndex- начальный индекс, включительно.
endIndex- конечный индекс, не включительно. Результат Указанная подпоследовательность. Исключения
IndexOutOfBoundsException - 如果 beginIndexили endIndexотрицательны, если endIndex大于 length() , или если beginIndex大于 endIndex
Начиная с версии: 1.4

concat
```
public String concat(String str)
```
Присоединяет указанную строку к концу этой строки. Если длина строки-аргумента равна
0 , возвращается этаStringобъект. Иначе возвращаетStringобъект, который представляет последовательность символов, образованнуюStringобъединением последовательности символов этого объекта и последовательности символов строки-параметра.
Пример:
```
 "cares".concat("s") returns "caress"
 "to".concat("get").concat("her") returns "together"
 
```
Параметры
str - Эта Stringприсоединяется к концу этого String. Результат: строка, представляющая символы этого объекта, за которыми следуют символы строкового параметра.

replace
```
public String replace(char oldChar,
                      char newChar)
```
возвращает строку, в которой заменены все вхожденияoldChar在此字符串newChar。 Если символ
oldCharВозникает последовательность символов, не проходящая через это представление.Stringобъекта, то этот базовый уровеньStringОбъект возвращается. В противном случае,StringВозвращаемый объект представляет последовательность символов, заданную этим представлением.StringКроме каждого вхождения объекта, oldCharЗамените возникшее событиеnewChar 。
Пример:
```
 "mesquite in your cellar".replace('e', 'o')
         returns "mosquito in your collar"
 "the war of baronets".replace('r', 'y')
         returns "the way of bayonets"
 "sparring with a purple porpoise".replace('p', 't')
         returns "starring with a turtle tortoise"
 "JonL".replace('q', 'x') returns "JonL" (no change)
 
```
Параметры
oldChar- старый символ.
newChar- новый символ. Результат
oldCharстрока, полученная из исходной строки путём oldChar ， newCharкаждого совпадения.

matches
```
public boolean matches(String regex)
```
Проверяет, соответствует ли эта строка заданному регулярному выражению. Вызов str
.matches(regex)этого метода в форме даёт точно такой же результат, как выражение

Pattern.matches(regex, str)

Параметры
regex- регулярное выражение, с которым сопоставляется эта строка Результат
truetrue тогда и только тогда, когда эта строка соответствует заданному регулярному выражению Исключения
PatternSyntaxException- если синтаксис регулярного выражения недопустим Начиная с версии: 1.4 См. также:
Pattern

contains
```
public boolean contains(CharSequence s)
```
Возвращает true тогда и только тогда, когда эта строка содержит указанную последовательность значений char.
Параметры
s- последовательность для поиска Результат true, если эта строка содержит
s указанную последовательность, иначе sfalse Начиная с версии: 1.5

replaceFirst
```
public String replaceFirst(String regex,
                           String replacement)
```
Заменяет первую подстроку этой строки, соответствующую заданному регулярному выражению, заданной заменой. Вызов этого метода в форме str
.replaceFirst(regex, repl )даёт результат, полностью совпадающий с выражением

Pattern.compile( regex ).matcher( str ).replaceFirst( repl )
Обратите внимание, что обратная косая черта (\ ）和美元符号（ $) в строке замены могут привести к результату, отличному от результата при обработке её как литеральной строки замены. См.Matcher.replaceFirst(java.lang.String). При необходимости используйтеMatcher.quoteReplacement(java.lang.String), чтобы подавить специальное значение этих символов.

Параметры
regex- регулярное выражение, с которым сопоставляется эта строка
replacement- строка для замены первого совпадения Результат полученная
String
строка Исключения
PatternSyntaxException- если синтаксис регулярного выражения недопустим Начиная с версии: 1.4 См. также:
Pattern

replaceAll
```
public String replaceAll(String regex,
                         String replacement)
```
Заменяет каждую подстроку этой строки, соответствующую заданному регулярному выражению, заданной заменой. Вызов этого метода в форме str
.replaceAll(regex, repl )даёт результат, полностью совпадающий с выражением

Pattern.compile( regex ).matcher( str ).replaceAll( repl )
Обратите внимание, что обратная косая черта (\ ）和美元符号（ $Результат может отличаться от результата при обработке как литеральной строки замены. См.Matcher.replaceAllПри необходимости используйте.Matcher.quoteReplacement(java.lang.String)чтобы отключить специальное значение этих символов.

Параметры
regexРегулярное выражение для сопоставления с этой строкой
replacement- Строка для замены каждого совпадения. Результат. Полученный.
String
Исключение
PatternSyntaxException- Если синтаксис регулярного выражения недействителен
Pattern

replace
```
public String replace(CharSequence target,
                      CharSequence replacement)
```
Заменяет каждую подстроку в этой строке, совпадающую с целевой литеральной последовательностью, на указанную литеральную замену. Замена выполняется от начала строки к концу. Например, замена «aa» на «b» в строке «aaa» даст «ba», а не «ab».
Параметры
target- Последовательность значений char для замены
replacement- последовательность замены для значений char, результат, результирующая строка. Начиная с версии: 1.5

split

public String[] split(String regex,
                      int limit)

Разбивает эту строку на совпадения с заданным regular expression. Массив, возвращаемый этим методом, содержит каждую подстроку этой строки, которая завершается другой подстрокой, соответствующей выражению, или концом строки. Подстроки в массиве идут в том порядке, в каком они встречаются в этой строке. Если выражение не совпадает ни с одной частью входных данных, результирующий массив содержит один элемент, саму строку.

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

limitПараметр управляет количеством применений режима и поэтому влияет на длину результирующего массива.

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

Например, строка"boo:and:foo"Сгенерируйте следующий результат со следующими параметрами:

Split example showing regex, limit, and result Regex Limit Result
: 2 { "boo", "and:foo" }

5 { "boo", "and", "foo" }

-2 { "boo", "and", "foo" }
o 5 { "b", "", ":and:f", "", "" }

-2 { "b", "", ":and:f", "", "" }

0 { "b", "", ":and:f" }

Вызовите этот метод в форме str.split(regex,n)Даёт тот же результат, что и выражение.

Pattern.compile( regex ).split( str , n )

Параметры: regex- Регулярное выражение для разделения; limit- Порог результата, как указано выше. Результат: массив строк, полученный разбиением этой строки по совпадениям с заданным регулярным выражением. Исключения

: PatternSyntaxException- если синтаксис регулярного выражения недействителен Начиная с версии: 1.4 Смотрите также:

: Pattern

split
```
public String[] split(String regex)
```
Разделяет эту строку по совпадениям с заданным regular expression. Метод работает так же, как вызов двухаргументного метода с заданным выражением и параметром limit равным нулю.
splitПоэтому пустые строки в конце не включаются в результирующий массив.
Например, строка"boo:and:foo"с заданным выражением даёт следующий результат:
Split examples showing regex and result Regex Result
: { "boo", "and", "foo" }
o { "b", "", ":and:f" }

Параметры
regex- разделяющее регулярное выражение Результат массив строк, вычисленный путём разделения этой строки по совпадениям с заданным регулярным выражением Исключения
PatternSyntaxException- если синтаксис регулярного выражения недействителен Начиная с версии: 1.4 Смотрите также:
Pattern

join
```
public static String join(CharSequence delimiter,
                          CharSequence... elements)
```
Возвращает новую String, состоящую из копийCharSequence elementsсоединённых с копиями указанногоdelimiter. For example,
```
     String message = String.join("-", "Java", "is", "cool");
     // message returned is: "Java-is-cool"
 
```
Обратите внимание, если элемент равен null, добавляется"null" 。
Параметры
delimiter- разделитель, используемый между элементами
elements- элементы для соединения. Результат новая
String , которая состоит из elementsразделённых delimiter
Исключения
NullPointerException - 如果 delimiterили elements是 null
Начиная с версии: 1.8 Смотрите также:
StringJoiner

join
```
public static String join(CharSequence delimiter,
                          Iterable<? extends CharSequence> elements)
```
Возвращает новуюStringсостоящую из копийString ，其中CharSequence elements指定的delimiterкопии. For example,
```
     List<String> strings = List.of("Java", "is", "cool");
     String message = String.join(" ", strings);
     //message returned is: "Java is cool"

     Set<String> strings =
         new LinkedHashSet<>(List.of("Java", "is", "very", "cool"));
     String message = String.join("-", strings);
     //message returned is: "Java-is-very-cool"
 
```
Обратите внимание, если отдельный элемент равенnull , добавляется"null" 。
Параметры
delimiter - последовательность символов, используемая для разделения каждого из elementsв результирующем String

elements - Iterableего elementsсоединяет вместе. Результат — новый
elementsсоставленный из параметров String
исключение
NullPointerException - 如果 delimiterили elements是 null
Начиная с версии: 1.8 См. также:
join(CharSequence,CharSequence...),StringJoiner

toLowerCase
```
public String toLowerCase(Locale locale)
```
Преобразует все символы этойLocale的规则将此String所有字符转换为Locale. Сопоставление регистров основано на версии стандарта Unicode, указанной классомCharacter. Поскольку сопоставление регистров не всегда является отображением 1:1, полученнаяString可能与原始String. Примеры сопоставления с нижним регистром показаны в таблице ниже:
Примеры преобразования в нижний регистр. Таблица содержит код языка локали, верхний регистр, нижний регистр и описание.
Параметры
locale- используйте правила преобразования регистра этого языкового стандарта. Результат
String, преобразованный в нижний регистр. Начиная с версии: 1.1 См. также:
toLowerCase(),toUpperCase(),toUpperCase(Locale)

toLowerCase
```
public String toLowerCase()
```
Преобразует все символы этойStringв нижний регистр по правилам языкового стандарта по умолчанию. Это эквивалентно вызовуtoLowerCase(Locale.getDefault()). Примечание: этот метод чувствителен к языковому стандарту. При использовании для строк, которые должны интерпретироваться независимо от языкового стандарта, он может дать неожиданный результат. Примерами являются идентификаторы языков программирования, ключи протоколов и HTML-теги. Например,
"TITLE".toLowerCase()在土耳其语言环境返回"t\u0131tle", где «\u0131» — латинская строчная буква i без точки. Чтобы получить правильный результат для строк, не зависящих от языкового стандарта, используйтеtoLowerCase(Locale.ROOT) 。

Результат
String, преобразованный в нижний регистр. См. также:
toLowerCase(Locale)

toUpperCase
```
public String toUpperCase(Locale locale)
```
Преобразует все символы этойLocale的规则将此String. Сопоставление регистров основано на версии стандарта Unicode, указанной классомCharacter. Поскольку сопоставление регистров не всегда является отображением 1:1, полученнаяString可能与原始String. Примеры чувствительности к языковому стандарту и отображения 1:M показаны в таблице ниже.
Примеры преобразований регистра, зависящих от локали, и отображений 1:M.
Параметры
locale- использует правила преобразования регистра этой локали Результат
String, преобразует в верхний регистр. Начиная с версии: 1.1 См. также:
toUpperCase(),toLowerCase(),toLowerCase(Locale)

toUpperCase
```
public String toUpperCase()
```
Преобразует все символы этой строки в верхний регистр по правилам локали по умолчанию. Этот метод эквивалентенString所有字符转换为大写。此方法相当于toUpperCase(Locale.getDefault())в турецкой локали возвращает
"title".toUpperCase()在土耳其语言环境返回"T\u0130TLE".toUpperCase(Locale.ROOT) 。

, преобразует в верхний регистр. См. также:
Stringtrim
toUpperCase(Locale)

trim
```
public String trim()
```
(символ пробела). Если этот'U+0020'объект представляет пустую последовательность символов, или если первый и последний символы последовательности, которую представляет этот
Stringобъект, имеют код, не являющийся пробелом (как определено выше), то возвращается ссылка на этотStringобъект.StringИначе, если все символы этой строки являются пробелами (как определено выше), возвращается
объект, представляющий пустую строку.StringОбъект.
объект, представляющий подстроку этой строки, которая начинается с символа с индексом k и заканчивается символом с индексом m, то естьStringрезультатthis.substring(k, m + 1).
Этот метод можно использовать для удаления пробелов (как определено выше) с начала и конца строки.

Результат Строка, значением которой является эта строка, из которой удалены все начальные и конечные пробелы. Если начальных или конечных пробелов нет, возвращается эта строка.

strip
```
public String strip()
```
Возвращает строку, значением которой является эта строка, из которой удалены все начальные и конечныеwhite space. Если этот
Stringобъект представляет пустую строку, или если все кодовые точки этой строки являютсяwhite space, возвращается пустая строка.
Иначе возвращается подстрока этой строки, которая начинается с первой кодовой точки, не являющейсяwhite space, и включает последнюю кодовую точку, не являющуюся white space.
Этот метод можно использовать для удаленияwhite spaceс начала и конца строки.

Результат Строка, значением которой является эта строка, из которой удалены все начальные и конечные пробелы. Начиная с версии: 11 См. также:
Character.isWhitespace(int)

stripLeading
```
public String stripLeading()
```
Возвращает строку, значением которой является данная строка, но без всех начальныхwhite space。 Если этот
Stringобъект представляет пустую строку, или все кодовые точки в этой строкеwhite space，то возвращается пустая строка.
Иначе возвращается подстрока этой строки, начинающаяся с первого символа, который не являетсяwhite spaceс кодовой точки в начале и включает последнюю кодовую точку этой строки.
Этот метод удаляет пробелы в начале строки.white space.

Результат: строка, значение которой равно этой строке без всех начальных пробелов. Начиная с версии: 11. См. также:
Character.isWhitespace(int)

stripTrailing
```
public String stripTrailing()
```
Возвращает строку, значение которой равно этой строке, но без всех конечныхwhite spaceпробелов. Если эта
Stringстрока представляет пустую строку или все символы в ней являютсяwhite spaceпробелами, возвращается пустая строка.
Иначе возвращается подстрока этой строки, начинающаяся с первой кодовой точки и включающая последнюю кодовую точку, которая не являетсяwhite spaceпробелом.
Этот метод используется для удаления конечных пробеловwhite spaceс конца строки.

Результат: строка, значение которой равно этой строке, но без всех конечных пробелов. Начиная с версии: 11. См. также:
Character.isWhitespace(int)

isBlank
```
public boolean isBlank()
```
Если строка пустая или содержит толькоwhite spaceкодовую точку, метод возвращаетtrue , иначе false 。
Результат
trueЕсли строка пустая или содержит толькоwhite spaceкодовую точку, иначеfalse
Доступно с версии: 11 См. также:
Character.isWhitespace(int)

lines
```
public Stream<String> lines()
```
Возвращает поток строк, извлечённых из этой строки и разделённых терминаторами строк. Терминатор строки это один из следующих: перевод строки
"\n" （U + 000A），символ возврата каретки"\r" （U + 000D）или возврат каретки с переводом строки"\r\n"（U + 000D U + 000A）。
Строка — это последовательность из нуля или более символов, за которой следует признак конца строки. Также строка — это последовательность из одного или более символов, за которой следует конец строки. Строка не включает признак конца строки.
Поток, возвращаемый этим методом, содержит строки из данной строки.

API Note: это определение строки означает, что пустая строка содержит ноль строк. Признак конца строки в конце строки не создаёт пустую строку после себя. Implementation Note: этот метод выдаёт элементы лениво и быстрее ищет новый признак конца строки. Поэтому он даёт лучшую производительность, чем split（"\R"）. Результат: поток строк, извлечённых из данной строки. Начиная с версии: 11

toString
```
public String toString()
```
Этот объект (уже строка!) возвращается сам.
Specified by:
toString在界面 CharSequence
Перезапись:
toString在类 Object
Результат — сама строка.

chars
```
public IntStream chars()
```
Возвращаетintпоток, в котором значения этой последовательностиcharрасширяются нулём. Любой символ, отображаемый на surrogate code point, остаётся необработанным.
Specified by:
chars在界面 CharSequence
Результат — IntStream значений char из этой последовательности. С версии: 9

codePoints
```
public IntStream codePoints()
```
Возвращает поток значений кодовых точек этой последовательности. Любые суррогатные пары в последовательности объединяются, как в Character.toCodePoint, и результат передаётся в поток. Любые другие кодовые единицы, включая обычные символы BMP, непарные суррогаты и неопределённые кодовые единицы, расширяются нулём доintзначения и передаются в поток.
Specified by:
codePoints在界面 CharSequence
Результат — IntStream кодовых точек Unicode этой последовательности. С версии: 9

toCharArray
```
public char[] toCharArray()
```
Преобразует эту строку в новый массив символов.
Результат — новый выделенный массив символов. Его длина равна длине этой строки, а содержимое инициализируется последовательностью символов этой строки.

format
```
public static String format(String format,
                            Object... args)
```
Возвращает отформатированную строку по указанной строке формата и аргументам. Всегда используется локаль, возвращаемая
Locale.getDefault(Locale.Category)с указаннойFORMATкатегорией.

Параметры
format- A format string
args- Аргументы, на которые ссылаются спецификаторы формата в строке формата. Лишние аргументы игнорируются. Количество аргументов переменное и равно нулю. Максимальное количество аргументов ограничено максимальной размерностью Java-массива по The Java™ Virtual Machine Specification.nullПоведение аргументов зависит от conversion. Результат — отформатированная строка. Исключения
IllegalFormatException- Если строка формата содержит недопустимый синтаксис, спецификатор формата несовместим с аргументами, аргументов недостаточно или есть другие недопустимые условия. Описание всех ошибок формата смотрите в разделе Details спецификации класса formatter. С версии: 1.5. См. также:
Formatter

format
```
public static String format(Locale l,
                            String format,
                            Object... args)
```
Возвращает отформатированную строку по указанной локали, строке формата и аргументам.
Параметры
l- locale, применяемая при форматировании. Еслиl是nullлокализация не применяется.
format- A format string
args- Аргументы, на которые ссылаются спецификаторы формата в строке формата. Лишние аргументы игнорируются. Количество аргументов переменное и равно нулю. Максимальное количество аргументов ограничено максимальной размерностью Java-массива по The Java™ Virtual Machine Specification.nullПоведение аргументов зависит от conversion. Результат — отформатированная строка. Исключения
IllegalFormatException- Если строка формата содержит недопустимый синтаксис, спецификатор формата несовместим с аргументами, аргументов недостаточно или есть другие недопустимые условия. Описание всех ошибок формата смотрите в разделе Details спецификации класса formatter. С версии: 1.5. См. также:
Formatter

valueOf
```
public static String valueOf(Object obj)
```
ВозвращаетObject参数的字符串表示形式。
Параметр
obj - Object。 Результат: если параметр является
null , то строка равна"null"; иначе возвращаемое значениеobj.toString()。 См. также:
Object.toString()

valueOf
```
public static String valueOf(char[] data)
```
НазадcharСтроковое представление массива-параметра. Содержимое символьного массива копируется, поэтому последующие изменения массива не влияют на возвращаемую строку.
Параметры
data- массив символов. Результат a
Stringсодержит символы массива символов.

valueOf
```
public static String valueOf(char[] data,
                             int offset,
                             int count)
```
Возвращаетcharстроковое представление определённой части массива.
offset参数是子offsetмассива.count参数指定子countмассива. Содержимое части массива копируется. Последующие изменения массива символов не влияют на возвращаемую строку.

Параметры
data- массив символов.
offset- начальное смещение подмассива.
count- длина подмассива. Результат a
Stringсодержит символы указанного подмассива массива символов. Исключения
IndexOutOfBoundsException - 如果 offset为负数，或者 count为负数，或者 offset+count大于 data.length.

copyValueOf
```
public static String copyValueOf(char[] data,
                                 int offset,
                                 int count)
```
эквивалентноvalueOf(char[], int, int) 。
Параметры
data- массив символов。
offset- начальное смещение подмассива。
count- длина подмассива。 Результат a
String，содержит символы указанного подмассива массива символов。 Исключение
IndexOutOfBoundsException - 如果 offset为负数，或者 count为负数，或者 offset+count大于 data.length.

copyValueOf
```
public static String copyValueOf(char[] data)
```
эквивалентноvalueOf(char[]) 。
Параметры
data- символьный массив. Результат Строка, содержащая символы массива
String.

valueOf
```
public static String valueOf(boolean b)
```
возвращаетboolean参数的字符串表示形式。
Параметры
b - a boolean. Результат Если параметр равен
true ，则返回等于"true"; иначе возвращается строка, равная"false".

valueOf
```
public static String valueOf(char c)
```
возвращаетchar参数的字符串表示形式。
Параметры
c - a char. Результат Строка длиной
1, 1содержащая параметр cв качестве единственного символа.

valueOf
```
public static String valueOf(int i)
```
возвращаетintстроковое представление параметра. Это представление совпадает с тем, которое возвращает метод
Integer.toStringэтого параметра.

Параметры
i - int. Результат
intстроковое представление параметра. Смотрите также:
Integer.toString(int, int)

valueOf
```
public static String valueOf(long l)
```
возвращаетlongстроковое представление параметра. Это представление совпадает с тем, которое возвращает метод
Long.toStringэтого параметра.

Параметры
l - a long。 Результат
longстроковое представление параметра. См. также:
Long.toString(long)

valueOf
```
public static String valueOf(float f)
```
Возвращаетfloatстроковое представление параметра. Это представление в точности совпадает с представлением, которое возвращает метод
Float.toStringпараметра.

Параметры
f - a float。 Результат
floatстроковое представление параметра. См. также:
Float.toString(float)

valueOf
```
public static String valueOf(double d)
```
Возвращаетdoubleстроковое представление параметра. Это представление в точности совпадает с представлением, которое возвращает метод
Double.toStringпараметра.

Параметры
d - a double。 Результат
doubleстроковое представление параметра. См. также:
Double.toString(double)

intern
```
public String intern()
```
Возвращает каноническое представление строкового объекта. Пул строк, изначально пустой, приватно поддерживается классом
String.
При вызове метода intern, если пул уже содержит строку, равную объекту, определённому методом String, возвращается строка из пула. Иначе этотStringобъект добавляется в пул, и возвращается ссылка на этотStringобъект.StringОтсюда следует, что для любых двух строк
иs和t ， s.intern() == t.intern()是true当且仅当s.equals(t)为true 。
Результат: строка с тем же содержимым, что и данная строка, но гарантированно из уникального пула строк. См. The Java™ Language Specification : 3.10.5 строковые литералы

repeat

repeat
```
public String repeat(int count)
```
раз. Если данная строка пуста или count равен нулю, возвращается пустая строка.countПараметры

- количество повторений Результат: строка, состоящая из данной строки, повторённой
count - 重复次数

结果

由此字符串组成的字符串重复 countраз, если эта строка пуста или count равен нулю, возвращается пустая строка. Исключение
IllegalArgumentException - 如果 countотрицательно. Начиная с версии: 11


: 2		`{ "boo", "and:foo" }`
	5	`{ "boo", "and", "foo" }`
	-2	`{ "boo", "and", "foo" }`
o 5		`{ "b", "", ":and:f", "", "" }`
	-2	`{ "b", "", ":and:f", "", "" }`
	0	`{ "b", "", ":and:f" }`

Класс String

字段汇总

构造方法摘要

方法摘要

声明方法的类 java.lang.Object

字段详细信息

CASE_INSENSITIVE_ORDER

构造方法详细信息

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

方法详细信息

length

isEmpty

charAt

codePointAt

codePointBefore

codePointCount

offsetByCodePoints

getChars

getBytes

getBytes

getBytes

getBytes

equals

contentEquals

contentEquals

equalsIgnoreCase

compareTo

compareToIgnoreCase

regionMatches

regionMatches

startsWith

startsWith

endsWith

hashCode

indexOf

indexOf

lastIndexOf

lastIndexOf

indexOf

indexOf

lastIndexOf

lastIndexOf

substring

substring

subSequence

concat

replace

matches

contains

replaceFirst

replaceAll

replace

split

split

join

join

toLowerCase

toLowerCase

toUpperCase

toUpperCase

trim

strip

stripLeading

stripTrailing

isBlank

lines