문자열
String 타입은 문자(characters)의 시퀀스를 나타냅니다. 단어, 문장, 메시지 또는 구조화된 텍스트와 같은 텍스트 값에 사용할 수 있습니다.
String 타입은 불변(immutable)입니다. String 객체를 생성한 후에는 객체의 수명 동안 내용이 동일하게 유지됩니다. 문자열을 수정하는 것처럼 보이는 모든 연산은 실제로는 새로운 문자열을 생성합니다.
문자열 선언
String 리터럴을 선언하려면 값을 큰따옴표("")로 감쌉니다. String 타입을 명시적으로 지정하거나 Kotlin이 값으로부터 추론하도록 할 수 있습니다.
val name: String = "Kotlin"
val message = "Hello, world!" // Kotlin이 String으로 추론큰따옴표 문자열 리터럴은 \n 또는 \t와 같은 이스케이프 시퀀스(escape sequences)를 지원합니다.
val message = "Hello,\nworld!"
val quote = "Kotlin says, \"Hi\"."여러 줄 문자열
여러 줄로 구성된 텍스트를 저장하거나 이스케이프 처리하고 싶지 않은 따옴표가 포함된 텍스트를 저장하려면 삼중 따옴표(""" """)로 감싼 여러 줄 문자열(multiline string)을 사용합니다.
val text = """
Hello,
Kotlin
"""
val quote = """Kotlin says, "Hi"."""여러 줄 문자열은 이스케이프 시퀀스를 지원하지 않습니다. Kotlin은 이러한 문자를 일반 텍스트로 처리합니다.
여러 줄 문자열은 소스 코드에 작성된 대로 줄바꿈과 들여쓰기를 유지합니다. 이 동작은 런타임 값이 파일의 텍스트 레이아웃과 일치하기를 원할 때 유용합니다.
다음 예제에서 각 줄 앞의 공백은 결과 문자열의 일부가 됩니다.
val text = """
Hello,
Kotlin
"""공통된 앞부분 들여쓰기를 제거하려면 trimIndent() 함수를 사용합니다. 이 함수는 비어 있지 않은 줄의 공통 최소 들여쓰기를 감지하여 제거합니다.
fun main() {
val text = """
Hello,
Kotlin
""".trimIndent()
println(text)
}들여쓰기 제거를 더 명시적으로 제어하려면 trimMargin() 함수를 사용합니다. 이 함수는 각 줄의 여백 접두사(margin prefix)와 그 앞의 모든 내용을 제거합니다.
fun main() {
val text = """
|Hello,
|Kotlin
""".trimMargin()
println(text)
}기본적으로 trimMargin() 함수는 파이프 기호(|)를 여백 접두사로 사용하지만, 다른 문자를 매개변수로 전달할 수도 있습니다. 예를 들어 trimMargin(">")과 같이 사용할 수 있습니다.
trimIndent() 또는 trimMargin()과 같은 함수로 문자열을 처리할 때, 결과 문자열은 플랫폼에 관계없이 줄바꿈 기호로 개행 문자(\n)만 사용합니다.
문자열 템플릿
문자열 템플릿을 사용하면 String 리터럴 내부에 변수와 표현식을 직접 삽입할 수 있습니다. 이 과정을 _보간(interpolation)_이라고 합니다. 문자열 템플릿은 일반 문자열과 여러 줄 문자열 모두에서 사용할 수 있습니다.
문자열에 변수를 삽입하려면 $ 기호를 사용합니다.
fun main() {
val name = "Kotlin"
println("Hello, $name")
// Hello, Kotlin
}표현식을 문자열에 삽입하거나 변수를 다른 텍스트 바로 옆에 배치하려면 ${}를 사용합니다.
fun main() {
val text = "abc"
println("The length of $text is ${text.length}")
// The length of abc is 3
val language = "Kotlin"
println("${language}Lang")
// KotlinLang
}+ 연산자로 문자열을 결합할 수도 있습니다. 하지만 일반적으로 문자열 템플릿이 읽기 쉽고 관용적(idiomatic)입니다.
템플릿 표현식 내부에는 이스케이프 처리 없이 큰따옴표로 묶인 문자열을 포함할 수도 있습니다.
// 큰따옴표 문자열
val test = "${"test".uppercase()}"
// 여러 줄 문자열
val result = """
Result: ${"OK".lowercase()}
"""문자열 템플릿의 널 허용 값
보간된 표현식이나 변수가 null로 평가되면, Kotlin 컴파일러는 결과 문자열에 null이라는 텍스트를 삽입합니다. null을 다른 값으로 대체하려면 엘비스 연산자(Elvis operator) (?:)를 사용합니다.
fun main(){
val text: String? = null
println("Hello, $text")
// Hello, null
println("Hello, ${text ?: "Kotlin"}")
// Hello, Kotlin
}다중 달러 문자열 보간
일반 문자열 템플릿에서는 단일 달러 기호($)로 보간이 시작됩니다. 문자열에 리터럴 달러 기호를 포함해야 하는 경우 다중 달러 문자열 보간(multi-dollar string interpolation)을 사용합니다.
다중 달러 문자열 보간을 사용하면 보간을 트리거하는 데 필요한 연속된 달러 기호의 수를 지정할 수 있습니다. 그 수보다 적은 달러 기호는 일반 리터럴 문자로 취급됩니다.
예를 들어 문자열 리터럴 앞에 $$를 사용하면 연속된 두 개의 달러 기호로만 보간이 시작됩니다.
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"
}
"""단일 달러 문자열 보간을 사용하는 경우 다중 달러 문자열 보간은 코드에 영향을 주지 않습니다. 계속해서 단일 $를 사용할 수 있으며, 필요할 때 다중 달러 기호를 적용하면 됩니다.
기본 문자열 연산
Kotlin은 문자열 작업을 위한 다양한 연산을 제공합니다. 이 섹션에서는 가장 일반적으로 사용되는 몇 가지 연산을 소개합니다.
사용 가능한 모든 함수에 대한 자세한 내용은 API Reference를 참조하세요.
문자열 길이 가져오기
문자열의 문자 수를 가져오려면 length 프로퍼티를 사용합니다.
fun main (){
val language = "Kotlin"
println(language.length)
// 6
}문자에 접근하기
인덱싱 연산자([])를 사용하여 문자열의 개별 문자에 접근할 수 있습니다.
fun main (){
val language = "Kotlin"
println(language[0])
// K
println(language[5])
// n
}문자열 인덱스는 0부터 시작합니다. 유효한 범위를 벗어난 인덱스에 접근하려고 하면 Kotlin에서 예외가 발생합니다.
문자열의 문자를 순회할 수도 있습니다.
fun main(){
for (char in "Kotlin") {
println(char)
}
}문자열 일부 추출하기
문자열의 일부를 추출하려면 다음 함수 중 하나를 사용합니다.
substring(): 원본 텍스트의 선택된 부분을 포함하는 새 문자열을 반환합니다.subSequence(): 원본 텍스트의 선택된 부분을 포함하는CharSequence를 반환합니다.
예시:
fun main() {
val text = "Kotlin"
println(text.substring(1))
// otlin
println(text.substring(1, 5))
// otli
println(text.subSequence(1, 5))
// otli
}String 타입은 불변이므로 이러한 함수는 원본 문자열을 수정하지 않습니다.
문자열 비교
== 연산자를 사용하여 두 문자열의 내용이 같은지 확인할 수 있습니다.
fun main(){
println("kotlin" == "kotlin")
// true
println("kotlin" == "Kotlin")
// false
}compareTo() 함수를 사용하여 사전순(문자별)으로 문자열을 비교할 수도 있습니다. 이 함수는 서로 다른 첫 번째 문자 쌍을 찾을 때까지 두 문자열을 검색하고 다음을 반환합니다.
- 두 문자열이 같으면
0. - 수신 객체(receiver)가 인자보다 작으면
0보다 작은 값. - 수신 객체가 인자보다 크면
0보다 큰 값.
fun main() {
println("abc".compareTo("abd") < 0)
// true
println("abc".compareTo("ABC") > 0)
// true
// 대소문자 차이를 무시하려면 true를 전달
println("abc".compareTo("ABC", ignoreCase = true) == 0)
// true
}문자열 내용 다루기
문자열의 내용을 변경하려면 .trim(), .replace(), .uppercase(), .lowercase()와 같은 함수를 사용하여 수정된 복사본을 생성합니다.
fun main() {
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
}contains(), startsWith(), endsWith() 함수를 사용하여 문자열 내용을 검사할 수도 있습니다.
fun main() {
val domain = "kotlinlang.org"
// 문자열에 "."이 포함되어 있는지 확인
println(domain.contains("."))
// true
// 문자열이 "kotlin"으로 시작하는지 확인
println(domain.startsWith("kotlin"))
// true
// 문자열이 ".org"로 끝나는지 확인
println(domain.endsWith(".org"))
// true
}문자열 분할
split() 함수를 사용하여 구분 기호를 기준으로 문자열을 여러 부분으로 나눌 수 있습니다.
fun main() {
val numbers = "one, two, three"
println(numbers.split(", "))
// [one, two, three]
}문자열을 개별 줄로 분할하려면 lines() 함수를 사용합니다.
fun main() {
val numbers = "one\ntwo\nthree"
println(numbers.lines())
// [one, two, three]
}문자열 빌드 및 포맷팅
Kotlin의 대부분의 포맷팅 작업에는 문자열 템플릿을 사용하세요.
+ 연산자로 문자열을 연결할 때 Kotlin은 각 연산마다 새로운 String 객체를 생성합니다. 하지만 이러한 방식은 반복문 내부나 수많은 조각을 조합할 때는 비효율적일 수 있습니다. 이러한 문제를 방지하기 위해 buildString() 함수나 StringBuilder를 사용할 수 있습니다. 이들은 단일 가변 버퍼에 모든 조각을 모은 다음 마지막에 하나의 문자열만 생성합니다.
추가할 내용을 결정하는 로직이 복잡할 때는 buildString() 함수를 사용하세요. 예를 들어 서로 다른 조각을 추가하는 여러 조건문이 있는 경우가 해당합니다. buildString()을 사용하면 버퍼를 직접 다룰 필요가 없습니다. 이 함수는 내부적으로 StringBuilder를 생성하고, 코드 블록을 실행한 후 결과 문자열을 반환합니다.
fun main() {
val hasErrors = true
val hasWarnings = true
val isComplete = false
// buildString이 빈 버퍼를 생성합니다
val status = buildString {
// 버퍼에 "Errors found"를 추가합니다
if (hasErrors) append("Errors found")
if (hasWarnings) {
// 버퍼가 비어 있지 않으므로 "; "를 추가합니다
if (isNotEmpty()) append("; ")
// "Warnings found"를 추가합니다
append("Warnings found")
}
// isComplete = false 이므로 아무것도 추가하지 않습니다
if (isComplete) {
if (isNotEmpty()) append("; ")
append("Completed")
}
// 버퍼가 비어 있지 않으므로 fallback을 건너뜁니다
if (isEmpty()) append("OK")
}
println(status)
// Errors found; Warnings found
}버퍼를 명시적인 값으로 다루어야 할 때는 StringBuilder를 사용합니다. 예를 들어 기존 텍스트를 변경하려는 경우가 해당합니다.
fun main() {
val text = "Hello, Kotlin"
val builder = StringBuilder(text)
builder.replace(7, 13, "world")
println(builder.toString())
// Hello, world
}JVM에서는 String.format() 함수를 사용하여 문자열을 포맷할 수도 있습니다.
val text = String.format("Hello, %s", "Kotlin")JVM에서 포맷터 스타일의 지정자(specifier)가 특별히 필요한 경우에만 String.format() 함수를 사용하세요. 포맷 지정자에 대한 자세한 내용은 Java Class Formatter 문서를 참조하세요.
문자열 변환
문자열은 숫자, Boolean 값 또는 입력에서 전달받은 식별자와 같은 다른 타입의 값을 나타내는 데 자주 사용됩니다. Kotlin은 값을 문자열로 변환하고 문자열을 다른 타입으로 파싱하는 함수를 제공합니다.
값의 문자열 표현을 반환하려면 toString() 함수를 사용합니다.
val number = 10
val text = number.toString()문자열 템플릿과 문자열 연결 시 Kotlin은 값을 자동으로 문자열로 변환합니다.
문자열을 다른 타입으로 변환하려면 해당 타입의 파싱 함수를 사용합니다.
- 정수 값:
toByte(),toShort(),toInt(),toLong() - 부동소수점 값:
toDouble(),toFloat() - 불리언:
toBoolean(),toBooleanStrict()
문자열이 올바른 형식인 경우 이러한 함수는 요청된 타입의 값을 반환합니다. 입력값이 유효하지 않을 가능성이 있는 경우 OrNull 변형 함수를 사용하세요. 이러한 함수는 예외를 던지는 대신 null을 반환하므로 사용자 입력이나 완전히 제어할 수 없는 데이터를 다룰 때 안전합니다.
val toInt = "10".toInt() // 10
// 1000000000000은 Int의 최댓값을 초과함
val toIntInvalid = "1000000000000".toIntOrNull()
val toBoolean = "true".toBooleanStrict() // true
val toBooleanInvalid = "yes".toBooleanStrictOrNull() // null