Spiral | Класс String. Java JDK 1.6

Spiral group

_________________________________________________________________________________

< Раздел “Язык Java” > < Раздел “Технологии Java” > < Основная страница >

Класс String. Java JDK 1.6

Статья опубликована: 23.10.2006

Поля. Краткое описание.

Static Comparator<String>

CASE_INSENSITIVE_ORDER

Компаратор, который упорядочивает объекты String посредством метода compareToIgnoreCase

Конструкторы. Краткое описание.

String()

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

String(byte[] bytes)

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

String(byte[] bytes, Charset charset)

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

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

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

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

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

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

String(byte[] bytes, String charsetName)

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

String(char[] value)

Размещает новую строку таким образом, что она представляет собой последовательность символов, содержащихся в аргументе - символьном массиве.

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

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

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

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

String(String original)

String(StringBuffer buffer)

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

String(StringBuilder builder)

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

Методы. Краткое описание.
char	charAt(int index) Возвращает символ из строки по указанному индексу.
int	codePointAt(int index) Возвращает символ (кодовую точку Unicode) по указанному индексу.
int	codePointBefore(int index) Возвращает символ (кодовую точку Unicode) до указанного индекса.
int	codePointCount(beginIndex, int endIndex) Возвращает количество кодовых точек Unicode в указанном текстовом диапазоне данной строки.
int	compareTo(String anotherString) Сравнивает две строки лексикографически.
int	compareToIgnoreCase(String str) Сравнивает две строки лексикографически, игнорируя различия в регистре символов.
String	concat(String str) Присоединяет указанную строку к концу данной строки.
boolean	contains(CharSequence cs) Возвращает true если и только если данная строка содержит указанную символьную последовательность.
boolean	contentEquals(CharSequence cs) Сравнивает данную строку с указанной символьной последовательностью.
boolean	contentEquals(StringBuffer sb) Сравнивает данную строку с указанной строкой StringBuffer.
static String	copyValueOf(char[] data) Возвращает строку, которая представляет символьную последовательность в указанном массиве.
static String	copyValueOf(char[] data, int offset, int count) Возвращает строку, которая представляет символьную последовательность в указанном массиве.
boolean	endsWith(String suffix) Проверяет, заканчивается ли данная строка указанным суффиксом.
boolean	equals(Object anObject) Сравнивает данную строку с указанным объектом.
boolean	equalsIgnoreCase(String anotherString) Сравнивает данную строку с другой строкой, игнорируя различия в регистре символов.
static String	format(Locale l, String format, Object ... args) Возвращает форматированную строку, используя указанную локаль, формат строки и аргументы.
static String	format(String format, Object ... args) Возвращает форматированную строку, используя указанный формат строки и аргументы.
byte[]	getBytes() Кодирует данную строку в последовательность байтов, используя платформенный набор символов по умолчанию, сохраняя результат в новый байтовый массив.
byte[]	getBytes(Charset charset) Кодирует данную строку в последовательность байт, используя заданный символьный набор, сохраняя результат в новом массиве байт.
byte[]	getBytes(String charsetName) Кодирует данную строку в последовательность байт, используя имя символьного набора, сохраняя результат в новом массиве байт.
void	getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) Копирует символы из данной строки в результирующий массив символов dst.
int	hashCode() Возвращает хэшкод для данной строки.
int	indexOf(ch) Возвращает индекс внутри данной строки первого вхождения указанного символа.
int	indexOf(int ch, int fromIndex) Возвращает индекс внутри данной строки первого вхождения указанного символа, начиная поиск с указанной позиции.
int	indexOf(String str) Возвращает индекс внутри данной строки первого вхождения указанной подстроки.
int	indexOf(String str, int fromIndex) Возвращает индекс внутри данной строки первого вхождения указанной подстроки, начиная с указанного символа.
String	intern() Возвращает каноническое представление для данного строкового объекта.
boolean	isEmpty() Возвращает true если и только если длина данной строки length() равна 0 иначе false.
int	lastIndexOf(int ch) Возвращает индекс внутри данной строки последнего вхождения указанного символа.
int	lastIndexOf(int ch, int fromIndex) Возвращает индекс внутри данной строки последнего вхождения указанного символа, осуществляя поиск к началу строки, начиная с указанного индекса.
int	lastIndexOf(String str) Возвращает индекс внутри данной строки последнего вхождения указанной строки.
int	lastIndexOf(String str, int fromIndex) Возвращает индекс внутри данной строки последнего вхождения указанной подстроки, осуществляя поиск к началу строки, начиная с указанного индекса.
int	length() Возвращает длину строки.
boolean	matches(String regex) Проверяет, соответствует ли данная строка заданному регулярному выражению.
int	offsetByCodePoints(int index, int codePointOffset) Возвращает индекс внутри данной строки, который является смещением от указанного index посредством кодовых точек codePointOffset
boolean	regionMatches(boolean ignoreCase, int toffset, String other, int offset, int len) Проверяет, являются ли две строки регионально эквивалентными.
boolean	regionMatches(int toffset, String other, int offset, int len) Проверяет, являются ли две строки регионально эквивалентными.
String	replace(char oldChar, char newChar) Возвращает новую строку, в которой заменены все вхождения символа oldChar в данной строке на символ newChar.
String	replace(CharSequence target, CharSequence replacement) Заменяет каждую подстроку данной строки, которая соответствует литеральной последовательности target на указанную литеральную последовательность.
String	replaceAll(String regex, String replacement) Заменяет каждую подстроку данной строки, которая соответствует заданному регулярному выражению на строку replacement.
String	replaceFirst(String regex, String replacement) Заменяет первое вхождение данной строки, которое соответствует заданному регулярному выражению regex на строку replacement.
String[]	split(String regex) Разбивает данную строку на элементы, которые разделены строками, соответствующими заданному регулярному выражению.
String[]	split(String regex, int limit) Разбивает данную строку на элементы, которые разделены строками, соответствующими заданному регулярному выражению.
boolean	startsWith(String prefix) Проверяет, начинается ли данная строка указанным префиксом.
boolean	startsWith(String prefix, int offset) Проверяет, начинаяется ли подстрока данной строки префиксом, начиная с указанного индекса.
CharSequence	subSequence(int beginIndex, int endIndex) Возвращает новую символьную последовательность, которая является подпоследовательностью данной последовательности.
String	substring(int beginIndex) Возвращает новую строку, которая является подстрокой данной строки.
String	substring(int beginIndex, int endIndex) Возвращает новую строку, которая является подстрокой данной строки.
char[]	toCharArray() Конвертирует данную строку в новый символьный массив.
String	toLowerCase() Конвертирует все символы данной строки в нижний регистр, используя правила локали по умолчанию.
String	toLowerCase(Locale locale) Конвертирует все символы в данной строке, используя правила заданной локали.
String	toString() Возвращает этот же объект (который уже является строкой!).
String	toUpperCase() Конвертирует все символы в данной строке в верхний регистр, используя правила локали по умолчанию.
String	toUpperCase(Locale locale) Конвертирует все символы в данной строке в верхний регистр, используя правила заданной локали.
String	trim() Возвращает копию строки, без ведущих и замыкающих пробелов.
String	valueOf(boolean b) Возвращает строковое представление аргумента типа boolean.
String	valueOf(char c) Возвращает строковое представление аргумента типа char.
String	valueOf(char[] data) Возвращает стрковое представление аргумента типа char[] (символьный массив).
String	valueOf(char[] data, int offset, int count) Возвращает строковое представление специфического подмассива аргумента типа char[] (символьный массив).
String	valueOf(double d) Возвращает строковое представление аргумента типа double.
String	valueOf(float f) Возвращает строковое представление аргумента типа float.
String	valueOf(int i) Возвращает строковое представление аргумента типа int.
String	valueOf(long l) Возвращает строковое представление аргумента типа long.
String	valueOf(Object obj) Возвращает строковое представление аргумента типа Object.

Поля. Детальное описание.

public static final Comparator<String> CASE_INSENSITIVE_ORDER

Компаратор, который упорядочивает объекты String методом compareToIgnoreCase. Компаратор является сериализируемым. Помните, что данный компаратор не учитывает локаль, и будет возвращать неудовлетворительный порядок для определенных локалей. java.text package имеет Collators (коллаторы - подборные сортировщики) для установления локаль-зависимого порядка.

Введено в версии:

JDK 1.2

Конструкторы. Детальное описание.

String

public String()

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

String

public String(byte[] bytes)

Создает новую строку, декодируя указанный массив байтов и используя символьный набор платформы по умолчанию. Длина новой строки - это функция символьного набора, и поэтому может не быть равна длине массива байт. Поведение данного конструктора, когда заданные байты не имеют соответствия в символьном наборе по умолчанию не определено. Класс CharsetDecoder должен быть использован, когда требуется больший контроль над процессом декодирования.

Параметры:

bytes - байты, которые будут декодироваться в символы.

Введено в версии:

JDK 1.1

String

public String(byte[] bytes, Charset charset)

Создает новую строку, декодируя указанный массив байтов и используя указанный Charset. Длина новой строки является функцией символьного набора, и поэтому может быть не равна длине массива байт. Этот метод всегда заменяет неправильно заданный и неотображаемый символьный набор последовательности на эквивалент из символьного набора по умолчанию. Класс CharsetDecoder должен быть использован, когда требуется больший контроль над процессом декодирования.

Параметры:

bytes - байты, которые будут декодироваться в символы.

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

Введено в версии:

JDK 1.6

String

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

Создает новую строку, декодируя указанный массив байтов и используя символьный набор платформы по-умолчанию. Длина новой строки является функцией символьного набора, и поэтому может быть не равна длине подмассива. Поведение данного конструктора, когда данные байты недействительные в символьном наборе по умолчанию, не определено. Класс CharsetDecoder должен быть использован, когда требуется больший контроль над процессом декодирования.

Параметры:

bytes - байты, которые будут декодироваться в символы.

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

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

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

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

Введено в версии:

JDK 1.1

String

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

Создает новую строку, декодируя указанный подмассив байтов и используя указанный символьный набор. Длина новой строки является функцией символьного набора, и поэтому может быть не равна длине подмассива. Этот метод всегда заменяет неправильно заданный и неотображаемый символьный набор последовательности на эквивалент из символьного набора по умолчанию. Класс CharsetDecoder должен быть использован, когда требуется больший контроль над процессом декодирования.

Параметры:

bytes - байты, которые будут декодироваться в символы.

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

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

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

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

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

Введено в версии:

JDK 1.6

String

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

Создает новую строку, декодируя указанный массив байтов и используя имя символьного набора. Длина новой строки является функцией символьного набора, и поэтому может быть не равна длине подмассива. Поведение данного конструктора, когда данные байты недействительные, в символьном наборе по умолчанию не определено. Класс CharsetDecoder должен быть использован, когда требуется больший контроль над процессом декодирования.

Параметры:

bytes - байты, которые будут декодироваться в символы.

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

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

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

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

UnsupportedEncodingException - если имя символьного набора не поддерживается.

IndexOutOfBoundsException - если аргументы length и offset индексируют символы, выходящие за границы массива bytes.

Введено в версии:

JDK 1.1

String

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

Создает новую строку, декодируя указанный массив байтов и используя имя символьного набора. Длина новой строки является функцией символьного набора, и поэтому может быть не равна длине массива байт. Поведение данного конструктора, когда данные байты недействительные в символьном наборе по умолчанию не определено. Класс CharsetDecoder должен быть использован, когда требуется больший контроль над процессом декодирования.

Параметры:

bytes - байты, которые будут декодироваться в символы.

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

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

UnsupportedEncodingException - если имя символьного набора не поддерживается.

Введено в версии:

JDK 1.1

String

public String(char[] value)

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

Параметры:

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

String

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

Размещает новую строку, которая содержит символы из подмассива аргумента - символьного массива. Аргумент offset является индексом первого символа подмассива, а аргумент count определяет длину подмассива. Копируется содержимое подмассива; последующие изменения символьного массива не влияют на новую созданную строку.

Параметры:

value - массив исходных символов.

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

count – длина.

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

IndexOutOfBoundsException - Если аргументы offset и count индексируют символы, выходящие за границы массива array.

String

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

Размещает новую строку, которая содержит символы из подмассива аргумента - массива кодовых точек Unicode. Аргумент offset является индексом первой кодовой точки подмассива, а аргумент count определяет длину подмассива. Содержимое подмассива конвертируется в символы; дальнейшая модификация int массива не влияет на новую созданную строку.

Параметры:

codePoints - массив, который является источником кодовых точек Unicode.

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

count - длина.

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

IndexOutOfBoundsException - если аргументы offset и count индексируют символы, выходящие за границы массива codePoints.

IllegalArgumentException - если будет найдена какая-либо неверная кодовая точка Unicode в массиве codePoints.

Введено в версии:

JDK 1.5

String

public String(String original)

Инициализирует новый объект-строку таким образом, что она представляет ту же последовательность символов как аргумент; другими словами, новую строку, которая является копией строки аргумента. До тех пор, пока не требуется явная копия original, использование данного конструктора излишнее, так как строки являются неизменяемыми.

Параметры:

original - строка.

String

public String(StringBuffer buffer)

Размещает новую строку, которая содержит последовательность символов, содержащихся в аргументе StringBuffer. Копируется содержимое строкового буфера, дальнейшее изменение строкового буфера не влияет на новую созданную строку.

Параметры:

buffer - строка типа StringBuffer.

String

public String(StringBuilder builder)

Размещает новую строку, которая содержит последовательность символов содержащихся в аргументе StringBuilder. Копируется содержимое строки типа StringBuilder; дальнейшее изменение строки типа StringBuilder не влияет на новую созданную строку. Данный конструктор делает проще миграцию к StringBuilder. Получение строки из строки типа StringBuilder посредством метода toString отрабатывает быстрее и, как правило, более предпочтительно.

Параметры:

builder - строка типа StringBuilder.

Введено в версии:

JDK 1.5

Методы. Детальное описание.

charAt

char charAt(int index)

Возвращает символ из строки по указанному индексу. Индекс изменяется от 0 до length() - 1. Первый символ последовательности имеет индекс 0, следующий - 1 и т.д. Если символ с определенным индексом является суррогатом, то будет возвращено суррогатное значение.

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

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

Параметры:

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

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

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

codePointAt

int codePointAt(int index)

Возвращает символ (кодовую точку Unicode) по указанному индексу. Индекс ссылается символьные значения (кодовые блоки Unicode) и изменяется от 0 до length() - 1. Если символ, определенный по указанному символу является верхним суррогатом, следующий индекс меньше чем длина данной строки, и символ в следующей позиции является нижним суррогатом, то будет возвращена добавочная кодовая точка, соответствующая суррогатной паре. Иначе возвращается символ по указанному индексу.

Параметры:

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

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

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

Введено в версии:

1.5

codePointBefore

int codePointBefore(int index)

Возвращает символ (кодовую точку Unicode) до указанного индекса. Индекс ссылается на символ (кодовые блоки Unicode) и изменяется от 1 до length(). Если символ в позиции (index - 1) является нижним суррогатом, (index - 2) не отрицателен и символ в позиции (index - 2) является верхним суррогатом, то будет возвращена добавочная кодовая точка, которая соответствует суррогатной паре. Если символ в позиции index - 1 является непарным верхним или нижним суррогатом, то будет возвращен суррогат.

Параметры:

index – индекс, следующий за кодовой точкой, которая должна быть возвращена

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

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

Введено в версии:

1.5

codePointCount

int codePointCount(beginIndex, int endIndex)

Возвращает количество кодовых точек Unicode в указанном текстовом диапазоне данной строки. Текстовый диапазон начинается с указанного beginIndex и распространяется включительно до позиции endIndex - 1. Таким образом, длина текстового диапазона в символах будет endIndex-beginIndex. Каждый непарный суррогат в текстовом диапазоне подсчитывается как одна кодовая точка.

Параметры:

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

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

Throws:

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

Введено в версии:

1.5

compareTo

int compareTo(String anotherString)

Сравнивает две строки лексикографически. Cравнение основано на значении Unicode каждого символа в строках. Последовательность симоволов, представленная данной строкой объекта типа String сравнивается лексикографически с последовательностью символов представленной строкой аргумента. Результат будет отрицательным целым, если объект String лексикографически превышает строку аргумента. Результат будет положительным целым, если объект типа String лексикографически меньше аргумента строки. Результат будет нулем, если строки равны. compareTo возращает 0, когда метод equals(Object) возвратит true.

Определение лексикографического порядка. Если две строки различны, тогда либо они имеют различные символы по какому-то индексу, который является допустимым у обеих строк, либо их длина различна, либо обе строки различны. Если они имеют различные символы в одной или нескольких позициях, то пускай k будет наименьшим таким индексом; тогда строка, чей символ в позиции k имеет наименьшее значение, как определено в операторе < , лексикографически превышает другую строку. В таком случае compareTo возвратит разность двух символьных значений в позиции k в двух строках:

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

Если не существует индекса, в позиции которого обе строки различны, тогда более короткая строка лексикографически превышает длинную строку. В этом случае compareTo возвратит разность длин строк:

this.length()-anotherString.length()

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

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

Параметры:

anotherString – строка, с которой будет происходить сравнение.

Возвращает:

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

compareToIgnoreCase

int compareToIgnoreCase(String str)

Сравнивает две строки лексикографически, игнорируя различия в регистре символов. Этот метод возвращает целое число, которое указывает, что вызов compareTo с нормализированными версиями строк, где различия в регистре символов игнорируются вызовом Character.toLowerCase(Character.toUpperCase(character)) для каждого символа.

Примите во внимание, что этот метод не учитывает локаль, и будет приводить к неудовлетворительному порядку для определенной локали. java.text package обеспечивает сортировщики и допускает чувствительный к локали порядок.

Параметры:

str – строка, с которой будет происходить сравнение.

Возвращает:

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

Введено в версии:

1.2

concat

String concat(String str)

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

Примеры:

"cares".concat("s") возвратит "caress"

"to".concat("get").concat("her") returns "together"

Параметры:

str – строка, которая присоединяется к концу данной строки.

Возвращает:

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

contains

boolean contains(CharSequence cs)

Возвращает true если и только если данная строка содержит указанную символьную последовательность.

Параметры:

s – последовательность, которая ищется.

Возвращает:

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

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

NullPointerException, если s - null.

Введено в версии:

1.5

contentEquals

boolean contentEquals(CharSequence cs)

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

Параметры:

сs – последовательность, которая сравнивается с данной строкой.

Возвращает:

true, если данная строка представляет такую же символьную последовательность символьных значений как и указанная последовательность, иначе false.

Введено в версии:

1.5

contentEquals

boolean contentEquals(StringBuffer sb)

Сравнивает данную строку с указанной строкой StringBuffer. Результатом будет true, если и только если данная строка представляет ту же символьную последовательность, как и указанная строка StringBuffer.

Параметры:

sb – строка типа StringBuffer которая будет сравниваться с данной строкой.

Возвращает:

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

Введено в версии:

1.4

copyValueOf

static String copyValueOf(char[] data)

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

Параметры:

data - массив символов

Возвращает:

Строка, которая содержит символы символьного массива

copyValueOf

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

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

Параметры:

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

offset - начальное смещение подмассива.

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

Возвращает:

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

endsWith

boolean endsWith(String suffix)

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

Параметры:

suffix - суффикс.

Возвращает:

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

equals

boolean equals(Object anObject)

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

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

equals в классе Object.

Параметры:

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

Возвращает:

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

equalsIgnoreCase

boolean equalsIgnoreCase(String anotherString)

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

Два символа c1 и c2 считаются эквивалентными, игнорируя регистр, если выполняется хотя бы одно из следующих условий:

— два символа явяются одинаковыми (путем сравнения оператором ==);

— применение метода Character.toUpperCase(char) к каждому символу дает один и тот же результат;

— применение метода Character.toLowerCase(char) к каждому символу дает один и тот же результат.

Параметры:

anotherString - строка для сравнения с данной строкой.

Возвращает:

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

format

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

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

Параметры:

l - локаль для применения в ходе форматирования. Если l - null, то не применяется никакой локализации форматирования.

format - строка форматирования.

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

Возвращает:

Форматированная строка.

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

IllegalFormatException - если формат строки содержит недопустимый синтаксис, спецификатор форматирования, который несовместим с данными аргументами, неподходящие аргументы для строки форматирования или другие недопустимые условия. Для определения всех возможных ошибок форматирования смотрите раздел Details спецификации класса Formatter.

NullPointerException - если format - null

Введено в версии:

1.5

format

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

Возвращает форматированную строку, используя указанный формат строки и аргументы. Локаль, которая всегда будет использоваться, возвращается методом Locale.getDefault().

Параметры:

format - строка форматирования.

Возвращает:

Форматированная строка.

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

NullPointerException - если format – null.

Введено в версии:

1.5

getBytes

byte[] getBytes()

Кодирует данную строку в последовательность байтов, используя платформенный набор символов по умолчанию, сохраняя результат в новый байтовый массив. Поведение данного метода, кода строка не может быть преобразована в набор символов по умолчанию не определено.

Класс CharsetEncoder должен быть использован, когда требуется дополнительный контроль над процессом кодировки.

Возвращает:

Результирующий массив байт.

Введено в версии:

1.1

getBytes

byte[] getBytes(Charset charset)

Кодирует данную строку в последовательность байт, используя заданный символьный набор, сохраняя результат в новом массиве байт. Этот метод всегда заменяет неправильно заданный и неотображаемый символьный набор последовательности на их эквиваленты из символьного набора по умолчанию в байтовый массив. Класс CharsetEncoder нужно использовать, когда требуется больший контроль над процессом кодирования.

Параметры:

charset - Charset, использующаяся для кодирования строки.

Возвращает:

Результирующий байтовый массив.

Введено в версии:

1.6

getBytes

byte[] getBytes(String charsetName)

Кодирует данную строку в последовательность байт, используя имя символьного набора, сохраняя результат в новом массиве байт. Поведение данного метода, когда эта строка не может быть закодирована в заданный символьный набор, не определено. Класс CharsetEncoder должен быть использован, когда требуется больший контроль над процессом кодирования.

Параметры:

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

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

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

Введено в версии:

1.1

getChars

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

Копирует символы из данной строки в результирующий массив символов dst. Первый символ будет скопирован из позиции srcBegin; последний символ будет скопирован из позиции srcEnd - 1 (таким образом, общее количество символов, которое будет скопировано, составит srcEnd-srcBegin). Символы копируются в подмассив dst, начиная с позиции dstBegin и заканчивая в позиции: dstbegin + (srcEnd-srcBegin) – 1.

Параметры:

srcBegin - индекс первого символа в строке, которой будет происходить копирование.

srcEnd - индекс после последнего символа в строке, которой будет происходить копирование.

dst - результирующий массив.

dstBegin - начальное смещение в результирующем массиве.

Throws:

IndexOutOfBoundsException - если возникает одна из следующих ситуаций:

srcBegin отрицательно

srcBegin больше чем srcEnd

srcEnd больше чем длина данной строки

dstBegin отрицательно

dstBegin+(srcEnd-srcBegin) больше чем dst.length

hashCode

int hashCode()

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

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

используется целочисленная арифметика, где s[i] является i-ым символом строки, n длина строки, и ^ отражает степень. (Хэш-значение пустой строки - 0)

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

hashCode в классе Object.

Возвращает:

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

indexOf

int indexOf(ch)

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

this.charAt(k) == ch

будет true. Для других значений ch, это такое наименьшее значение k, что результатом:

this.codePointAt(k) == ch

будет true. В любом случае, если нет такого вхождения символа в данной строке, тогда будет возвращено -1.

Параметры:

ch - символ (кодовая точка Unicode).

Возвращает:

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

indexOf

int indexOf(int ch, int fromIndex)

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

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

будет true. Для других значений ch, это такое наименьшее значение k, что результатом:

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

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

Параметры:

ch - символ (кодовая точка Unicode).

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

Возвращает:

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

indexOf

int indexOf(String str)

Возвращает индекс внутри данной строки первого вхождения указанной подстроки. Будет возвращено целое число в том случае, если наименьшее значение k в результате:

this.startsWith(str, k)

будет true.

Параметры:

str - любая строка.

Возвращает:

Если строковый аргумент встречается как подстрока внутри данного объекта, тогда будет возвращен индекс первого символа первой такой подстроки; если она не встречается как подстрока, то будет возвращено -1.

indexOf

int indexOf(String str, int fromIndex)

Возвращает индекс внутри данной строки первого вхождения указанной подстроки, начиная с указанного символа. Будет возвращено целое число в случае, если наименьшее значение k будет:

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

Если такого значения k не существует, тогда будет возвращено -1.

Параметры:

str - подстрока которая будет искаться.

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

Возвращает:

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

intern

String intern()

Возвращает каноническое представление для данного строкового объекта. Пул строк изначально пуст, и поддерживается только классом String. Когда запускается метод intern, если пул уже содержит строку равную данному объекту строке как определено методом equals(Object), тогда будет возвращена строка из пула. Иначе строковый объект будет добавлен в пул и будет возвращена ссылка на данный строковый объект. Из этого следует, что для двух строк s и t, s.intern() == t.intern() будет true, только если s.equals(t) будет true. Все строковые литералы и константы-строки интернируются. Строковые литералы определены в Java Language Specification.

Возвращает:

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

isEmpty

boolean isEmpty()

Возвращает true если и только если длина данной строки length() равна 0 иначе false.

Возвращает:

true, если length() дает 0, иначе false.

Введено в версии:

1.6

lastIndexOf

int lastIndexOf(int ch)

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

Для значений ch в диапазоне от 0 до 0xFFFF (включительно), будет возвращен индекс (в кодовых блоках Unicode) если наибольшее значение k такое, что:

this.charAt(k) == ch

будет true. Для других значений ch, это наибольшее значение k такое, что:

this.codePointAt(k) == ch

будет true. В любом случае, если символ не встречается в данной строке, тогда будет возвращено -1. Строка ищется к началу, начиная от последнего символа.

Параметры:

ch - символ (кодовая точка Unicode).

Возвращает:

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

lastIndexOf

int lastIndexOf(int ch, int fromIndex)

Возвращает индекс внутри данной строки последнего вхождения указанного символа, осуществляя поиск к началу строки, начиная с указанного индекса. Будет возвращено целое число, являющееся наименьшим значением k для которого:

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

Если такого значения k не существует, то будет возвращено -1.

Параметры:

str - подстрока для поиска (кодовая точка Unicode).

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

Возвращает:

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

lastIndexOf

int lastIndexOf(String str)

Возвращает индекс внутри данной строки последнего вхождения указанной строки. Крайняя пустая строка "" справа считается вхождением по индексу this.length(). Возвращаемый индекс это такое наибольшее значение k, что:

this.sartsWith(str, k)

будет true.

Параметры:

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

Возвращает:

Если строковый аргумент встречается один или более раз как подстрока внутри данного объекта, тогда удет возвращен индекс первого символа последней такой подстроки. Если она не стречается как подстрока, то будет возвращено -1.

lastIndexOf

int lastIndexOf(String str, int fromIndex)

Возвращает индекс внутри данной строки последнего вхождения указанной подстроки, осуществляя поиск к началу строки, начиная с указанного индекса. Будет возвращено целое число, являющееся наименьшим значением k для которого:

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

Если такого значения k не существует, то будет возвращено -1.

Параметры:

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

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

Возвращает:

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

length

int length()

Возвращает длину строки. Фактически возаращает длину последовательности символов, представленную данным объектом. Длина равна количеству кодовых блоков Unicode в строке.

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

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

Возвращает:

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

matches

boolean matches(String regex)

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

Pattern.matches(regex,str)

Параметры:

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

Возвращает:

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

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

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

Введено в версии:

1.4

offsetByCodePoints

int offsetByCodePoints(int index, int codePointOffset)

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

Параметры:

index - индекс который является смещением.

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

Возвращает:

Индекс внутри данной строки.

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

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

Введено в версии:

1.5

regionMatches

boolean regionMatches(boolean ignoreCase, int toffset, String other, int offset, int len)

Проверяет, являются ли две строки регионально эквивалентными. Подстрока данного строкового объекта сравнивается с подстрокой аргумента other. Результатом будет true, если эти подстроки представляют одинаковую символьную последовательность, игнорируя регистр символов и если ignoreCase рано true. Подстрока данного строкового объекта будет сравниваться, начиная с индекса toffset и имеет длину len. Подстрока other будет сравниваться, начиная с индекса offset и имеет длину len. Результатом будет false, если и только если хотя бы одно из следующих выражений будет true:

— toffset отрицательно.

— offset отрицательно.

— toffset+len больше чем длина данного строкового объекта.

— offset+len больше чем длина другого аргумента.

— ignoreCase является false и существует некоторое неотрицательное целое k, меньшее чем len такое что:

this.charAt(toffset+k) != other.charAt(offset+k)

— ignoreCase является true и существует некоторое неотрицательное целое k, меньшее чем len такое что:

Character.toLowerCase(this.charAt(toffset+k)) !=

Character.toLowerCase(other.charAt(offset+k))

и:

Character.toUpperCase(this.charAt(toffset+k)) !=

Character.toUpperCase(other.charAt(offset+k))

Параметры:

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

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

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

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

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

Возвращает:

true, если указанная подобласть данной строки соответствует указанной подобласти строки-аргумента; иначе false. Любой из двух аспектов: точное соответствие или независимость от регистра символов, зависит от аргумента ignoreCase.

regionMatches

boolean regionMatches(int toffset, String other, int offset, int len)

Проверяет, являются ли две строки регионально эквивалентными. Подстрока данного строкового объекта сравнивается с подстрокой аргумента. Результат будет true, если эти подстроки представляют идентичные символьные последовательности. Подстрока данного строкового объекта будет сравниваться, начиная с индекса toffset и имеет длину len. Подстрока аргумента будет сравниваться, начиная с индекса offset и имеет длину len. Результат будет false, если и только если одно из следующих выражений будет true:

— toffset отрицательно.

— offset отрицательно.

— toffset+len больше чем длина данного строкового объекта.

— offset+len больше чем длина другого аргумента.

— Существует некоторое неотрицательное целое k меньше чем len такое что: this.charAt(toffset+k) != other.charAt(offset+k)

Параметры:

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

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

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

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

Возвращает:

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

replace

String replace(char oldChar, char newChar)

Возвращает новую строку, в которой заменены все вхождения символа oldChar в данной строке на символ newChar. Если символ oldChar не встречается в символьной последовательности, представленной данным строковым объектом, тогда будет возвращена ссылка на данный строковый объект. Иначе, будет создан новый строковый объект, который представляет символьную последовательность, идентичную символьной последовательности, представленной данный строковым объектом, исключая каждое вхождение oldChar, которое будет заменено newChar.

Примеры:

"mesquite in your cellar".replace('e', 'o')

возвратит "mosquito in your collar"

"the war of baronets".replace('r', 'y')

возвратит "the way of bayonets"

"sparring with a purple porpoise".replace('p', 't')

возвратит "starring with a turtle tortoise"

"JonL".replace('q', 'x') returns "JonL" (no change)

Параметры:

oldChar - старый символ.

newChar - новый символ.

Возвращает:

Строка, образованная из данной строки с заменой всех вхождений oldChar на newChar.

replace

String replace(CharSequence target, CharSequence replacement)

Заменяет каждую подстроку данной строки, которая соответствует литеральной последовательности target на указанную литеральную последовательность. Замена начинается с начала строки до конца, например, заменяет "aa" на "b" в строке "aaa" скорее с результатом "ba" чем "ab".

Параметры:

target - последовательность символьных значений для замены.

replacement - последовательнсоть символьных значений для замены.

Возвращает:

Результирующая строка.

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

NullPointerException - если target или replacement являются null.

Введено в версии:

1.5

replaceAll

String replaceAll(String regex, String replacement)

Заменяет каждую подстроку данной строки, которая соответствует заданному регулярному выражению на строку replacement. Запуск данного метода в форме str.replaceAll(regex, repl) приведет точно к такому же результату как выражение:

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

Параметры:

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

Возвращает:

Результирующая строка.

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

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

Введено в версии:

1.4

replaceFirst

String replaceFirst(String regex, String replacement)

Заменяет первое вхождение данной строки, которое соответствует заданному регулярному выражению regex на строку replacement. Запуск данного метода в форме str.replaceAll(regex, repl) приведет точно к такому же результату как выражение:

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

Параметры:

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

Возвращает:

Результирующая строка.

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

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

Введено в версии:

1.4

split

String[] split(String regex)

Разбивает данную строку на элементы, которые разделены строками, соответствующими заданному регулярному выражению. Данный метод работает также, как если бы запускался метод split с двумя аргументами с заданным выражением и с аргументом limit равному нулю, проходя пустые строки и тем самым не включая их в результирующий массив.

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

Regex	Result
:	{ "boo", "and", "foo" }
o	{ "b", "", ":and:f" }

Параметры:

regex - разделительное регулярное выражение.

Возвращает:

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

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

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

Введено в версии:

1.4

split

String[] split(String regex, int limit)

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

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

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

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

Regex	Limit	Result
:	2	{ "boo", "and:foo" }
:	5	{ "boo", "and", "foo" }
:	-2	{ "boo", "and", "foo" }
o	5	{ "b", "", ":and:f", "", "" }
o	-2	{ "b", "", ":and:f", "", "" }
o	0	{ "b", "", ":and:f" }

Запуск данного метода в форме str.split(regex, n) даст такие же результаты как выражение:

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

Параметры:

regex - разделительное регулярное выражение.

Возвращает:

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

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

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

Введено в версии:

1.4

startsWith

boolean startsWith(String prefix)

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

Параметры:

prefix - префикс.

Возвращает:

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

Введено в версии:

1.1

startsWith

boolean startsWith(String prefix, int offset)

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

Параметры:

prefix - префикс.

offset - где начинать просмотр данной строки.

Возвращает:

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

this.substring(toffset).startsWith(prefix)

subSequence

CharSequence subSequence(int beginIndex, int endIndex)

Возвращает новую символьную последовательность, которая является подпоследовательностью данной последовательности. Запуск данного метода в форме str.subSequence(begin, end) ведет себя точно так же как запуск str.substring(begin, end). Данный метод определен так, что класс String может реализовать интерфейс CharSequence.

Параметры:

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

endIndex - конечный индекс исключительно.

Возвращает:

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

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

методе subsequence в интерфейсе CharSequence.

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

IndexOutOfBoundsException - если beginIndex или endIndex являются отрицательными, если endIndex больше чем length() или если beginIndex больше чем endIndex.

Введено в версии:

1.4

substring

String substring(int beginIndex)

Возвращает новую строку, которая является подстрокой данной строки. Подстрока начинается символом по указанному индексу и распространяется до конца данной строки.

Примеры:

"unhappy".substring(2) возвратит "happy"

"Harbison".substring(3) возвратит "bison"

"emptiness".substring(9) возвратит "" (пустая строка)

Параметры:

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

Возвращает:

Подстрока.

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

IndexOutOfBoundsException - если beginIndex отрицателен или больше чем длина данного объекта строки.

substring

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 больше, чем длина данного объекта строки, или если beginIndex больше чем endIndex.

toCharArray

char[] toCharArray()

Конвертирует данную строку в новый символьный массив.

Возвращает:

Новый символьный массив, длина которого будет равна длине данной строки и содержимое которого будет инициализировано символьной последовательностью, представленной данной строкой.

toLowerCase

String toLowerCase()

Конвертирует все символы данной строки в нижний регистр, используя правила локали по умолчанию. Это эквивалент вызова toLowerCase(Locale.getDefault()).

Возвращает:

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

toLowerCase

String toLowerCase(Locale locale)

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

Примеры преобразования нижнего регистра:

Language Code of Locale	Upper Case	Lower Case	Description
tr (Turkish)	\u0130	\u0069	capital letter I with dot above -> small letter i
tr (Turkish)	\u0049	\u0131	capital letter I -> small letter dotless i
(all)	French Fries	french fries	lowercased all chars in String

Параметры:

locale - использует правила трансформации регистров символов для данной локали.

Возвращает:

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

Введено в версии:

1.1

toString

String toString()

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

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

Методе toString в интерфейсе CharSequence.

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

Метод toString в классе Object.

Возвращает:

Саму строку.

toUpperCase

String toUpperCase()

Конвертирует все символы в данной строке в верхний регистр, используя правила локали по умолчанию. Данный метод является эквивалентом вызова метода toUpperCase(Locale.getDefault()).

Возвращает:

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

toUpperCase

String toUpperCase(Locale locale)

Конвертирует все символы в данной строке в верхний регистр, используя правила заданной локали. Преобразование регистра символов основано на версии Unicode Standard, определенной в классе Character. Преобразование символов происходит не всегда 1:1, результирующая строка может быть с длиной, отличной от исходной строки. Примеры локаль-зависимого преобразования и 1:M преобразования регистра символов приведены в следующей таблице:

Language Code of Locale	Lower Case	Upper Case	Description
tr (Turkish)	\u0069	\u0130	small letter i -> capital letter I with dot above
tr (Turkish)	\u0131	\u0049	small letter dotless i -> capital letter I
(all)	\u00df	\u0053 \u0053	small letter sharp s -> two letters: SS
(all)	Fahrvergnügen	FAHRVERGNÜGEN

Параметры:

locale - использует правила трансформации регистра данной локали.

Возвращает:

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

Введено в версии:

1.1.

trim

String trim()

Возвращает копию строки, без ведущих и замыкающих пробелов. Если данный объект-строка представляет собой пустую символьную последовательность, или первый и последний символы символьной последовательнсоти представленной данной объектом-строкой оба имеют коды больше чем '\u0020' (символ пробела), тогда будет возвращена ссылка на данный объект. Иначе, если не существует символа с кодом, большим чем '\u0020' в строке, тогда будет создан и возвращен новый объект-строка, представляющий собой пустую строку. Иначе, пускай k будет индексом первого символа в строке чей код больше чем '\u0020', и пускай m будет индексом последнего символа в строке чей код больше чем '\u0020'. Создается новый объект-строка, представляющий собой подстроку данной строки, которая начинается символом по индексу k и заканчиваеься символом по индексу m, является результатом this.substring(k, m+1).

Этот метод может быть использован для обрезки пробелов (как определено выше) вначале и в конце строки.

Возвращает:

Копию данной строки с удаленными ведущими и замыкающими пробелами, или данную строку, если она не имеет таковых.

valueOf

String valueOf(boolean b)

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

Параметры:

b - переменная булевого типа.

Возвращает:

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

valueOf

String valueOf(char c)

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

Параметры:

с - символ.

Возвращает:

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

valueOf

String valueOf(char[] data)

Возвращает стрковое представление аргумента типа char[] (символьный массив). Копируется содержимое символьного массива; последующая модификация символьного массива не влияют на новую созданную строку.

Параметры:

data - символьный массив.

Возвращает:

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

valueOf

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

Возвращает строковое представление специфического подмассива аргумента типа char[] (символьный массив). Смещене аргумента является индексом первого символа подмассива. Аргумент count определяет длину подмассива. Копируется содержимое подмассива; последующая модификация символьного массива не влияют на новую созданную строку.

Параметры:

data - символьный массив.

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

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

Возвращает:

Новая строка представляющая последовательность символов заключенная в подмассиве аргумента символьного массива.

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

IndexOutOfBoundException - если смещение отрицательно или count отрицательно или offset+count больше чем data.length.

valueOf

String valueOf(double d)

Возвращает строковое представление аргумента типа double. Представление аргумента будет возвращено методом Double.toString.

Параметры:

d - переменная типа double.

Возвращает:

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

valueOf

String valueOf(float f)

Возвращает строковое представление аргумента типа float. Представление аргумента будет возвращено методом Float.toString().

Параметры:

f - переменная типа float.

Возвращает:

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

valueOf

String valueOf(int i)

Возвращает строковое представление аргумента типа int. Представление аргумента будет возвращено методом Integer.toString().

Параметры:

i - переменная типа int.

Возвращает:

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

valueOf

String valueOf(long l)

Возвращает строковое представление аргумента типа long. Представление аргумента будет возвращено методом Long.toString().

Параметры:

l - переменная типа long.

Возвращает:

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

valueOf

String valueOf(Object obj)

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

Параметры:

obj - переменная типа Object.

Возвращает:

Если аргумент null, тогда будет возвращена строка "null"; иначе будет возвращено значение obj.toString().

Ссылки:

1. Class java.lang.String. Java^TM 2 Platform Standard Edition 6.0 API Specification.

http://java.sun.com

Перевод:

Загребин Виктор Александрович

< Раздел “Язык Java” > < Раздел “Технологии Java” > < Основная страница >