uppercase
Платформа и требования к версии: Common (1.5), Native (1.5), Wasm-JS (1.8), Wasm-WASI (1.8)
expect fun Char.uppercase(): String
Преобразует этот символ в верхний регистр, используя правила сопоставления Unicode для инвариантной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами, поэтому длина возвращаемой строки может быть больше единицы. Например, '\uFB00'.uppercase() возвращает "\u0046\u0046", где '\uFB00' — символ LATIN SMALL LIGATURE FF (ff). Если для этого символа нет соответствия в верхнем регистре, возвращается результат toString() этого символа.
Примеры
import java.util.*
import kotlin.test.*
fun main() {
//sampleStart
val chars = listOf('a', 'ω', '1', 'ʼn', 'A', '+', 'ß')
val uppercaseChar = chars.map { it.uppercaseChar() }
val uppercase = chars.map { it.uppercase() }
println(uppercaseChar) // [A, Ω, 1, ʼn, A, +, ß]
println(uppercase) // [A, Ω, 1, ʼN, A, +, SS]
//sampleEnd
}
expect fun String.uppercase(): String
Возвращает копию этой строки, преобразованную в верхний регистр с использованием правил сопоставления Unicode для инвариантной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами и нескольких символов с одним, поэтому длина возвращаемой строки может отличаться от длины исходной строки.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
println("Iced frappé!".uppercase()) // ICED FRAPPÉ!
//sampleEnd
}
Платформа и требования к версии: JS (1.5)
actual inline fun Char.uppercase(): String
Преобразует этот символ в верхний регистр, используя правила сопоставления Unicode для инвариантной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами, поэтому длина возвращаемой строки может быть больше единицы. Например, '\uFB00'.uppercase() возвращает "\u0046\u0046", где '\uFB00' — символ LATIN SMALL LIGATURE FF (ff). Если для этого символа нет соответствия в верхнем регистре, возвращается результат toString() этого символа.
Примеры
import java.util.*
import kotlin.test.*
fun main() {
//sampleStart
val chars = listOf('a', 'ω', '1', 'ʼn', 'A', '+', 'ß')
val uppercaseChar = chars.map { it.uppercaseChar() }
val uppercase = chars.map { it.uppercase() }
println(uppercaseChar) // [A, Ω, 1, ʼn, A, +, ß]
println(uppercase) // [A, Ω, 1, ʼN, A, +, SS]
//sampleEnd
}
actual inline fun String.uppercase(): String
Возвращает копию этой строки, преобразованную в верхний регистр с использованием правил сопоставления Unicode для инвариантной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами и нескольких символов с одним, поэтому длина возвращаемой строки может отличаться от длины исходной строки.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
println("Iced frappé!".uppercase()) // ICED FRAPPÉ!
//sampleEnd
}
Платформа и требования к версии: JVM (1.5)
fun Char.uppercase(locale: Locale): String
Преобразует этот символ в верхний регистр, используя правила сопоставления Unicode для указанной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами, поэтому длина возвращаемой строки может быть больше единицы. Например, '\uFB00'.uppercase(Locale.US) возвращает "\u0046\u0046", где '\uFB00' — символ LATIN SMALL LIGATURE FF (ff). Если для этого символа нет соответствия в верхнем регистре, возвращается результат toString() этого символа.
Примеры
import java.util.*
import kotlin.test.*
fun main() {
//sampleStart
val chars = listOf('a', '1', 'ʼn', 'A', '+', 'i')
val uppercase = chars.map { it.uppercase() }
val turkishLocale = Locale.forLanguageTag("tr")
val uppercaseTurkish = chars.map { it.uppercase(turkishLocale) }
println(uppercase) // [A, 1, ʼN, A, +, I]
println(uppercaseTurkish) // [A, 1, ʼN, A, +, İ]
//sampleEnd
}
inline fun String.uppercase(locale: Locale): String
Возвращает копию этой строки, преобразованную в верхний регистр с использованием правил указанной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами и нескольких символов с одним, поэтому длина возвращаемой строки может отличаться от длины исходной строки.
Примеры
import kotlin.test.*
import java.util.*
import java.util.regex.*
fun main() {
//sampleStart
println("Kotlin".uppercase()) // KOTLIN
val turkishLocale = Locale.forLanguageTag("tr")
println("Kotlin".uppercase(turkishLocale)) // KOTLİN
//sampleEnd
}
actual inline fun Char.uppercase(): String
Преобразует этот символ в верхний регистр, используя правила сопоставления Unicode для инвариантной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами, поэтому длина возвращаемой строки может быть больше единицы. Например, '\uFB00'.uppercase() возвращает "\u0046\u0046", где '\uFB00' — символ LATIN SMALL LIGATURE FF (ff). Если для этого символа нет соответствия в верхнем регистре, возвращается результат toString() этого символа.
Примеры
import java.util.*
import kotlin.test.*
fun main() {
//sampleStart
val chars = listOf('a', 'ω', '1', 'ʼn', 'A', '+', 'ß')
val uppercaseChar = chars.map { it.uppercaseChar() }
val uppercase = chars.map { it.uppercase() }
println(uppercaseChar) // [A, Ω, 1, ʼn, A, +, ß]
println(uppercase) // [A, Ω, 1, ʼN, A, +, SS]
//sampleEnd
}
actual inline fun String.uppercase(): String
Возвращает копию этой строки, преобразованную в верхний регистр с использованием правил сопоставления Unicode для инвариантной локали.
Эта функция поддерживает сопоставление одного символа с несколькими символами и нескольких символов с одним, поэтому длина возвращаемой строки может отличаться от длины исходной строки.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
println("Iced frappé!".uppercase()) // ICED FRAPPÉ!
//sampleEnd
}
© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.text/uppercase.html