Пакет kotlin.text
Функции для работы с текстом и регулярными выражениями.
Типы
Appendable
Объект, к которому можно добавлять последовательности символов и значения.
interface Appendable
typealias Appendable = Appendable
CharCategory
Представляет общую категорию символов в спецификации Unicode.
enum class CharCategory
CharDirectionality
Представляет направление символа Unicode. Направление символа используется для расчета визуального порядка текста.
enum class CharDirectionality
Charsets
Определения констант для стандартных кодировок символов. Эти кодировки гарантированно доступны на каждой реализации Java-платформы.
object Charsets
HexFormat
Представляет варианты шестнадцатеричного формата.
class HexFormat
MatchGroup
Представляет результаты из одного захватывающей группы в MatchResult Regex.
class MatchGroup
data class MatchGroup
MatchGroupCollection
Представляет коллекцию захваченных групп в одном совпадении регулярного выражения.
interface MatchGroupCollection : Collection<MatchGroup?>
MatchNamedGroupCollection
Расширяет MatchGroupCollection, предоставляя способ получения сопоставленных групп по имени, когда это поддерживается регулярным выражением.
interface MatchNamedGroupCollection : MatchGroupCollection
MatchResult
Представляет результаты из одного совпадения регулярного выражения.
interface MatchResult
Regex
Представляет скомпилированное регулярное выражение. Предоставляет функции для сопоставления строк в тексте с шаблоном, замены найденных вхождений и разделения текста вокруг совпадений.
class Regex
class Regex : Serializable
RegexOption
Предоставляет значения перечисления для установки параметров регулярного выражения.
enum class RegexOption
enum class RegexOption : FlagEnum
StringBuilder
Изменяемая последовательность символов.
class StringBuilder : Appendable, CharSequence
typealias StringBuilder = StringBuilder
class StringBuilder : CharSequence, Appendable
Typography
Определяет имена символов Unicode, используемых в правильной типографике.
object Typography
Исключения
CharacterCodingException
Исключение, выбрасываемое при ошибке кодирования или декодирования символов.
open class CharacterCodingException : Exception
typealias CharacterCodingException = CharacterCodingException
Расширения для внешних классов
java.lang.Appendable
java.lang.StringBuilder
java.util.regex.Pattern
Свойства
категория
Возвращает общую категорию Unicode этого символа.
val Char.category: CharCategory
направление
Возвращает свойство направления Unicode для заданного символа.
val Char.directionality: CharDirectionality
индексы
Возвращает диапазон допустимых индексов символов для этой последовательности символов.
val CharSequence.indices: IntRange
последний индекс
Возвращает индекс последнего символа в последовательности символов или -1, если она пуста.
val CharSequence.lastIndex: Int
Функции
all
Возвращает true если все символы соответствуют заданному предикату.
fun CharSequence.all(predicate: (Char) -> Boolean): Boolean
any
Возвращает true если последовательность символов содержит хотя бы один символ.
fun CharSequence.any(): Boolean
Возвращает true если хотя бы один символ соответствует заданному предикату.
fun CharSequence.any(predicate: (Char) -> Boolean): Boolean
append
Добавляет все аргументы к заданному Appendable.
fun <T : Appendable> T.append(vararg value: CharSequence?): T
fun StringBuilder.append(obj: Any?): StringBuilder
fun StringBuilder.append( str: CharArray, offset: Int, len: Int ): StringBuilder
Добавляет все аргументы к заданному StringBuilder.
fun StringBuilder.append( vararg value: String? ): StringBuilder
fun StringBuilder.append(vararg value: Any?): StringBuilder
appendLine
Добавляет символ новой строки (\n) к этому Appendable.
fun Appendable.appendLine(): Appendable
Добавляет значение в данный Appendable и символ новой строки (\n) после него.
fun Appendable.appendLine(value: CharSequence?): Appendable
fun Appendable.appendLine(value: Char): Appendable
Добавляет символ новой строки (\n) в этот StringBuilder.
fun StringBuilder.appendLine(): StringBuilder
Добавляет значение в этот StringBuilder, за которым следует символ новой строки (\n).
fun StringBuilder.appendLine( value: CharSequence? ): StringBuilder
fun StringBuilder.appendLine(value: String?): StringBuilder
fun StringBuilder.appendLine(value: Any?): StringBuilder
fun StringBuilder.appendLine(value: CharArray): StringBuilder
fun StringBuilder.appendLine(value: Char): StringBuilder
fun StringBuilder.appendLine(value: Boolean): StringBuilder
fun StringBuilder.appendLine(value: Byte): StringBuilder
fun StringBuilder.appendLine(value: Short): StringBuilder
fun StringBuilder.appendLine(value: Int): StringBuilder
fun StringBuilder.appendLine(value: Long): StringBuilder
fun StringBuilder.appendLine(value: Float): StringBuilder
fun StringBuilder.appendLine(value: Double): StringBuilder
appendln
fun StringBuilder.appendln(it: String): StringBuilder
fun StringBuilder.appendln(it: Boolean): StringBuilder
fun StringBuilder.appendln(it: Byte): StringBuilder
fun StringBuilder.appendln(it: Short): StringBuilder
fun StringBuilder.appendln(it: Int): StringBuilder
fun StringBuilder.appendln(it: Long): StringBuilder
fun StringBuilder.appendln(it: Float): StringBuilder
fun StringBuilder.appendln(it: Double): StringBuilder
fun StringBuilder.appendln(it: Any?): StringBuilder
fun StringBuilder.appendln(): StringBuilder
appendRange
Добавляет подпоследовательность указанной последовательности символов значение к этому Appendable и возвращает этот экземпляр.
fun <T : Appendable> T.appendRange( value: CharSequence, startIndex: Int, endIndex: Int ): T
Добавляет символы в подмассиве указанного массива символов значение в этот объект StringBuilder и возвращает этот экземпляр.
fun StringBuilder.appendRange( value: CharArray, startIndex: Int, endIndex: Int ): StringBuilder
Добавляет подпоследовательность указанной последовательности символов значение в этот объект StringBuilder и возвращает этот экземпляр.
fun StringBuilder.appendRange( value: CharSequence, startIndex: Int, endIndex: Int ): StringBuilder
asIterable
Создаёт экземпляр Iterable, который оборачивает исходную последовательность символов, возвращая её символы при итерации.
fun CharSequence.asIterable(): Iterable<Char>
asSequence
Создаёт экземпляр Sequence, который оборачивает исходную последовательность символов, возвращая её символы при итерации.
fun CharSequence.asSequence(): Sequence<Char>
associate
associateBy
Возвращает Map, содержащую символы из заданной последовательности символов, индексированные по ключу, возвращаемому функцией keySelector, применённой к каждому символу.
fun <K> CharSequence.associateBy( keySelector: (Char) -> K ): Map<K, Char>
Возвращает Map, содержащую значения, предоставленные функцией valueTransform, индексированные функцией keySelector, применёнными к символам заданной последовательности символов.
fun <K, V> CharSequence.associateBy( keySelector: (Char) -> K, valueTransform: (Char) -> V ): Map<K, V>
associateByTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, применённой к каждому символу заданной последовательности символов, а значением является сам символ.
fun <K, M : MutableMap<in K, in Char>> CharSequence.associateByTo( destination: M, keySelector: (Char) -> K ): M
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, а значение предоставляется функцией valueTransform, применённой к символам заданной последовательности символов.
fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M
associateTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, предоставленными функцией transform, применённой к каждому символу заданной последовательности символов.
fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo( destination: M, transform: (Char) -> Pair<K, V> ): M
associateWith
Возвращает Map, где ключами являются символы из заданной последовательности символов, а значения производятся функцией valueSelector, применённой к каждому символу.
fun <V> CharSequence.associateWith( valueSelector: (Char) -> V ): Map<Char, V>
associateWithTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение для каждого символа заданной последовательности символов, где ключом является сам символ, а значением является результат применения функции valueSelector к этому ключу.
fun <V, M : MutableMap<in Char, in V>> CharSequence.associateWithTo( destination: M, valueSelector: (Char) -> V ): M
buildString
Создаёт новую строку, заполняя недавно созданный StringBuilder с помощью предоставленного builderAction, а затем преобразуя его в String.
fun buildString( builderAction: StringBuilder.() -> Unit ): String
Создаёт новую строку, заполняя недавно созданный StringBuilder, инициализированный заданным capacity, с помощью предоставленного builderAction, а затем преобразуя его в String.
fun buildString( capacity: Int, builderAction: StringBuilder.() -> Unit ): String
capitalize
Возвращает копию этой строки с заглавной первой буквой, используя правила указанного locale, или исходную строку, если она пустая или уже начинается с заглавной буквы.
fun String.capitalize(locale: Locale): String
Возвращает копию этой строки с заглавной первой буквой, используя правила по умолчанию locale, или исходную строку, если она пустая или уже начинается с заглавной буквы.
fun String.capitalize(): String
charset
Возвращает именованный набор символов с заданным именем charsetName.
fun charset(charsetName: String): Charset
chunked
Разбивает эту последовательность символов на список строк, каждая из которых не превышает заданного размера.
fun CharSequence.chunked(size: Int): List<String>
Разбивает эту последовательность символов на несколько последовательностей символов, каждая из которых не превышает заданного размера, и применяет заданную функцию преобразования к каждой.
fun <R> CharSequence.chunked( size: Int, transform: (CharSequence) -> R ): List<R>
chunkedSequence
Разбивает эту последовательность символов на последовательность строк, каждая из которых не превышает заданного размера.
fun CharSequence.chunkedSequence(size: Int): Sequence<String>
Разбивает эту последовательность символов на несколько последовательностей символов, каждая из которых не превышает заданного размера, и применяет заданную функцию преобразования к каждой.
fun <R> CharSequence.chunkedSequence( size: Int, transform: (CharSequence) -> R ): Sequence<R>
clear
Очищает содержимое этого билдера строк, делая его пустым, и возвращает этот экземпляр.
fun StringBuilder.clear(): StringBuilder
codePointAt
Возвращает символ (код Юникода) по указанному индексу.
fun String.codePointAt(index: Int): Int
codePointBefore
Возвращает символ (код Юникода) перед указанным индексом.
fun String.codePointBefore(index: Int): Int
codePointCount
Возвращает количество символов Юникода в указанном текстовом диапазоне этой строки.
fun String.codePointCount( beginIndex: Int, endIndex: Int ): Int
commonPrefixWith
Возвращает самую длинную строку prefix такую, что эта последовательность символов и последовательность символов other начинаются с этого префикса, учитывая, что не разделяются пары суррогатов. Если у этой и other нет общего префикса, возвращает пустую строку.
fun CharSequence.commonPrefixWith( other: CharSequence, ignoreCase: Boolean = false ): String
commonSuffixWith
Возвращает самую длинную строку suffix такую, что эта последовательность символов и последовательность символов other заканчиваются этим суффиксом, учитывая, что не разделяются пары суррогатов. Если у этой и other нет общего суффикса, возвращает пустую строку.
fun CharSequence.commonSuffixWith( other: CharSequence, ignoreCase: Boolean = false ): String
compareTo
Сравнивает две строки лексикографически, необязательно игнорируя различия в регистре.
fun String.compareTo( other: String, ignoreCase: Boolean = false ): Int
concat
fun String.concat(str: String): String
concatToString
Конкатенирует символы в этом CharArray в строку.
fun CharArray.concatToString(): String
Конкатенирует символы в этом CharArray или его поддиапазоне в строку.
fun CharArray.concatToString( startIndex: Int = 0, endIndex: Int = this.size ): String
contains
Возвращает true если эта последовательность символов содержит указанную последовательность other символов как подстроку.
operator fun CharSequence.contains( other: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта последовательность символов содержит указанный символ char.
operator fun CharSequence.contains( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта последовательность символов содержит хотя бы одно совпадение указанного регулярного выражения regex.
operator fun CharSequence.contains(regex: Regex): Boolean
contentEquals
Возвращает true если эта строка равна содержимому указанной CharSequence, false в противном случае.
fun String.contentEquals(charSequence: CharSequence): Boolean
Возвращает true если эта строка равна содержимому указанного StringBuffer, false в противном случае.
fun String.contentEquals( stringBuilder: StringBuffer ): Boolean
Возвращает true если содержимое этой последовательности символов равно содержимому указанного other, то есть обе последовательности символов содержат одинаковое количество одинаковых символов в том же порядке.
infix fun CharSequence?.contentEquals( other: CharSequence? ): Boolean
Возвращает true если содержимое этой последовательности символов равно содержимому указанного other, необязательно игнорируя разницу в регистре.
fun CharSequence?.contentEquals( other: CharSequence?, ignoreCase: Boolean ): Boolean
count
Возвращает длину этой последовательности символов.
fun CharSequence.count(): Int
Возвращает количество символов, соответствующих заданному предикату.
fun CharSequence.count(predicate: (Char) -> Boolean): Int
decapitalize
Возвращает копию этой строки с первой буквой в нижнем регистре, используя правила указанного locale, или исходную строку, если она пустая или уже начинается с буквы в нижнем регистре.
fun String.decapitalize(locale: Locale): String
Возвращает копию этой строки с первой буквой в нижнем регистре, используя правила по умолчанию locale, или исходную строку, если она пустая или уже начинается с буквы в нижнем регистре.
fun String.decapitalize(): String
decodeToString
Декодирует строку из байтов в кодировке UTF-8 в этом массиве.
fun ByteArray.decodeToString(): String
Декодирует строку из байтов в кодировке UTF-8 в этом массиве или его поддиапазоне.
fun ByteArray.decodeToString( startIndex: Int = 0, endIndex: Int = this.size, throwOnInvalidSequence: Boolean = false ): String
deleteAt
Удаляет символ по указанному индексу из этого буфера строк и возвращает этот экземпляр.
fun StringBuilder.deleteAt(index: Int): StringBuilder
deleteCharAt
Удаляет символ по указанному индексу из этого буфера строк и возвращает этот экземпляр.
fun StringBuilder.deleteCharAt(index: Int): StringBuilder
deleteRange
Удаляет символы в указанном диапазоне из этого буфера строк и возвращает этот экземпляр.
fun StringBuilder.deleteRange( startIndex: Int, endIndex: Int ): StringBuilder
digitToChar
Возвращает символ, представляющий это десятичное число. Выбрасывает исключение, если это значение не находится в диапазоне 0..9.
fun Int.digitToChar(): Char
digitToInt
Возвращает числовое значение десятичной цифры, которую представляет этот символ. Выбрасывает исключение, если этот символ не является допустимой десятичной цифрой.
fun Char.digitToInt(): Int
digitToIntOrNull
Возвращает числовое значение десятичной цифры, которую представляет этот символ, или null если этот символ не является допустимой десятичной цифрой.
fun Char.digitToIntOrNull(): Int?
drop
Возвращает подпоследовательность этой последовательности символов, из которой удалены первые n символов.
fun CharSequence.drop(n: Int): CharSequence
Возвращает строку, из которой удалены первые n символов.
fun String.drop(n: Int): String
dropLast
Возвращает подпоследовательность этой последовательности символов, из которой удалены последние n символов.
fun CharSequence.dropLast(n: Int): CharSequence
Возвращает строку, из которой удалены последние n символов.
fun String.dropLast(n: Int): String
dropLastWhile
Возвращает подпоследовательность этой последовательности символов, содержащую все символы, кроме последних, удовлетворяющих заданному предикату.
fun CharSequence.dropLastWhile( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, содержащую все символы, кроме последних, удовлетворяющих заданному предикату.
fun String.dropLastWhile( predicate: (Char) -> Boolean ): String
dropWhile
Возвращает подпоследовательность этой последовательности символов, содержащую все символы, кроме первых, удовлетворяющих заданному предикату.
fun CharSequence.dropWhile( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, содержащую все символы, кроме первых, удовлетворяющих заданному предикату.
fun String.dropWhile(predicate: (Char) -> Boolean): String
elementAt
Возвращает символ по заданному индексу или выбрасывает исключение IndexOutOfBoundsException, если индекс выходит за пределы этой последовательности символов.
fun CharSequence.elementAt(index: Int): Char
filterIndexed
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые соответствуют заданному предикату.
fun CharSequence.filterIndexed( predicate: (index: Int, Char) -> Boolean ): CharSequence
Возвращает строку, содержащую только те символы из исходной строки, которые соответствуют заданному предикату.
fun String.filterIndexed( predicate: (index: Int, Char) -> Boolean ): String
filterIndexedTo
Добавляет все символы, соответствующие заданному предикату, в заданное место назначения.
fun <C : Appendable> CharSequence.filterIndexedTo( destination: C, predicate: (index: Int, Char) -> Boolean ): C
filterNot
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые не соответствуют заданному предикату.
fun CharSequence.filterNot( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, содержащую только те символы из исходной строки, которые не соответствуют заданному предикату.
fun String.filterNot(predicate: (Char) -> Boolean): String
filterNotTo
Добавляет все символы, не соответствующие заданному предикату, в заданное место назначения.
fun <C : Appendable> CharSequence.filterNotTo( destination: C, predicate: (Char) -> Boolean ): C
filterTo
Добавляет все символы, соответствующие заданному предикату, в заданное место назначения.
fun <C : Appendable> CharSequence.filterTo( destination: C, predicate: (Char) -> Boolean ): C
find
Возвращает первый символ, соответствующий заданному
fun CharSequence.find(predicate: (Char) -> Boolean): Char?
firstOrNull
Возвращает первый символ или null если последовательность символов пустая.
fun CharSequence.firstOrNull(): Char?
Возвращает первый символ, соответствующий заданному
fun CharSequence.firstOrNull(
predicate: (Char) -> Boolean
): Char?
flatMap
Возвращает один список всех элементов, полученных из результатов функции
fun <R> CharSequence.flatMap(
transform: (Char) -> Iterable<R>
): List<R>
flatMapIndexed
Возвращает один список всех элементов, полученных из результатов функции
fun <R> CharSequence.flatMapIndexed(
transform: (index: Int, Char) -> Iterable<R>
): List<R>
flatMapIndexedTo
Добавляет все элементы, полученные из результатов функции .
fun <R, C : MutableCollection<in R>> CharSequence.flatMapIndexedTo( destination: C, transform: (index: Int, Char) -> Iterable<R> ): C
flatMapTo
Добавляет все элементы, полученные из результатов функции .
fun <R, C : MutableCollection<in R>> CharSequence.flatMapTo( destination: C, transform: (Char) -> Iterable<R> ): C
getOrElse
getOrNull
groupBy
Группирует символы исходной последовательности символов по ключу, возвращаемому функцией
fun <K> CharSequence.groupBy(
keySelector: (Char) -> K
): Map<K, List<Char>>
Группирует значения, возвращаемые функцией , применённой к символу, и возвращает карту, где каждый ключ группы сопоставлен списку соответствующих значений.
fun <K, V> CharSequence.groupBy( keySelector: (Char) -> K, valueTransform: (Char) -> V ): Map<K, List<V>>
groupByTo
Группирует символы исходной последовательности символов по ключу, возвращаемому функцией каждый ключ группы, связанный со списком соответствующих символов.
fun <K, M : MutableMap<in K, MutableList<Char>>> CharSequence.groupByTo( destination: M, keySelector: (Char) -> K ): M
groupingBy
Создаёт источник Grouping из последовательности символов, который можно использовать позднее с одной из операций группировки и слияния, используя указанную функцию
fun <K> CharSequence.groupingBy(
keySelector: (Char) -> K
): Grouping<Char, K>
hasSurrogatePairAt
Возвращает true , если в этой последовательности символов Unicode существует пара суррогатов по указанному индексу.
fun CharSequence.hasSurrogatePairAt(index: Int): Boolean
HexFormat
Создаёт новый HexFormat, настраивая его параметры формата с помощью указанного
fun HexFormat(builderAction: Builder.() -> Unit): HexFormat
hexToByte
Парсит значение Byte из этой строки, используя указанный
fun String.hexToByte(
format: HexFormat = HexFormat.Default
): Byte
hexToByteArray
Парсит байты из этой строки, используя указанный HexFormat.
fun String.hexToByteArray( format: HexFormat = HexFormat.Default ): ByteArray
hexToInt
Парсит целое значение Int из этой строки, используя указанный
fun String.hexToInt(
format: HexFormat = HexFormat.Default
): Int
hexToLong
Парсит значение Long из этой строки, используя указанный
fun String.hexToLong(
format: HexFormat = HexFormat.Default
): Long
hexToShort
Парсит значение Short из этой строки, используя указанный
fun String.hexToShort(
format: HexFormat = HexFormat.Default
): Short
hexToUByte
Парсит значение UByte из этой строки, используя указанный формат.
fun String.hexToUByte( format: HexFormat = HexFormat.Default ): UByte
hexToUByteArray
Парсит байты из этой строки, используя указанный HexFormat.
fun String.hexToUByteArray( format: HexFormat = HexFormat.Default ): UByteArray
hexToUInt
Парсит значение UInt из этой строки, используя указанный формат.
fun String.hexToUInt( format: HexFormat = HexFormat.Default ): UInt
hexToULong
Парсит значение ULong из этой строки, используя указанный формат.
fun String.hexToULong( format: HexFormat = HexFormat.Default ): ULong
hexToUShort
Парсит значение UShort из этой строки, используя указанный формат.
fun String.hexToUShort( format: HexFormat = HexFormat.Default ): UShort
ifBlank
Возвращает эту последовательность символов, если она не пуста и не состоит только из пробельных символов, или результат вызова функции defaultValue в противном случае.
fun <C, R> C.ifBlank( defaultValue: () -> R ): R where C : CharSequence, C : R
ifEmpty
Возвращает эту последовательность символов, если она не пуста, или результат вызова функции defaultValue, если последовательность символов пуста.
fun <C, R> C.ifEmpty( defaultValue: () -> R ): R where C : CharSequence, C : R
indexOf
Возвращает индекс в этой строке первого вхождения указанного символа, начиная с указанного startIndex.
fun CharSequence.indexOf( char: Char, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Возвращает индекс в этой последовательности символов первого вхождения указанной строки, начиная с указанного startIndex.
fun CharSequence.indexOf( string: String, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
indexOfAny
Находит индекс первого вхождения любого из указанных символов в этой последовательности символов, начиная с указанного startIndex и необязательно игнорируя регистр.
fun CharSequence.indexOfAny( chars: CharArray, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Находит индекс первого вхождения любого из указанных строк в этой последовательности символов, начиная с указанного startIndex и необязательно игнорируя регистр.
fun CharSequence.indexOfAny( strings: Collection<String>, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
indexOfFirst
Возвращает индекс первого символа, соответствующего заданному предикату, или -1, если последовательность символов не содержит такого символа.
fun CharSequence.indexOfFirst( predicate: (Char) -> Boolean ): Int
indexOfLast
Возвращает индекс последнего символа, соответствующего заданному предикату, или -1, если последовательность символов не содержит такого символа.
fun CharSequence.indexOfLast( predicate: (Char) -> Boolean ): Int
insert
insertRange
intern
Возвращает каноническое представление для этого объекта строки.
fun String.intern(): String
isBlank
Возвращает true , если эта строка пуста или состоит только из пробельных символов.
fun CharSequence.isBlank(): Boolean
isDefined
Возвращает true , если этот символ (код точки Юникода) определён в Юникоде.
fun Char.isDefined(): Boolean
isDigit
Возвращает true , если этот символ является цифрой.
fun Char.isDigit(): Boolean
isEmpty
Возвращает true , если эта последовательность символов пустая (не содержит символов).
fun CharSequence.isEmpty(): Boolean
isHighSurrogate
Возвращает true , если этот символ является старшим суррогатным кодом Юникода (также известен как ведущий суррогатный код).
fun Char.isHighSurrogate(): Boolean
isIdentifierIgnorable
Возвращает true , если этот символ (код точки Юникода) должен рассматриваться как игнорируемый символ в идентификаторе Java или идентификаторе Юникода.
fun Char.isIdentifierIgnorable(): Boolean
isISOControl
Возвращает true , если этот символ является управляющим символом ISO.
fun Char.isISOControl(): Boolean
isWhitespace
Определяет, является ли символ пробелом в соответствии со стандартом Unicode. Возвращает true если символ является пробелом.
fun Char.isWhitespace(): Boolean
iterator
Итератор для символов заданной последовательности символов.
operator fun CharSequence.iterator(): CharIterator
last
Возвращает последний символ.
fun CharSequence.last(): Char
Возвращает последний символ, соответствующий заданному предикату.
fun CharSequence.last(predicate: (Char) -> Boolean): Char
lastIndexOf
Возвращает индекс последнего вхождения указанного символа в этой последовательности символов, начиная с указанного startIndex.
fun CharSequence.lastIndexOf( char: Char, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Возвращает индекс последнего вхождения указанной строки в этой последовательности символов, начиная с указанного startIndex.
fun CharSequence.lastIndexOf( string: String, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
lastIndexOfAny
Находит индекс последнего вхождения любого из указанных символов в этой последовательности символов, начиная с указанного startIndex и при необходимости игнорируя регистр.
fun CharSequence.lastIndexOfAny( chars: CharArray, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Находит индекс последнего вхождения любой из указанных строк в этой последовательности символов, начиная с указанного startIndex и при необходимости игнорируя регистр.
fun CharSequence.lastIndexOfAny( strings: Collection<String>, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
lastOrNull
Возвращает последний символ или null если последовательность символов пуста.
fun CharSequence.lastOrNull(): Char?
Возвращает последний символ, соответствующий заданному предикату, или null если такой символ не найден.
fun CharSequence.lastOrNull( predicate: (Char) -> Boolean ): Char?
lines
Разделяет эту последовательность символов на список строк, разделяемых любыми из следующих последовательностей символов: CRLF, LF или CR.
fun CharSequence.lines(): List<String>
lineSequence
Разделяет эту последовательность символов на последовательность строк, разделяемых любыми из следующих последовательностей символов: CRLF, LF или CR.
fun CharSequence.lineSequence(): Sequence<String>
lowercase
Преобразует этот символ в нижний регистр, используя правила сопоставления Unicode для указанного locale.
fun Char.lowercase(locale: Locale): String
Возвращает копию этой строки, преобразованной в нижний регистр, используя правила указанного locale.
fun String.lowercase(locale: Locale): String
Преобразует этот символ в нижний регистр, используя правила сопоставления Unicode для неизменяемого locale.
fun Char.lowercase(): String
Возвращает копию этой строки, преобразованной в нижний регистр, используя правила сопоставления Unicode для неизменяемого locale.
fun String.lowercase(): String
lowercaseChar
Преобразует этот символ в нижний регистр, используя правила сопоставления Unicode для неизменяемого locale.
fun Char.lowercaseChar(): Char
map
Возвращает список, содержащий результаты применения заданной transform функции к каждому символу в исходной последовательности символов.
fun <R> CharSequence.map(transform: (Char) -> R): List<R>
mapIndexed
Возвращает список, содержащий результаты применения заданной transform функции к каждому символу и его индексу в исходной последовательности символов.
fun <R> CharSequence.mapIndexed( transform: (index: Int, Char) -> R ): List<R>
mapIndexedNotNull
Возвращает список, содержащий только те результаты, которые не равны null, полученные при применении заданной функции transform к каждому символу и его индексу в исходной последовательности символов.
fun <R : Any> CharSequence.mapIndexedNotNull( transform: (index: Int, Char) -> R? ): List<R>
mapIndexedNotNullTo
Применяет заданную функцию transform к каждому символу и его индексу в исходной последовательности символов и добавляет только результаты, не равные null, в заданное значение destination.
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo( destination: C, transform: (index: Int, Char) -> R? ): C
mapIndexedTo
Применяет заданную функцию transform к каждому символу и его индексу в исходной последовательности символов и добавляет результаты в заданное значение destination.
fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo( destination: C, transform: (index: Int, Char) -> R ): C
mapNotNull
Возвращает список, содержащий только результаты, которые не равны null, полученные при применении заданной функции transform к каждому символу в исходной последовательности символов.
fun <R : Any> CharSequence.mapNotNull( transform: (Char) -> R? ): List<R>
mapNotNullTo
Применяет заданную функцию transform к каждому символу в исходной последовательности символов и добавляет только результаты, не равные null, в заданное значение destination.
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapNotNullTo( destination: C, transform: (Char) -> R? ): C
mapTo
Применяет заданную функцию transform к каждому символу исходной последовательности символов и добавляет результаты в заданное значение destination.
fun <R, C : MutableCollection<in R>> CharSequence.mapTo( destination: C, transform: (Char) -> R ): C
match
fun String.match(regex: String): Array<String>?
matches
Возвращает true , если эта последовательность символов соответствует заданному регулярному выражению.
infix fun CharSequence.matches(regex: Regex): Boolean
fun String.matches(regex: String): Boolean
max
Возвращает наибольший символ.
fun CharSequence.max(): Char
fun CharSequence.max(): Char?
maxBy
Возвращает первый символ, дающий наибольшее значение заданной функции.
fun <R : Comparable<R>> any_iterable<R>.maxBy( selector: (Char) -> R ): Char
maxByOrNull
Возвращает первый символ, дающий наибольшее значение заданной функции, или null , если символов нет.
fun <R : Comparable<R>> CharSequence.maxByOrNull( selector: (Char) -> R ): Char?
maxOf
Возвращает наибольшее значение среди всех значений, полученных с помощью функции selector, примененной к каждому символу в последовательности символов.
fun <R : Comparable<R>> any_iterable<R>.maxOf( selector: (Char) -> R ): R
maxOfOrNull
Возвращает наибольшее значение среди всех значений, полученных с помощью функции selector, примененной к каждому символу в последовательности символов, или null , если символов нет.
fun <R : Comparable<R>> any_iterable<R>.maxOfOrNull( selector: (Char) -> R ): R?
maxOfWith
Возвращает наибольшее значение в соответствии с заданным comparator среди всех значений, полученных с помощью функции selector, примененной к каждому символу в последовательности символов.
fun <R> CharSequence.maxOfWith( comparator: Comparator<in R>, selector: (Char) -> R ): R
maxOfWithOrNull
Возвращает наибольшее значение согласно предоставленному компаратору среди всех значений, полученных при применении функции выборщика к каждому символу в последовательности символов или null если символов нет.
fun <R> CharSequence.maxOfWithOrNull( comparator: Comparator<in R>, selector: (Char) -> R ): R?
maxOrNull
Возвращает наибольший символ или null если символов нет.
fun CharSequence.maxOrNull(): Char?
maxWith
Возвращает первый символ с наибольшим значением согласно предоставленному компаратору.
fun CharSequence.maxWith( comparator: Comparator<in Char> ): Char
fun CharSequence.maxWith( comparator: Comparator<in Char> ): Char?
maxWithOrNull
Возвращает первый символ с наибольшим значением согласно предоставленному компаратору или null если символов нет.
fun CharSequence.maxWithOrNull( comparator: Comparator<in Char> ): Char?
min
Возвращает наименьший символ.
fun CharSequence.min(): Char
fun CharSequence.min(): Char?
minBy
Возвращает первый символ, дающий наименьшее значение заданной функции.
fun <R : Comparable<R>> any_iterable<R>.minBy( selector: (Char) -> R ): Char
none
Возвращает true если в последовательности символов нет символов.
fun CharSequence.none(): Boolean
Возвращает true если ни один символ не соответствует заданному предикату.
fun CharSequence.none(predicate: (Char) -> Boolean): Boolean
offsetByCodePoints
Возвращает индекс в этой строке, смещённый от заданного индекса на codePointOffset кодовых точек.
fun String.offsetByCodePoints( index: Int, codePointOffset: Int ): Int
onEach
Выполняет заданное действие над каждым символом и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEach(action: (Char) -> Unit): S
onEachIndexed
Выполняет заданное действие над каждым символом, предоставляя последовательный индекс с символом, и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEachIndexed( action: (index: Int, Char) -> Unit ): S
orEmpty
Возвращает строку, если она не null, в противном случае — пустую строку.
fun String?.orEmpty(): String
padEnd
Возвращает последовательность символов с содержимым этой последовательности символов, заполненной по окончании до указанной длины указанным символом или пробелом.
fun CharSequence.padEnd( length: Int, padChar: Char = ' ' ): CharSequence
Заполняет строку до указанной длины в конце указанным символом или пробелом.
fun String.padEnd(length: Int, padChar: Char = ' '): String
reduceIndexed
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему накопленному значению и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): Char
reduceIndexedOrNull
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему накопленному значению и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexedOrNull( operation: (index: Int, acc: Char, Char) -> Char ): Char?
reduceOrNull
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему накопленному значению и каждому символу.
fun CharSequence.reduceOrNull( operation: (acc: Char, Char) -> Char ): Char?
reduceRight
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу и текущему накопленному значению.
fun CharSequence.reduceRight( operation: (Char, acc: Char) -> Char ): Char
reduceRightIndexed
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущему накопленному значению.
fun CharSequence.reduceRightIndexed( operation: (index: Int, Char, acc: Char) -> Char ): Char
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущему накопленному значению.
fun CharSequence.reduceRightIndexedOrNull( operation: (index: Int, Char, acc: Char) -> Char ): Char?
reduceRightOrNull
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу и текущему накопленному значению.
fun CharSequence.reduceRightOrNull( operation: (Char, acc: Char) -> Char ): Char?
regionMatches
Возвращает true, если указанный диапазон в этой последовательности символов равен указанному диапазону в другой последовательности символов.
fun CharSequence.regionMatches( thisOffset: Int, other: CharSequence, otherOffset: Int, length: Int, ignoreCase: Boolean = false ): Boolean
Возвращает true, если указанный диапазон в этой строке равен указанному диапазону в другой строке.
fun String.regionMatches( thisOffset: Int, other: String, otherOffset: Int, length: Int, ignoreCase: Boolean = false ): Boolean
removePrefix
Если эта последовательность символов начинается с указанного префикса, возвращает новую последовательность символов без префикса. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removePrefix( prefix: CharSequence ): CharSequence
Если эта строка начинается с указанного префикса, возвращает копию этой строки без префикса. В противном случае возвращает эту строку.
fun String.removePrefix(prefix: CharSequence): String
removeRange
Возвращает последовательность символов с содержимым этой последовательности символов, где ее часть в заданном диапазоне удалена.
fun CharSequence.removeRange( startIndex: Int, endIndex: Int ): CharSequence
Удаляет часть строки в заданном диапазоне.
fun String.removeRange( startIndex: Int, endIndex: Int ): String
Возвращает последовательность символов с содержимым этой последовательности символов, где ее часть в заданном диапазоне удалена.
fun CharSequence.removeRange(range: IntRange): CharSequence
Удаляет часть строки в заданном диапазоне.
fun String.removeRange(range: IntRange): String
removeSuffix
Если эта последовательность символов заканчивается указанным суффиксом, возвращает новую последовательность символов без суффикса. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSuffix( suffix: CharSequence ): CharSequence
Если эта строка заканчивается указанным суффиксом, возвращает копию этой строки без суффикса. В противном случае возвращает эту строку.
fun String.removeSuffix(suffix: CharSequence): String
removeSurrounding
Если данная последовательность символов начинается с указанного префикса и заканчивается указанным суффиксом, возвращает новую последовательность символов, из которой удалены указанный префикс и суффикс. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSurrounding( prefix: CharSequence, suffix: CharSequence ): CharSequence
Удаляет из строки заданный префикс и суффикс, только если она начинается с префикса и заканчивается суффиксом. В противном случае возвращает эту строку без изменений.
fun String.removeSurrounding( prefix: CharSequence, suffix: CharSequence ): String
Если данная последовательность символов начинается и заканчивается указанным разделителем, возвращает новую последовательность символов, из которой удалён указанный разделитель с начала и конца. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSurrounding( delimiter: CharSequence ): CharSequence
Удаляет указанную строку-разделитель с начала и конца этой строки, только если она начинается и заканчивается разделителем. В противном случае возвращает эту строку без изменений.
fun String.removeSurrounding(delimiter: CharSequence): String
repeat
Возвращает строку, содержащую эту последовательность символов, повторённую n раз.
fun CharSequence.repeat(n: Int): String
replace
Возвращает новую строку, полученную путём замены каждой подстроки в этой последовательности символов, соответствующей заданному регулярному выражению, указанным замещающим значением.
fun CharSequence.replace( regex: Regex, replacement: String ): String
Возвращает новую строку, полученную путём замены каждой подстроки в этой последовательности символов, соответствующей заданному регулярному выражению, результатом заданной функции преобразования, которая принимает MatchResult и возвращает строку, используемую в качестве замены для этого совпадения.
fun CharSequence.replace( regex: Regex, transform: (MatchResult) -> CharSequence ): String
Возвращает новую строку со всеми вхождениями старого символа заменёнными на новый символ.
fun String.replace( oldChar: Char, newChar: Char, ignoreCase: Boolean = false ): String
Возвращает новую строку, полученную путём замены всех вхождений подстроки старого значения в этой строке на указанную строку нового значения.
fun String.replace( oldValue: String, newValue: String, ignoreCase: Boolean = false ): String
replaceAfter
Заменяет часть строки после первого вхождения заданного разделителя на строку-замену replacement. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равную исходной строке.
fun String.replaceAfter( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceAfter( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
replaceAfterLast
Заменяет часть строки после последнего вхождения заданного разделителя на строку-замену replacement. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равную исходной строке.
fun String.replaceAfterLast( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceAfterLast( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
replaceBefore
Заменяет часть строки перед первым вхождением заданного разделителя на строку-замену replacement. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равную исходной строке.
fun String.replaceBefore( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceBefore( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
replaceBeforeLast
Заменяет часть строки перед последним вхождением заданного разделителя на строку-замену replacement. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равную исходной строке.
fun String.replaceBeforeLast( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceBeforeLast( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
replaceFirst
Заменяет первое вхождение заданного регулярного выражения regex в этой последовательности символов на указанное значение replacement.
fun CharSequence.replaceFirst( regex: Regex, replacement: String ): String
replaceFirstChar
Возвращает копию этой строки, в которой первый символ заменён результатом указанной transform, или исходную строку, если она пустая.
fun String.replaceFirstChar( transform: (Char) -> Char ): String
fun String.replaceFirstChar( transform: (Char) -> CharSequence ): String
replaceIndent
Определяет общий минимальный отступ, как это делает trimIndent, и заменяет его на указанный newIndent.
fun String.replaceIndent(newIndent: String = ""): String
replaceIndentByMargin
Определяет отступ по marginPrefix, как это делает trimMargin, и заменяет его на newIndent.
fun String.replaceIndentByMargin( newIndent: String = "", marginPrefix: String = "|" ): String
replaceRange
Возвращает последовательность символов с содержимым этой последовательности символов, где её часть в заданном диапазоне заменяется на последовательность символов replacement.
fun CharSequence.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): CharSequence
Заменяет часть строки в заданном диапазоне на последовательность символов replacement.
fun String.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): String
Возвращает последовательность символов с содержимым этой последовательности символов, где её часть в заданном range заменяется на последовательность символов replacement.
fun CharSequence.replaceRange( range: IntRange, replacement: CharSequence ): CharSequence
Заменяет часть строки в заданном range на строку replacement.
fun String.replaceRange( range: IntRange, replacement: CharSequence ): String
reversed
Возвращает последовательность символов с символами в обратном порядке.
fun CharSequence.reversed(): CharSequence
Возвращает строку с символами в обратном порядке.
fun String.reversed(): String
runningFold
runningFoldIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путём применения operation слева направо к каждому символу, его индексу в исходной последовательности символов и текущему значению накопителя, начинающемуся со значения initial.
fun <R> CharSequence.runningFoldIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): List<R>
runningReduce
Возвращает список, содержащий последовательные значения накопления, полученные путём применения operation слева направо к каждому символу и текущему значению накопителя, начинающемуся с первого символа этой последовательности символов.
fun CharSequence.runningReduce( operation: (acc: Char, Char) -> Char ): List<Char>
runningReduceIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путём применения operation слева направо к каждому символу, его индексу в исходной последовательности символов и текущему значению накопителя, начинающемуся с первого символа этой последовательности символов.
fun CharSequence.runningReduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): List<Char>
scan
scanIndexed
Возвращает список, содержащий последовательные накопительные значения, полученные путём применения operation слева направо к каждому символу, его индексу в исходной последовательности символов и текущему накопительному значению, начинающемуся со значения initial.
fun <R> CharSequence.scanIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): List<R>
set
setCharAt
fun StringBuilder.setCharAt(index: Int, value: Char)
setRange
Заменяет символы в указанном диапазоне этого строкового билдера символами в указанной строке value и возвращает этот экземпляр.
fun StringBuilder.setRange( startIndex: Int, endIndex: Int, value: String ): StringBuilder
single
Возвращает единственный символ или выводит исключение, если последовательность символов пуста или содержит более одного символа.
fun CharSequence.single(): Char
Возвращает единственный символ, соответствующий заданному предикату, или выводит исключение, если соответствующего символа нет или их более одного.
fun CharSequence.single(predicate: (Char) -> Boolean): Char
singleOrNull
Возвращает единственный символ или null если последовательность символов пуста или содержит более одного символа.
fun CharSequence.singleOrNull(): Char?
Возвращает единственный символ, соответствующий заданному предикату, или null если символ не найден или найдено более одного символа.
fun CharSequence.singleOrNull( predicate: (Char) -> Boolean ): Char?
slice
Возвращает последовательность символов, содержащую символы из исходной последовательности символов в указанном диапазоне индексов.
fun CharSequence.slice(indices: IntRange): CharSequence
Возвращает строку, содержащую символы из исходной строки в указанном диапазоне индексов.
fun String.slice(indices: IntRange): String
Возвращает последовательность символов, содержащую символы из исходной последовательности символов по указанным индексам.
fun CharSequence.slice(indices: Iterable<Int>): CharSequence
Возвращает строку, содержащую символы из исходной строки по указанным индексам.
fun String.slice(indices: Iterable<Int>): String
split
Разделяет эту последовательность символов на список строк вокруг вхождений указанных разделителей.
fun CharSequence.split( vararg delimiters: String, ignoreCase: Boolean = false, limit: Int = 0 ): List<String>
fun CharSequence.split( vararg delimiters: Char, ignoreCase: Boolean = false, limit: Int = 0 ): List<String>
Разделяет эту последовательность символов на список строк вокруг совпадений с заданным регулярным выражением.
fun CharSequence.split( regex: Regex, limit: Int = 0 ): List<String>
Разделяет эту последовательность символов вокруг совпадений с заданным регулярным выражением.
fun CharSequence.split( regex: Pattern, limit: Int = 0 ): List<String>
splitToSequence
Разделяет эту последовательность символов на последовательность строк вокруг вхождений указанных разделителей.
fun CharSequence.splitToSequence( vararg delimiters: String, ignoreCase: Boolean = false, limit: Int = 0 ): Sequence<String>
fun CharSequence.splitToSequence( vararg delimiters: Char, ignoreCase: Boolean = false, limit: Int = 0 ): Sequence<String>
Разделяет эту последовательность символов на последовательность строк вокруг совпадений с заданным регулярным выражением.
fun CharSequence.splitToSequence( regex: Regex, limit: Int = 0 ): Sequence<String>
startsWith
Возвращает true если эта последовательность символов начинается с указанного символа.
fun CharSequence.startsWith( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта последовательность символов начинается с указанного префикса.
fun CharSequence.startsWith( prefix: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true если подстрока этой последовательности символов, начинающаяся с указанного смещения startIndex, начинается с указанного префикса.
fun CharSequence.startsWith( prefix: CharSequence, startIndex: Int, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта строка начинается с указанного префикса.
fun String.startsWith( prefix: String, ignoreCase: Boolean = false ): Boolean
Возвращает true если подстрока этой строки, начинающаяся с указанного смещения startIndex, начинается с указанного префикса.
fun String.startsWith( prefix: String, startIndex: Int, ignoreCase: Boolean = false ): Boolean
String
Преобразует данные из части указанного массива байтов в символы с использованием указанного набора символов и возвращает результат преобразования в виде строки.
fun String( bytes: ByteArray, offset: Int, length: Int, charset: Charset ): String
Преобразует данные из указанного массива байтов в символы с использованием указанного набора символов и возвращает результат преобразования в виде строки.
fun String(bytes: ByteArray, charset: Charset): String
Преобразует данные из части указанного массива байтов в символы с использованием набора символов UTF-8 и возвращает результат преобразования в виде строки.
fun String( bytes: ByteArray, offset: Int, length: Int ): String
Преобразует данные из указанного массива байтов в символы с использованием набора символов UTF-8 и возвращает результат преобразования в виде строки.
fun String(bytes: ByteArray): String
Преобразует коды символов из части указанного массива кодов Unicode в строку.
fun String( codePoints: IntArray, offset: Int, length: Int ): String
Преобразует содержимое указанного StringBuffer в строку.
fun String(stringBuffer: StringBuffer): String
Преобразует содержимое указанного StringBuilder в строку.
fun String(stringBuilder: StringBuilder): String
Преобразует символы в указанном массиве в строку.
fun String(chars: CharArray): String
fun String(chars: CharArray): String
Преобразует символы из части указанного массива в строку.
fun String( chars: CharArray, offset: Int, length: Int ): String
fun String( chars: CharArray, offset: Int, length: Int ): String
subSequence
Возвращает подпоследовательность этой последовательности символов, заданной заданным диапазоном индексов.
fun CharSequence.subSequence(range: IntRange): CharSequence
Возвращает подпоследовательность этой последовательности символов.
fun String.subSequence(start: Int, end: Int): CharSequence
substring
Возвращает подстроку, заданную заданным диапазоном индексов.
fun String.substring(range: IntRange): String
Возвращает подстроку символов из диапазона этой последовательности символов, начиная с startIndex и заканчивая значением, предшествующим endIndex.
fun CharSequence.substring( startIndex: Int, endIndex: Int = length ): String
Возвращает подстроку символов в указанном диапазоне этой последовательности символов.
fun CharSequence.substring(range: IntRange): String
Возвращает подстроку этой строки, которая начинается с указанного startIndex и продолжается до конца строки.
fun String.substring(startIndex: Int): String
Возвращает подстроку этой строки, начинающуюся с startIndex и заканчивающуюся непосредственно перед endIndex.
fun String.substring(startIndex: Int, endIndex: Int): String
substringAfter
Возвращает подстроку после первого вхождения разделителя. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равное исходной строке.
fun String.substringAfter( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringAfter( delimiter: String, missingDelimiterValue: String = this ): String
substringAfterLast
Возвращает подстроку после последнего вхождения разделителя. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равное исходной строке.
fun String.substringAfterLast( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringAfterLast( delimiter: String, missingDelimiterValue: String = this ): String
substringBefore
Возвращает подстроку, расположенную перед первой встреченной строкой delimiter. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равное исходной строке.
fun String.substringBefore( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringBefore( delimiter: String, missingDelimiterValue: String = this ): String
substringBeforeLast
Возвращает подстроку, расположенную перед последним вхождением delimiter. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равное исходной строке.
fun String.substringBeforeLast( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringBeforeLast( delimiter: String, missingDelimiterValue: String = this ): String
sumBy
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun CharSequence.sumBy(selector: (Char) -> Int): Int
sumByDouble
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun CharSequence.sumByDouble( selector: (Char) -> Double ): Double
sumOf
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun CharSequence.sumOf(selector: (Char) -> Double): Double
fun CharSequence.sumOf(selector: (Char) -> Int): Int
fun CharSequence.sumOf(selector: (Char) -> Long): Long
fun CharSequence.sumOf(selector: (Char) -> UInt): UInt
fun CharSequence.sumOf(selector: (Char) -> ULong): ULong
fun CharSequence.sumOf( selector: (Char) -> BigDecimal ): BigDecimal
fun CharSequence.sumOf( selector: (Char) -> BigInteger ): BigInteger
take
Возвращает подпоследовательность этой последовательности символов, содержащую первые n символов из этой последовательности символов или всю последовательность, если она короче.
fun CharSequence.take(n: Int): CharSequence
Возвращает строку, содержащую первые n символов из этой строки или всю строку, если она короче.
fun String.take(n: Int): String
takeLast
Возвращает подпоследовательность этой последовательности символов, содержащую последние n символов из этой последовательности символов или всю последовательность, если она короче.
fun CharSequence.takeLast(n: Int): CharSequence
Возвращает строку, содержащую последние n символов из этой строки или всю строку, если она короче.
fun String.takeLast(n: Int): String
takeLastWhile
Возвращает подпоследовательность этой последовательности символов, содержащую последние символы, удовлетворяющие заданному предикату.
fun CharSequence.takeLastWhile( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, содержащую последние символы, удовлетворяющие заданному предикату.
fun String.takeLastWhile( predicate: (Char) -> Boolean ): String
takeWhile
Возвращает подпоследовательность этой последовательности символов, содержащую первые символы, удовлетворяющие заданному предикату.
fun CharSequence.takeWhile( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, содержащую первые символы, удовлетворяющие заданному предикату.
fun String.takeWhile(predicate: (Char) -> Boolean): String
titlecase
Преобразует этот символ в заглавную букву, используя правила сопоставления Unicode для неизменяемого языка.
fun Char.titlecase(): String
Преобразует этот символ в заглавную букву, используя правила сопоставления Unicode для указанного locale.
fun Char.titlecase(locale: Locale): String
titlecaseChar
Преобразует этот символ в заглавную букву, используя правила сопоставления Unicode для неизменяемого языка.
fun Char.titlecaseChar(): Char
toBigDecimal
Парсит строку как число java.math.BigDecimal и возвращает результат.
fun String.toBigDecimal(): BigDecimal
fun String.toBigDecimal(mathContext: MathContext): BigDecimal
toBigDecimalOrNull
Парсит строку как число java.math.BigDecimal и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toBigDecimalOrNull(): BigDecimal?
fun String.toBigDecimalOrNull( mathContext: MathContext ): BigDecimal?
toBigInteger
Парсит строку как число java.math.BigInteger и возвращает результат.
fun String.toBigInteger(): BigInteger
fun String.toBigInteger(radix: Int): BigInteger
toBigIntegerOrNull
Парсит строку как число java.math.BigInteger и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toBigIntegerOrNull(): BigInteger?
fun String.toBigIntegerOrNull(radix: Int): BigInteger?
toBoolean
Возвращает true если эта строка не null и ее содержимое равно слову "true", игнорируя регистр, и false в противном случае.
fun String?.toBoolean(): Boolean
toBooleanStrict
Возвращает true если содержимое этой строки равно слову "true", false если оно равно "false", и выбросит исключение в противном случае.
fun String.toBooleanStrict(): Boolean
toBooleanStrictOrNull
Возвращает true если содержимое этой строки равно слову "true", false если оно равно "false", и null в противном случае.
fun String.toBooleanStrictOrNull(): Boolean?
toByte
Парсит строку как целое число со знаком Byte и возвращает результат.
fun String.toByte(): Byte
fun String.toByte(radix: Int): Byte
toByteArray
Кодирует содержимое этой строки с помощью указанного набора символов и возвращает полученный массив байтов.
fun String.toByteArray( charset: Charset = Charsets.UTF_8 ): ByteArray
toByteOrNull
Парсит строку как целое число со знаком Byte и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toByteOrNull(): Byte?
fun String.toByteOrNull(radix: Int): Byte?
toCharArray
Копирует символы из этой строки в массив символов destination и возвращает этот массив.
fun String.toCharArray( destination: CharArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = length ): CharArray
Возвращает CharArray, содержащий символы этой строки.
fun String.toCharArray(): CharArray
Возвращает CharArray, содержащий символы этой строки или ее подстроки.
fun String.toCharArray( startIndex: Int = 0, endIndex: Int = this.length ): CharArray
Копирует символы из этого билдера строк в массив символов destination.
fun StringBuilder.toCharArray( destination: CharArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = this.length)
toCollection
Добавляет все символы в заданную коллекцию destination.
fun <C : MutableCollection<in Char>> CharSequence.toCollection( destination: C ): C
toDouble
Парсит строку как число Double и возвращает результат.
fun String.toDouble(): Double
toDoubleOrNull
Парсит строку как число Double и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toDoubleOrNull(): Double?
toFloat
Парсит строку как число Float и возвращает результат.
fun String.toFloat(): Float
toFloatOrNull
Парсит строку как число Float и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toFloatOrNull(): Float?
toHashSet
Возвращает новый HashSet всех символов.
fun CharSequence.toHashSet(): HashSet<Char>
toHexString
Форматирует байты в этом массиве с использованием указанного формата.
fun ByteArray.toHexString( format: HexFormat = HexFormat.Default ): String
fun UByteArray.toHexString( format: HexFormat = HexFormat.Default ): String
Форматирует байты в этом массиве с использованием указанного HexFormat.
fun ByteArray.toHexString( startIndex: Int = 0, endIndex: Int = size, format: HexFormat = HexFormat.Default ): String
fun UByteArray.toHexString( startIndex: Int = 0, endIndex: Int = size, format: HexFormat = HexFormat.Default ): String
Форматирует это Byte значение с использованием указанного формата.
fun Byte.toHexString( format: HexFormat = HexFormat.Default ): String
Форматирует это Short значение с использованием указанного формата.
fun Short.toHexString( format: HexFormat = HexFormat.Default ): String
Форматирует это Int значение с использованием указанного формата.
fun Int.toHexString( format: HexFormat = HexFormat.Default ): String
toRegex
Преобразует строку в регулярное выражение Regex с опциями по умолчанию.
fun String.toRegex(): Regex
toSet
Возвращает множество всех символов.
fun CharSequence.toSet(): Set<Char>
toShort
Парсит строку как число Short и возвращает результат.
fun String.toShort(): Short
fun String.toShort(radix: Int): Short
toShortOrNull
Парсит строку как число Short и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toShortOrNull(): Short?
fun String.toShortOrNull(radix: Int): Short?
toSortedSet
Возвращает новое SortedSet всех символов.
fun CharSequence.toSortedSet(): SortedSet<Char>
toString
Возвращает строковое представление значения Byte в указанной системе счисления.
fun UByte.toString(radix: Int): String
fun Byte.toString(radix: Int): String
Возвращает строковое представление значения Short в указанной системе счисления.
fun UShort.toString(radix: Int): String
fun Short.toString(radix: Int): String
Возвращает строковое представление значения Int в указанной системе счисления.
fun UInt.toString(radix: Int): String
fun Int.toString(radix: Int): String
Возвращает строковое представление значения Long в указанной системе счисления.
fun ULong.toString(radix: Int): String
fun Long.toString(radix: Int): String
toTitleCase
Преобразует этот символ в заглавную букву, используя правила сопоставления Юникода для инвариантного языка.
fun Char.toTitleCase(): Char
toUByte
Парсит строку как число UByte со знаком и возвращает результат.
fun String.toUByte(): UByte
fun String.toUByte(radix: Int): UByte
toUByteOrNull
Парсит строку как число UByte и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toUByteOrNull(): UByte?
fun String.toUByteOrNull(radix: Int): UByte?
toUInt
Парсит строку как число UInt и возвращает результат.
fun String.toUInt(): UInt
fun String.toUInt(radix: Int): UInt
toUIntOrNull
Парсит строку как число UInt и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toUIntOrNull(): UInt?
fun String.toUIntOrNull(radix: Int): UInt?
toULong
Парсит строку как число ULong и возвращает результат.
fun String.toULong(): ULong
fun String.toULong(radix: Int): ULong
toULongOrNull
Парсит строку как число ULong и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toULongOrNull(): ULong?
fun String.toULongOrNull(radix: Int): ULong?
В верхнем регистре
Возвращает копию этой строки, преобразованную в верхний регистр по правилам указанного языка.
fun String.toUpperCase(locale: Locale): String
Преобразует этот символ в верхний регистр, используя правила сопоставления Unicode инвариантного языка.
fun Char.toUpperCase(): Char
Возвращает копию этой строки, преобразованной в верхний регистр по правилам языка по умолчанию.
fun String.toUpperCase(): String
Преобразовать в UShort
Парсит строку как число UShort и возвращает результат.
fun String.toUShort(): UShort
fun String.toUShort(radix: Int): UShort
Преобразовать в UShort или null
Парсит строку как число UShort и возвращает результат или null, если строка не является допустимым представлением числа.
fun String.toUShortOrNull(): UShort?
fun String.toUShortOrNull(radix: Int): UShort?
Убрать пробелы
Возвращает подпоследовательность этой последовательности символов, убрав ведущие и хвостовые символы, соответствующие предикату предикат.
fun CharSequence.trim( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, убрав ведущие и хвостовые символы, соответствующие предикату предикат.
fun String.trim(predicate: (Char) -> Boolean): String
Возвращает подпоследовательность этой последовательности символов, удалив ведущие и хвостовые символы из массива символов.
fun CharSequence.trim(vararg chars: Char): CharSequence
Возвращает строку, удалив ведущие и хвостовые символы из массива символов.
fun String.trim(vararg chars: Char): String
Возвращает подпоследовательность этой последовательности символов, убрав ведущие и хвостовые пробелы.
fun CharSequence.trim(): CharSequence
Возвращает строку, убрав ведущие и хвостовые пробелы.
fun String.trim(): String
Убрать хвостовые пробелы
Возвращает подпоследовательность этой последовательности символов, убрав хвостовые символы, соответствующие предикату предикат.
fun CharSequence.trimEnd( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, убрав хвостовые символы, соответствующие предикату предикат.
fun String.trimEnd(predicate: (Char) -> Boolean): String
Возвращает подпоследовательность этой последовательности символов, удалив хвостовые символы из массива символов.
fun CharSequence.trimEnd(vararg chars: Char): CharSequence
Возвращает строку, удалив хвостовые символы из массива символов.
fun String.trimEnd(vararg chars: Char): String
Возвращает подпоследовательность этой последовательности символов, убрав хвостовые пробелы.
fun CharSequence.trimEnd(): CharSequence
Возвращает строку, убрав хвостовые пробелы.
fun String.trimEnd(): String
Убрать отступы
Обнаруживает общий минимальный отступ всех строк ввода, удаляет его из каждой строки, а также удаляет первую и последнюю строки, если они пустые (обратите внимание на разницу между пустой и пустой).
fun String.trimIndent(): String
Убрать отступ
Удаляет ведущие пробельные символы, за которыми следует marginPrefix, из каждой строки исходной строки и удаляет первую и последнюю строки, если они пустые (обратите внимание на разницу между пустой и пустой).
fun String.trimMargin(marginPrefix: String = "|"): String
trimStart
Возвращает подпоследовательность этой последовательности символов, из которой удалены ведущие символы, соответствующие заданному предикату.
fun CharSequence.trimStart( predicate: (Char) -> Boolean ): CharSequence
Возвращает строку, из которой удалены ведущие символы, соответствующие заданному предикату.
fun String.trimStart(predicate: (Char) -> Boolean): String
Возвращает подпоследовательность этой последовательности символов, из которой удалены ведущие символы из массива chars.
fun CharSequence.trimStart(vararg chars: Char): CharSequence
Возвращает строку, из которой удалены ведущие символы из массива chars.
fun String.trimStart(vararg chars: Char): String
Возвращает подпоследовательность этой последовательности символов, из которой удалены ведущие пробелы.
fun CharSequence.trimStart(): CharSequence
Возвращает строку, из которой удалены ведущие пробелы.
fun String.trimStart(): String
uppercase
Преобразует этот символ в верхний регистр, используя правила сопоставления Юникода указанного локального набора.
fun Char.uppercase(locale: Locale): String
Возвращает копию этой строки, преобразованной в верхний регистр, используя правила указанного локального набора.
fun String.uppercase(locale: Locale): String
Преобразует этот символ в верхний регистр, используя правила сопоставления Юникода неизменного локального набора.
fun Char.uppercase(): String
Возвращает копию этой строки, преобразованной в верхний регистр, используя правила сопоставления Юникода неизменного локального набора.
fun String.uppercase(): String
uppercaseChar
Преобразует этот символ в верхний регистр, используя правила сопоставления Юникода неизменного локального набора.
fun Char.uppercaseChar(): Char
windowed
Возвращает список снимков окна заданного размера, скользящего по этой последовательности символов с заданным шагом, где каждый снимок — строка.
fun CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false ): List<String>
Возвращает список результатов применения заданной функции преобразования к каждой последовательности символов, представляющей представление над окном заданного размера, скользящего по этой последовательности символов с заданным шагом.
fun <R> CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (CharSequence) -> R ): List<R>
windowedSequence
Возвращает последовательность снимков окна заданного размера, скользящего по этой последовательности символов с заданным шагом, где каждый снимок — строка.
fun CharSequence.windowedSequence( size: Int, step: Int = 1, partialWindows: Boolean = false ): Sequence<String>
Возвращает последовательность результатов применения заданной функции преобразования к каждой последовательности символов, представляющей представление над окном заданного размера, скользящего по этой последовательности символов с заданным шагом.
fun <R> CharSequence.windowedSequence( size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (CharSequence) -> R ): Sequence<R>
withIndex
Возвращает ленивый Iterable, который оборачивает каждый символ исходной последовательности символов в IndexedValue, содержащий индекс этого символа и сам символ.
fun CharSequence.withIndex(): Iterable<IndexedValue<Char>>
zip
Возвращает список пар, составленных из символов this и последовательностей символов other с одинаковым индексом. Возвращаемый список имеет длину самой короткой последовательности символов.
infix fun CharSequence.zip( other: CharSequence ): List<Pair<Char, Char>>
Возвращает список значений, составленных из символов this и последовательностей символов other с одинаковым индексом с использованием предоставленной функции преобразования, применённой к каждой паре символов. Возвращаемый список имеет длину самой короткой последовательности символов.
fun <V> CharSequence.zip( other: CharSequence, transform: (a: Char, b: Char) -> V ): List<V>
zipWithNext
Возвращает список пар из каждой двух соседних символов в этой последовательности символов.
fun CharSequence.zipWithNext(): List<Pair<Char, Char>>
Возвращает список, содержащий результаты применения заданной функции transform к каждой паре двух соседних символов в этой последовательности символов.
fun <R> CharSequence.zipWithNext( transform: (a: Char, b: Char) -> R ): List<R>
Свойства объекта-компаньона
CASE_INSENSITIVE_ORDER
Компаратор, который сортирует строки, игнорируя регистр символов.
val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String>
Функции объекта-компаньона
format
Использует предоставленную format в качестве строки форматирования и возвращает строку, полученную путём подстановки указанных аргументов, используя стандартный локали.
fun String.Companion.format( format: String, vararg args: Any? ): String
Использует предоставленную format в качестве строки форматирования и возвращает строку, полученную путём подстановки указанных аргументов, используя указанную локаль. Если locale null , то никакая локализация не применяется.
fun String.Companion.format( locale: Locale?, format: String, vararg args: Any? ): String
isSupplementaryCodePoint
Проверяет, является ли указанный код символа дополнительным кодом символа или нет.
fun Char.Companion.isSupplementaryCodePoint( codepoint: Int ): Boolean
isSurrogatePair
Проверяет, являются ли указанные символы high и low соответственно Char.isHighSurrogate и Char.isLowSurrogate.
fun Char.Companion.isSurrogatePair( high: Char, low: Char ): Boolean
toChars
Преобразует указанный код символа в массив символов. Если код символа не дополнительный, метод вернёт массив с одним элементом, в противном случае он вернёт массив A с высоким замещающим символом в A0 и низким замещающим символом в A1.
fun Char.Companion.toChars(codePoint: Int): CharArray
toCodePoint
Преобразует пару замещающих символов в код символа Unicode. Не проверяет, являются ли символы корректной парой замещающих символов.
fun Char.Companion.toCodePoint(high: Char, low: Char): Int
© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index.html