Строки

Многострочные строки

Чтобы хранить текст, состоящий из нескольких строк, или содержащий кавычки, которые не нужно экранировать, используйте многострочную строку, заключенную в тройные кавычки (""" """):

val text = """
Hello,
Kotlin
"""

val quote = """Kotlin says, "Hi"."""

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

В следующем примере пробелы перед каждой строкой являются частью результирующей строки:

val text = """
    Hello,
    Kotlin
"""

Чтобы удалить общие начальные отступы, используйте функцию trimIndent(). Она определяет минимальный общий отступ непустых строк и удаляет его:

fun main() {
//sampleStart
    val text = """
        Hello,
        Kotlin
    """.trimIndent()
    
    println(text)
//sampleEnd
}

Чтобы точнее управлять удалением отступов, используйте функцию trimMargin(). Она удаляет все символы до префикса поля включительно в каждой строке:

fun main() {
//sampleStart
    val text = """
        |Hello,
        |Kotlin
    """.trimMargin()
    
    println(text)
//sampleEnd
}

По умолчанию функция trimMargin() использует символ вертикальной черты (|) в качестве префикса поля, но в качестве параметра можно передать другой символ. Например: trimMargin(">").

Nullable-значения в шаблонах строк

Если интерполируемое выражение или переменная принимает значение null, компилятор Kotlin вставляет текст null в результирующую строку. Чтобы заменить null другим значением, используйте оператор Элвиса (?:):

fun main(){
//sampleStart
    val text: String? = null
  
    println("Hello, $text")
    // Hello, null

    println("Hello, ${text ?: "Kotlin"}")
    // Hello, Kotlin
//sampleEnd
}

Интерполяция строк с несколькими знаками доллара

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

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

Например, если перед строковым литералом использовать $$, интерполяция начнется только при наличии двух идущих подряд знаков доллара:

val KClass<*>.jsonSchema : String
    get() = $$"""
    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "$id": "https://example.com/product.schema.json",
      "$dynamicAnchor": "meta",
      "title": "$${simpleName ?: qualifiedName ?: "unknown"}",
      "type": "object"
    }
    """

Получение длины строки

Чтобы получить количество символов в строке, используйте свойство length:

fun main (){
//sampleStart
    val language = "Kotlin"
    println(language.length)
    // 6
//sampleEnd
}

Доступ к символам

Получить доступ к отдельному символу в строке можно с помощью оператора индексирования ([]):

fun main (){
//sampleStart
    val language = "Kotlin"
    
    println(language[0])
    // K
    println(language[5])
    // n
//sampleEnd
}

Также можно перебрать символы строки:

fun main(){
//sampleStart
    for (char in "Kotlin") {
      println(char)
    }
//sampleEnd    
}

Извлечение частей строки

Чтобы извлечь части строки, используйте одну из следующих функций:

• substring() возвращает новую строку с выбранной частью исходного текста.

• subSequence() возвращает CharSequence с выбранной частью исходного текста.

Например:

fun main() {
//sampleStart    
    val text = "Kotlin"
    println(text.substring(1))
    // otlin
    println(text.substring(1, 5))
    // otli
    println(text.subSequence(1, 5))
    // otli
//sampleEnd
}

Поскольку тип String является неизменяемым, эти функции не изменяют исходную строку.

Сравнение строк

Проверить, совпадает ли содержимое двух строк, можно с помощью оператора ==:

fun main(){
//sampleStart
    println("kotlin" == "kotlin")
    // true
  
    println("kotlin" == "Kotlin")
    // false
//sampleEnd    
}

Также можно сравнить строки лексикографически (символ за символом) с помощью функции compareTo(). Она просматривает обе строки до первого различающегося набора символов и возвращает:

• 0, если строки равны.

• Значение меньше 0, если строка-получатель меньше аргумента.

• Значение больше 0, если строка-получатель больше аргумента.

fun main() {
//sampleStart    
    println("abc".compareTo("abd") < 0)
    // true
    
    println("abc".compareTo("ABC") > 0)
    // true
    
    // Pass true to ignore case differences
    println("abc".compareTo("ABC", ignoreCase = true) == 0)
    // true
//sampleEnd  
}

Работа с содержимым строки

Чтобы изменить содержимое строки, создайте ее измененную копию с помощью таких функций, как .trim(), .replace(), .uppercase() и .lowercase():

fun main() {
//sampleStart
    val text = "  Hello, Kotlin  "

    println(text.trim())
    // Hello, Kotlin

    println(text.replace("Kotlin", "world"))
    //   Hello, world  

    println(text.uppercase())
    //   HELLO, KOTLIN  

    println(text.lowercase())
    //   hello, kotlin  
//sampleEnd    
}

Также можно проверить содержимое строки с помощью функций contains(), startsWith() и endsWith():

fun main() { 
//sampleStart
    val domain = "kotlinlang.org"
    
    // Checks if the string contains "."
    println(domain.contains("."))
    // true
    
    // Checks if the string starts with "kotlin"
    println(domain.startsWith("kotlin"))
    // true
    
    // Checks if the string ends with ".org"
    println(domain.endsWith(".org"))
    // true
//sampleEnd
}

Разделение строк

Разделить строку на части по разделителю можно с помощью функции split():

fun main() { 
//sampleStart
    val numbers = "one, two, three"
    println(numbers.split(", "))
    // [one, two, three]
//sampleEnd
}

Чтобы разделить строку на отдельные строки, используйте функцию lines():

fun main() { 
//sampleStart
    val numbers = "one\ntwo\nthree"
    println(numbers.lines())
    // [one, two, three]
//sampleEnd
}

Создание и форматирование строк

При объединении строк с помощью оператора + Kotlin создает новый объект String для каждой операции. Однако такой подход может быть неэффективен в циклах или при объединении множества фрагментов. Чтобы избежать этих проблем, можно использовать функцию buildString() или StringBuilder. Они собирают все фрагменты в одном изменяемом буфере и в конце создают только одну строку.

Используйте функцию buildString(), если логика, определяющая, что нужно добавить, сложна. Например, если есть несколько условий, каждое из которых добавляет свой фрагмент. При использовании buildString() вам не нужно работать с буфером напрямую. Функция создает StringBuilder внутри, выполняет ваш блок и возвращает результирующую строку.

fun main() {
//sampleStart

    val hasErrors = true
    val hasWarnings = true
    val isComplete = false
    
    // buildString creates an empty buffer
    val status = buildString {
        // Appends "Errors found" to the buffer
        if (hasErrors) append("Errors found")
        if (hasWarnings) {
            // The buffer is not empty, appends "; "
            if (isNotEmpty()) append("; ")
            // Appends "Warnings found"
            append("Warnings found")
        }
        // isComplete = false, nothing to append
        if (isComplete) {
            if (isNotEmpty()) append("; ")
            append("Completed")
        }
        // The buffer is not empty, skips the fallback
        if (isEmpty()) append("OK")
    }
    
    println(status)
    // Errors found; Warnings found
//sampleEnd
}

Используйте StringBuilder, если буфер нужен вам как явное значение. Например, чтобы изменить существующий текст:

fun main() {
//sampleStart
    val text = "Hello, Kotlin"
    val builder = StringBuilder(text)

    builder.replace(7, 13, "world")
    println(builder.toString()) 
    // Hello, world
//sampleEnd
}

На JVM также можно отформатировать строку с помощью функции String.format():

val text = String.format("Hello, %s", "Kotlin")