Kotlin Academy · Lekcja

Surowe ciągi znaków i potrójne cudzysłowy

Użyj ciągów znaków ujętych w potrójny cudzysłów dla tekstu wielowierszowego i surowej treści bez znaków ucieczki.

Surowe ciągi znaków i potrójne cudzysłowy to bezpłatna lekcja Kotlin Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Kotlin Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Kotlin Academy zawiera 4 lekcji w sumie.

Czym jest surowy ciąg znaków?

Surowy ciąg znaków używa potrójnych cudzysłowów """...""" i zachowuje tekst dokładnie w postaci, w jakiej został zapisany — bez sekwencji ucieczki i znaków specjalnych.

Podstawowy surowy ciąg znaków

Ciągi znaków ujęte w potrójne cudzysłowy mogą obejmować wiele wierszy bez jawnego używania \n.

fun main() {
    val text = """
        Line 1
        Line 2
        Line 3
    """
    println(text)
}

Sekwencje ucieczki nie są potrzebne

W surowym ciągu znaków ukośniki odwrotne i cudzysłowy występują dosłownie. To idealne rozwiązanie dla wzorców wyrażeń regularnych i ścieżek systemu Windows.

fun main() {
    val regex = """\d+\.\d+"""
    val winPath = """C:\Users\Alice\Documents"""
    println(regex)
    println(winPath)
}

Wielowierszowy JSON

Surowe ciągi znaków świetnie nadają się do osadzania literałów JSON, SQL lub HTML — bez zbędnego zamieszania z sekwencjami ucieczki.

fun main() {
    val json = """
        {
            "name": "Kotlin",
            "year": 2011
        }
    """.trimIndent()
    println(json)
}

trimIndent()

trimIndent() usuwa wspólne początkowe białe znaki z każdego wiersza, dzięki czemu można estetycznie wciąć kod źródłowy, zachowując przy tym przejrzyste dane wyjściowe.

fun main() {
    val poem = """
        Roses are red
        Violets are blue
        Kotlin is sweet
        And so are you
    """.trimIndent()
    println(poem)
}

trimMargin()

trimMargin() usuwa początkowy znacznik marginesu (domyślnie |). Używaj go, gdy jawne wyrównanie jest lepsze niż dopasowywanie wcięć.

fun main() {
    val msg = """
        |Hello,
        |    World!
        |Goodbye.
    """.trimMargin()
    println(msg)
}

Własny znak marginesu

Do funkcji trimMargin można przekazać dowolny znak, aby dostosować znacznik.

fun main() {
    val text = """
        >Line A
        >Line B
    """.trimMargin(">")
    println(text)
}

Szablony ciągów znaków nadal działają

Surowe ciągi znaków nadal interpolują $variable i ${expression}. Wyłączone są tylko sekwencje ucieczki.

fun main() {
    val name = "Kotlin"
    val version = 1.9
    val report = """
        Name: $name
        Version: $version
        Build: ${if (version >= 1.0) "stable" else "beta"}
    """.trimIndent()
    println(report)
}

Umieszczanie cudzysłowów dosłownych

Cudzysłowy wewnątrz ciągów znaków ujętych w potrójne cudzysłowy nie wymagają znaków ucieczki — można zapisać je bez zmian.

fun main() {
    val quote = """She said, "Hello!" and smiled."""
    println(quote)
}

Dosłowne umieszczanie znaku dolara

Aby umieścić dosłowny znak $ w surowym ciągu znaków, należy użyć sztuczki z szablonem: ${'$'}.

fun main() {
    val price = """Cost is ${'$'}100"""
    println(price) // Cost is $100
}

Praktyka: zapytanie SQL

Ciągi znaków ujęte w potrójne cudzysłowy pozwalają zachować czytelność długich zapytań SQL w kodzie źródłowym.

fun main() {
    val table = "users"
    val sql = """
        SELECT id, name, email
        FROM $table
        WHERE active = true
        ORDER BY name
    """.trimIndent()
    println(sql)
}

Szybkie sprawdzenie

Która funkcja usuwa wspólne początkowe białe znaki z każdego wiersza surowego ciągu znaków?

Podsumowanie

Ciągi znaków ujęte w potrójne cudzysłowy zachowują tekst dosłownie (bez sekwencji ucieczki) i mogą obejmować wiele wierszy. Do uporządkowania wcięć należy użyć trimIndent() lub trimMargin(). Szablony nadal działają; dosłowny znak $ wymaga użycia ${'$'}.

Często zadawane pytania

Czy lekcja „Surowe ciągi znaków i potrójne cudzysłowy” jest bezpłatna?

Tak — pełny tekst „Surowe ciągi znaków i potrójne cudzysłowy” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Kotlin Academy, przejdź na CoddyKit PRO. Kurs Kotlin Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Surowe ciągi znaków i potrójne cudzysłowy”?

Użyj ciągów znaków ujętych w potrójny cudzysłów dla tekstu wielowierszowego i surowej treści bez znaków ucieczki. Ćwiczysz Kotlin Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Kotlin Academy?

Nie wymagamy żadnego doświadczenia. Kotlin Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Surowe ciągi znaków i potrójne cudzysłowy”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Kotlin Academy?

Tak. Każda lekcja Kotlin Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Podstawy napisów: literały, sekwencje ucieczki i długość
Szablony napisów: $variable i ${expression}
Surowe ciągi znaków i potrójne cudzysłowy
Najważniejsze funkcje String: trim, split, replace, contains

← Powrót do Kotlin Academy