Класс String

Класс 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 предоставляет специальную поддержку оператора конкатенации строк ( + ) и преобразования других объектов в строки. Конкатенация строк реализуется через класс StringBuilder (или StringBuffer) и его метод append. Преобразования строк реализуются через метод toString, определенный в Object и унаследованный всеми классами в Java. Дополнительную информацию о конкатенации и преобразовании строк см. в книге Gosling, Joy, и Steele, The Java Language Specification.

Если не указано иное, передача null аргумента в конструктор или метод в этом классе вызовет исключение NullPointerException.

Объект String представляет строку в формате UTF-16, в котором дополнительные символы представляются парами суррогатов (см. раздел Представления символов Unicode в классе Character для получения дополнительной информации). Значения индексов относятся к блокам кода, поэтому дополнительный символ использует две позиции в строке String.

Класс String предоставляет методы для работы с кодовыми точками Unicode (т. е. символами) помимо методов для работы с кодовыми единицами Unicode (т. е. значениями char).

Поля

CASE_INSENSITIVE_ORDER

public static final Comparator<String> CASE_INSENSITIVE_ORDER

С момента:

1.2

См. также:

Collator.compare(String, String)

Конструкторы

String

public String()

Инициализирует новый объект String, чтобы он представлял пустую последовательность символов. Обратите внимание, что использование этого конструктора не нужно, так как строки неизменяемы.

String

public String(String original)

Инициализирует новый объект String, чтобы он представлял ту же последовательность символов, что и аргумент; другими словами, новая строка является копией аргументной строки. Если явная копия original не нужна, использование этого конструктора не требуется, так как строки неизменяемы.

Параметры:

original - A String

String

public String(char[] value)

Выделяет новую String, чтобы она представляла последовательность символов, в настоящее время содержащихся в аргументе массива символов. Содержимое массива символов копируется; последующее изменение массива символов не влияет на вновь созданную строку.

Параметры:

value - Начальное значение строки

String

public String(char[] value,
              int offset,
              int count)

Выделяет новую String, содержащую символы из подмассива аргумента массива символов. Аргумент offset — это индекс первого символа подмассива, а аргумент count задаёт длину подмассива. Содержимое подмассива копируется; последующее изменение массива символов не влияет на вновь созданную строку.

Параметры:

value - Массив, являющийся источником символов

offset - Начальное смещение

count - Длина

Исключения:

IndexOutOfBoundsException - Если аргументы offset и count индексируют символы за пределами границ массива value

String

public String(int[] codePoints,
              int offset,
              int count)

Выделяет новую String, содержащую символы из подмассива аргумента массива кодов Unicode. Аргумент offset — это индекс первого кода Unicode подмассива, а аргумент count задаёт длину подмассива. Содержимое подмассива преобразуется в char; последующее изменение массива int не влияет на вновь созданную строку.

Параметры:

codePoints - Массив, являющийся источником кодов Unicode

offset - Начальное смещение

count - Длина

Исключения:

IllegalArgumentException - Если обнаружен неверный код Unicode в codePoints

IndexOutOfBoundsException - Если аргументы offset и count индексируют символы за пределами границ массива codePoints

С момента:

1.5

String

@Deprecated
public String(byte[] ascii,
                          int hibyte,
                          int offset,
                          int count)

Устарело. Этот метод некорректно преобразует байты в символы. Начиная с JDK 1.1, предпочтительный способ сделать это — использовать конструкторы String, принимающие Charset, имя набора символов или использующие системный набор символов по умолчанию.

Параметры:

ascii - Байты, которые необходимо преобразовать в символы

hibyte - Верхние 8 бит каждого 16-битного блока кода Unicode

offset - Начальное смещение

count - Длина

Исключения:

IndexOutOfBoundsException - Если аргумент offset или 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
public String(byte[] ascii,
                          int hibyte)

Устарело. Этот метод некорректно преобразует байты в символы. Начиная с JDK 1.1, предпочтительный способ сделать это — использовать конструкторы String, принимающие Charset, имя набора символов или использующие системный набор символов по умолчанию.

Выделяет новую String, содержащую символы, построенные из массива 8-битовых целых значений. Каждый символ 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

Параметры:

bytes - Байты, которые необходимо декодировать в символы

offset - Индекс первого байта для декодирования

length - Количество байтов для декодирования

charsetName - Имя поддерживаемого набора символов

Исключения:

UnsupportedEncodingException - Если заданный набор символов не поддерживается

IndexOutOfBoundsException - Если аргументы offset и length индексируют символы за пределами границ массива bytes

С момента:

JDK1.1

String

public String(byte[] bytes,
              int offset,
              int length,
              Charset charset)

Параметры:

bytes - Байты, которые необходимо декодировать в символы

offset - Индекс первого байта для декодирования

length - Количество байтов для декодирования

charset - Набор символов, используемый для декодирования bytes

Исключения:

IndexOutOfBoundsException - Если аргументы offset и length индексируют символы за пределами границ массива bytes

С момента:

1.6

String

public String(byte[] bytes,
              String charsetName)
       throws UnsupportedEncodingException

Параметры:

bytes - Байты, которые необходимо декодировать в символы

charsetName - Имя поддерживаемого набора символов

Исключения:

UnsupportedEncodingException - Если заданный набор символов не поддерживается

С момента:

JDK1.1

String

public String(byte[] bytes,
              Charset charset)

Параметры:

bytes - Байты, которые необходимо декодировать в символы

charset - Набор символов, используемый для декодирования bytes

С момента:

1.6

String

public String(byte[] bytes,
              int offset,
              int length)

Параметры:

bytes - Байты, которые необходимо декодировать в символы

offset - Индекс первого байта для декодирования

length - Количество байтов для декодирования

Исключения:

IndexOutOfBoundsException - Если аргументы offset и length индексируют символы за пределами границ массива bytes

С тех пор:

JDK1.1

Строка

public String(byte[] bytes)

Параметры:

bytes - Байты, которые необходимо декодировать в символы

С тех пор:

JDK1.1

Строка

public String(StringBuffer buffer)

Выделяет новую строку, содержащую последовательность символов, которые в данный момент содержатся в аргументе буфера строк. Содержимое буфера строк копируется; последующие изменения буфера строк не влияют на вновь созданную строку.

Параметры:

buffer - Буфер строк

Строка

public String(StringBuilder builder)

Параметры:

builder - Билдер строк

С тех пор:

1.5

Методы

length

public int length()

Возвращает длину этой строки. Длина равна количеству символов Юникода в строке.

Определено в:

length в интерфейсе CharSequence

Возвращает:

длину последовательности символов, представленной этим объектом.

isEmpty

public boolean isEmpty()

Возвращает true тогда и только тогда, когда length() равно 0.

Возвращает:

true если length() равно 0, в противном случае false

С тех пор:

1.6

charAt

public char charAt(int index)

Определено в:

charAt в интерфейсе CharSequence

Параметры:

index - индекс значения символа.

Возвращает:

значение символа в указанном индексе этой строки. Первый символ находится по индексу 0.

Исключения:

IndexOutOfBoundsException - если аргумент index отрицателен или не меньше длины этой строки.

codePointAt

public int codePointAt(int index)

Параметры:

index - индекс к значениям символов

Возвращает:

значение кодового символа символа в index

Исключения:

IndexOutOfBoundsException - если аргумент index отрицателен или не меньше длины этой строки.

С тех пор:

1.5

codePointBefore

public int codePointBefore(int index)

Параметры:

index - индекс, следующий за кодовым символом, который должен быть возвращён

Возвращает:

значение кодового символа Юникода перед заданным индексом.

Исключения:

IndexOutOfBoundsException - если аргумент index меньше 1 или больше длины этой строки.

С тех пор:

1.5

codePointCount

public int codePointCount(int beginIndex,
                          int endIndex)

Возвращает количество символов Юникода в указанном диапазоне текста этой строки. Диапазон текста начинается в указанном beginIndex и простирается до char в индексе endIndex - 1. Таким образом, длина (в символах) диапазона текста составляет endIndex-beginIndex. Непарные суррогаты в диапазоне текста считаются по одному символу Юникода каждый.

Параметры:

beginIndex - индекс первого символа диапазона текста.

endIndex - индекс после последнего символа диапазона текста.

Возвращает:

количество символов Юникода в указанном диапазоне текста

Исключения:

IndexOutOfBoundsException - если beginIndex отрицателен, или endIndex больше длины этой строки, или beginIndex больше endIndex.

С тех пор:

1.5

offsetByCodePoints

public int offsetByCodePoints(int index,
                              int codePointOffset)

Возвращает индекс в этой строке, который смещён от данного index на codePointOffset символов. Непарные суррогаты в диапазоне текста, заданном index и codePointOffset, считаются по одному символу Юникода каждый.

Параметры:

index - индекс, который необходимо сместить

codePointOffset - смещение в кодовых точках

Возвращает:

индекс в этой строке

Исключения:

IndexOutOfBoundsException - если index отрицателен или больше длины этой строки, или если codePointOffset положительно, и подстрока, начинающаяся с index, содержит меньше codePointOffset кодовых точек, или если codePointOffset отрицательно, и подстрока перед index содержит меньше абсолютного значения codePointOffset кодовых точек.

С тех пор:

1.5

getChars

public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)

dstBegin + (srcEnd-srcBegin) - 1

Параметры:

srcBegin - индекс первого символа в строке для копирования.

srcEnd - индекс после последнего символа в строке для копирования.

dst - целевой массив.

dstBegin - начальное смещение в целевом массиве.

Исключения:

IndexOutOfBoundsException - Если выполняется любое из следующих условий:

• srcBegin отрицателен.
• srcBegin больше srcEnd
• srcEnd больше длины этой строки
• dstBegin отрицателен
• dstBegin+(srcEnd-srcBegin) больше dst.length

getBytes

@Deprecated
public void getBytes(int srcBegin,
                                 int srcEnd,
                                 byte[] dst,
                                 int dstBegin)

Устарело. Этот метод не правильно преобразует символы в байты. Начиная с JDK 1.1, предпочтительный способ сделать это – использовать метод getBytes(), который использует кодировку по умолчанию платформы.

dstBegin + (srcEnd-srcBegin) - 1

Параметры:

srcBegin - Индекс первого символа в строке для копирования

srcEnd - Индекс после последнего символа в строке для копирования

dst - Целевой массив

dstBegin - Начальное смещение в целевом массиве

Исключения:

IndexOutOfBoundsException - Если выполняется любое из следующих условий:

• srcBegin отрицателен
• srcBegin больше srcEnd
• srcEnd больше длины этой строки
• dstBegin отрицателен
• dstBegin+(srcEnd-srcBegin) больше dst.length

getBytes

public byte[] getBytes(String charsetName)
                throws UnsupportedEncodingException

Параметры:

charsetName - Имя поддерживаемого кодирования символов

Возвращает:

Полученный массив байтов

Выбрасывает:

UnsupportedEncodingException - Если указанное кодирование символов не поддерживается

С:

JDK1.1

getBytes

public byte[] getBytes(Charset charset)

Параметры:

charset - Кодирование символов, используемое для кодирования String

Возвращает:

Полученный массив байтов

С:

1.6

getBytes

public byte[] getBytes()

Возвращает:

Полученный массив байтов

С:

JDK1.1

equals

public boolean equals(Object anObject)

Сравнивает эту строку с заданным объектом. Результат — true тогда и только тогда, когда аргумент не null и является объектом типа String, представляющим ту же последовательность символов, что и этот объект.

Переопределяет:

equals в классе Object

Параметры:

anObject - Объект для сравнения с этой String

Возвращает:

true , если заданный объект представляет String эквивалентную этой строке, false в противном случае

См. также:

compareTo(String), equalsIgnoreCase(String)

contentEquals

public boolean contentEquals(StringBuffer sb)

Сравнивает эту строку с заданным StringBuffer. Результат — true тогда и только тогда, когда эта String представляет ту же последовательность символов, что и заданный StringBuffer. Этот метод блокирует StringBuffer.

Параметры:

sb - StringBuffer для сравнения с этой String

Возвращает:

true , если эта String представляет ту же последовательность символов, что и заданный StringBuffer, false в противном случае

С:

1.4

contentEquals

public boolean contentEquals(CharSequence cs)

Сравнивает эту строку с указанной CharSequence. Результат — true тогда и только тогда, когда эта String представляет ту же последовательность символов, что и указанная последовательность. Обратите внимание, что если CharSequence является StringBuffer, то метод блокирует его.

Параметры:

cs - Последовательность для сравнения с этой String

Возвращает:

true , если эта String представляет ту же последовательность символов, что и указанная последовательность, false в противном случае

С:

1.5

equalsIgnoreCase

public boolean equalsIgnoreCase(String anotherString)

Параметры:

anotherString - String для сравнения с этой String

Возвращает:

true , если аргумент не null и представляет эквивалентную String , игнорируя регистр; false в противном случае

См. также:

equals(Object)

compareTo

public int compareTo(String anotherString)

this.charAt(k)-anotherString.charAt(k)

this.length()-anotherString.length()

Установлено:

compareTo в интерфейсе Comparable<String>

Параметры:

anotherString - сравниваемая String.

Возвращает:

значение 0 , если строка-аргумент равна этой строке; значение меньше 0 , если эта строка лексикографически меньше строки-аргумента; и значение больше 0 , если эта строка лексикографически больше строки-аргумента.

compareToIgnoreCase

public int compareToIgnoreCase(String str)

Параметры:

str - сравниваемая String.

Возвращает:

отрицательное целое число, ноль или положительное целое число, в зависимости от того, больше, равно или меньше, чем эта строка, игнорируя различия в регистре.

С:

1.2

См. также:

Collator.compare(String, String)

regionMatches

public boolean regionMatches(int toffset,
                             String other,
                             int ooffset,
                             int len)

Параметры:

toffset - начальный смещение подстроки в этой строке.

other - строка-аргумент.

ooffset - начальное смещение подстроки в строке-аргументе.

len - количество символов для сравнения.

Возвращает:

true , если указанная подстрока этой строки точно совпадает с указанной подстрокой строки-аргумента; false в противном случае.

regionMatches

public boolean regionMatches(boolean ignoreCase,
                             int toffset,
                             String other,
                             int ooffset,
                             int len)

Параметры:

ignoreCase - если true, игнорировать регистр при сравнении символов.

toffset - начальный смещение подстроки в этой строке.

other - строковый аргумент.

ooffset - начальный смещение подстроки в строковом аргументе.

len - количество символов для сравнения.

Возвращает:

true если указанная подстрока этой строки совпадает с указанной подстрокой строкового аргумента; false в противном случае. Точное или регистронезависимое совпадение зависит от аргумента ignoreCase.

startsWith

public boolean startsWith(String prefix,
                          int toffset)

Проверяет, начинается ли подстрока этой строки, начиная с указанного индекса, с указанного префикса.

Параметры:

prefix - префикс.

toffset - с какой позиции начинать поиск в этой строке.

Возвращает:

true если последовательность символов, представленная аргументом, является префиксом подстроки этого объекта, начинающейся с индекса toffset; false в противном случае. Результат равен false, если toffset отрицательно или больше длины этого объекта String; в противном случае результат совпадает с результатом выражения

this.substring(toffset).startsWith(prefix)

.

startsWith

public boolean startsWith(String prefix)

Проверяет, начинается ли эта строка с указанного префикса.

Параметры:

prefix - префикс.

Возвращает:

true если последовательность символов, представленная аргументом, является префиксом последовательности символов, представленной этой строкой; false в противном случае. Обратите также внимание, что true будет возвращено, если аргумент является пустой строкой или равен этому объекту String, как определено методом equals(Object).

С:

1. 0

endsWith

public boolean endsWith(String suffix)

Проверяет, заканчивается ли эта строка указанным суффиксом.

Параметры:

suffix - суффикс.

Возвращает:

true если последовательность символов, представленная аргументом, является суффиксом последовательности символов, представленной этим объектом; false в противном случае. Обратите внимание, что результат будет true, если аргумент является пустой строкой или равен этому объекту String, как определено методом equals(Object).

hashCode

public int hashCode()

Возвращает хэш-код для этой строки. Хэш-код для объекта String вычисляется как

s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

indexOf

public int indexOf(int ch)

Возвращает индекс в этой строке первого вхождения указанного символа. Если символ со значением ch встречается в последовательности символов, представленной этим объектом String, то возвращается индекс (в единицах кода Юникода) первого такого вхождения. Для значений ch в диапазоне от 0 до 0xFFFF (включительно), это наименьшее значение k, для которого:

this.charAt(k) == ch

this.codePointAt(k) == ch

Параметры:

ch - символ (код Юникода).

Возвращает:

индекс первого вхождения символа в последовательность символов, представленную этим объектом, или -1 если символ не встречается.

indexOf

public int indexOf(int ch,
                   int fromIndex)

(this.charAt(k) == ch)  && (k >= fromIndex)

(this.codePointAt(k) == ch)  && (k >= fromIndex)

Параметры:

ch - символ (код Юникода).

fromIndex - индекс, с которого начинать поиск.

Возвращает:

индекс первого вхождения символа в последовательность символов, представленную этим объектом, которая больше или равна fromIndex, или -1 если символ не встречается.

lastIndexOf

public int lastIndexOf(int ch)

Возвращает индекс в этой строке последнего вхождения указанного символа. Для значений ch в диапазоне от 0 до 0xFFFF (включительно), возвращаемый индекс (в единицах кода Юникода) — это наибольшее значение k, такое что:

this.charAt(k) == ch

this.codePointAt(k) == ch

Параметры:

ch - символ (код Юникода).

Возвращает:

индекс последнего вхождения символа в последовательность символов, представленную этим объектом, или -1 если символ не встречается.

lastIndexOf

public int lastIndexOf(int ch,
                       int fromIndex)

(this.charAt(k) == ch)  && (k <= fromIndex)

(this.codePointAt(k) == ch)  && (k <= fromIndex)

Параметры:

ch - символ (код Юникода).

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

Возвращает:

индекс последнего вхождения символа в последовательность символов, представленную этим объектом, которая меньше или равна fromIndex, или -1 если символ не встречается до этого момента.

indexOf

public int indexOf(String str)

this.startsWith(str, k)

Параметры:

str - подстрока для поиска.

Возвращает:

индекс первого вхождения указанной подстроки, или -1 если такого вхождения нет.

indexOf

public int indexOf(String str,
                   int fromIndex)

k >= fromIndex  && this.startsWith(str, k)

Параметры:

str - подстрока для поиска.

fromIndex - индекс, с которого начинать поиск.

Возвращает:

индекс первого вхождения указанной подстроки, начиная с указанного индекса, или -1 если такого вхождения нет.

lastIndexOf

public int lastIndexOf(String str)

this.startsWith(str, k)

Параметры:

str - подстрока для поиска.

Возвращает:

индекс последнего вхождения указанной подстроки, или -1 если такого вхождения нет.

lastIndexOf

public int lastIndexOf(String str,
                       int fromIndex)

k  <= fromIndex  && this.startsWith(str, k)

Параметры:

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)

"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)

Определено в:

subSequence в интерфейсе CharSequence

Примечание API:

Этот метод определен таким образом, чтобы класс String мог реализовать интерфейс CharSequence.

Параметры:

beginIndex - начальный индекс, включительно.

endIndex - конечный индекс, исключая.

Возвращает:

указанную подпоследовательность.

Исключение:

IndexOutOfBoundsException - если beginIndex или endIndex отрицательны, если endIndex больше length(), или если beginIndex больше endIndex

С:

1.4

concat

public String concat(String str)

"cares".concat("s") returns "caress"
"to".concat("get").concat("her") returns "together"

Параметры:

str - строка, которая присоединяется к концу этого объекта String.

Возвращает:

строка, представляющая конкатенацию символов этого объекта и символов аргументной строки.

replace

public String replace(char oldChar,
                      char 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 на newChar.

matches

public boolean matches(String regex)

Параметры:

regex - регулярное выражение, которому должна соответствовать эта строка

Возвращает:

true тогда и только тогда, когда эта строка соответствует данному регулярному выражению

Исключение:

PatternSyntaxException - если синтаксис регулярного выражения некорректен

С:

1.4

См. также:

Pattern

contains

public boolean contains(CharSequence s)

Возвращает true тогда и только тогда, когда эта строка содержит указанную последовательность значений char.

Параметры:

s - последовательность, которую нужно найти

Возвращает:

true, если эта строка содержит s, иначе false

С:

1.5

replaceFirst

public String replaceFirst(String regex,
                           String replacement)

Pattern.compile(regex).matcher(str).replaceFirst(repl)

Параметры:

regex - регулярное выражение, которому должна соответствовать эта строка

replacement - строка, которая должна быть заменена на первое совпадение

Возвращает:

результирующая String

Исключение:

PatternSyntaxException - если синтаксис регулярного выражения некорректен

С:

1.4

См. также:

Pattern

replaceAll

public String replaceAll(String regex,
                         String replacement)

Pattern.compile(regex).matcher(str).replaceAll(repl)

Параметры:

regex - регулярное выражение, которому должна соответствовать эта строка

replacement - строка, которая должна быть заменена на каждое совпадение

Возвращает:

результирующая String

Исключение:

PatternSyntaxException - если синтаксис регулярного выражения некорректен

С:

1.4

См. также:

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)

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

Параметры:

regex - разделяющее регулярное выражение

limit - порог результата, как описано выше

Возвращает:

массив строк, вычисленный путем разделения этой строки вокруг совпадений с заданным регулярным выражением

Исключение:

PatternSyntaxException - если синтаксис регулярного выражения некорректен

С:

1.4

См. также:

Pattern

split

public String[] split(String regex)

Параметры:

regex - разделяющее регулярное выражение

Возвращает:

массив строк, вычисленный путем разделения этой строки вокруг совпадений с заданным регулярным выражением

Исключение:

PatternSyntaxException - если синтаксис регулярного выражения недействителен

С:

1.4

См. также:

Pattern

join

public static String join(CharSequence delimiter,
                          CharSequence... elements)

Возвращает новую строку, составленную из копий CharSequence elements вместе с копией указанного delimiter.

String message = String.join("-", "Java", "is", "cool");
// message returned is: "Java-is-cool"

Параметры:

delimiter - разделитель, разделяющий каждый элемент

elements - элементы, которые необходимо объединить.

Возвращает:

новая String, составленная из elements, разделенных delimiter.

Исключение:

NullPointerException - Если delimiter или elements равны null

С:

1.8

См. также:

StringJoiner

join

public static String join(CharSequence delimiter,
                          Iterable<? extends CharSequence> elements)

Возвращает новую String, составленную из копий CharSequence elements вместе с копией указанного delimiter.

List<String> strings = new LinkedList<>();
strings.add("Java");strings.add("is");
strings.add("cool");
String message = String.join(" ", strings);
//message returned is: "Java is cool"

Set<String> strings = new LinkedHashSet<>();
strings.add("Java"); strings.add("is");
strings.add("very"); strings.add("cool");
String message = String.join("-", strings);
//message returned is: "Java-is-very-cool"

Параметры:

delimiter - последовательность символов, используемая для разделения каждого elements в результирующей String

elements - Iterable, у которого будут объединены elements.

Возвращает:

новая String, составленная из elements аргумента

Исключение:

NullPointerException - Если delimiter или elements равны null

С:

1.8

См. также:

join(CharSequence,CharSequence...), StringJoiner

toLowerCase

public String toLowerCase(Locale locale)

Преобразует все символы в этой String в строчные буквы, используя правила заданного Locale. Преобразование регистра основано на версии стандарта Unicode, указанной классом Character. Поскольку преобразования регистра не всегда являются однозначными соответствиями символов, результирующая String может иметь другую длину по сравнению с исходной String.

Примеры преобразования в нижний регистр в следующей таблице:

Код языка локали	Заглавные буквы	Строчные буквы	Описание
tr (турецкий)	\u0130	\u0069	заглавная буква I с точкой сверху -> строчная буква i
tr (турецкий)	\u0049	\u0131	заглавная буква I -> строчная буква без точки i
(все)	French Fries	french fries	преобразование всех символов в строке в строчные
(все)			преобразование всех символов в строчные

Параметры:

locale - использование правил преобразования регистра для этой локали

Возвращает:

строку, преобразованную в нижний регистр.

С:

1.1

См. также:

toLowerCase(), toUpperCase(), toUpperCase(Locale)

toLowerCase

public String toLowerCase()

Возвращает:

строку, преобразованную в нижний регистр.

См. также:

toLowerCase(Locale)

toUpperCase

public String toUpperCase(Locale locale)

Параметры:

locale - использование правил преобразования регистра для этой локали

Возвращает:

строку, преобразованную в верхний регистр.

С:

1.1

См. также:

toUpperCase(), toLowerCase(), toLowerCase(Locale)

toUpperCase

public String toUpperCase()

Возвращает:

строку, преобразованную в верхний регистр.

См. также:

toUpperCase(Locale)

trim

public String trim()

Возвращает:

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

toString

public String toString()

Возвращается сам этот объект (который уже является строкой!).

Указано:

toString в интерфейсе CharSequence

Переопределяет:

toString в классе Object

Возвращает:

сам строковый объект.

toCharArray

public char[] toCharArray()

Преобразует эту строку в новый массив символов.

Возвращает:

новый выделенный массив символов, длина которого равна длине этой строки, и чьё содержимое инициализировано последовательностью символов, представленных этой строкой.

format

public static String format(String format,
                            Object... args)

Параметры:

format — строка формата

args — Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, лишние аргументы игнорируются. Количество аргументов может быть переменным и равным нулю. Максимальное количество аргументов ограничено максимальным размером массива в Java, как определено в Спецификации виртуальной машины Java. Поведение с аргументом null зависит от преобразования.

Возвращает:

Отформатированная строка

Исключения:

IllegalFormatException — Если строка формата содержит недопустимый синтаксис, спецификатор формата, несовместимый с заданными аргументами, недостаточное количество аргументов для строки формата или другие недопустимые условия. Для описания всех возможных ошибок форматирования см. раздел Детали спецификации класса formatter.

С:

1.5

См. также:

Formatter

format

public static String format(Locale l,
                            String format,
                            Object... args)

Возвращает отформатированную строку, используя указанный язык, строку формата и аргументы.

Параметры:

l — Язык, используемый во время форматирования. Если l равен null, локальные настройки не применяются.

format — строка формата

args — Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, лишние аргументы игнорируются. Количество аргументов может быть переменным и равным нулю. Максимальное количество аргументов ограничено максимальным размером массива в Java, как определено в Спецификации виртуальной машины Java. Поведение с аргументом null зависит от преобразования.

Возвращает:

Отформатированная строка

Исключения:

IllegalFormatException — Если строка формата содержит недопустимый синтаксис, спецификатор формата, несовместимый с заданными аргументами, недостаточное количество аргументов для строки формата или другие недопустимые условия. Для описания всех возможных ошибок форматирования см. раздел Детали спецификации класса 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 — массив символов.

Возвращает:

строка, содержащая символы массива символов.

valueOf

public static String valueOf(char[] data,
                             int offset,
                             int count)

Параметры:

data — массив символов.

offset — начальный индекс подмассива.

count — длина подмассива.

Возвращает:

строка, содержащая символы указанного подмассива массива символов.

Исключения:

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 — длина подмассива.

Возвращает:

строка, содержащая символы указанного подмассива массива символов.

Исключения:

IndexOutOfBoundsException — если offset отрицательно, или count отрицательно, или offset+count больше, чем data.length.

copyValueOf

public static String copyValueOf(char[] data)

Эквивалентно valueOf(char[]).

Параметры:

data — массив символов.

Возвращает:

строка, содержащая символы массива символов.

valueOf

public static String valueOf(boolean b)

Возвращает строковое представление аргумента boolean.

Параметры:

b — значение boolean.

Возвращает:

Если аргумент true, возвращается строка, равная "true"; в противном случае, возвращается строка, равная "false".

valueOf

public static String valueOf(char c)

Возвращает строковое представление аргумента — символа char.

Параметры:

c — символ char.

Возвращает:

строка длиной 1, содержащая один символ — переданный аргумент c.

valueOf

public static String valueOf(int i)

Параметры:

i — целое число int.

Возвращает:

строковое представление аргумента int.

См. также:

Integer.toString(int, int)

valueOf

public static String valueOf(long l)

Параметры:

l — длинное целое число long.

Возвращает:

строковое представление аргумента long.

См. также:

Long.toString(long)

valueOf

public static String valueOf(float f)

Параметры:

f — число с плавающей точкой float.

Возвращает:

строковое представление аргумента float.

См. также:

Float.toString(float)

valueOf

public static String valueOf(double d)

Параметры:

d — вещественное число double.

Возвращает:

строковое представление аргумента double.

См. также:

Double.toString(double)

intern

public String intern()

Возвращает:

строка, содержащая то же содержимое, что и эта строка, но гарантированно взятая из пула уникальных строк.