uppercase

fun Char.uppercase(): String

Преобразует этот символ в верхний регистр, используя правила сопоставления Юникода для неизменного региона.

Эта функция поддерживает отображение одного символа во множество, поэтому длина возвращаемой строки может быть больше одного. Например, '\uFB00'.uppercase() возвращает "\u0046\u0046", где '\uFB00' — символ LATIN SMALL LIGATURE FF (ff). Если для этого символа нет сопоставления в верхнем регистре, возвращается результат toString() этого символа.

import java.util.*
import kotlin.test.*

fun main(args: Array<String>) {
//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
}

fun String.uppercase(): String

Возвращает копию этой строки, преобразованной в верхний регистр, используя правила сопоставления Юникода для неизменного региона.

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

import java.util.Locale
import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
println("Iced frappé!".uppercase()) // ICED FRAPPÉ!
//sampleEnd
}

fun Char.uppercase(locale: Locale): String

Преобразует этот символ в верхний регистр, используя правила сопоставления Юникода для указанного региона.

Эта функция поддерживает отображение одного символа во множество, поэтому длина возвращаемой строки может быть больше одного. Например, '\uFB00'.uppercase(Locale.US) возвращает "\u0046\u0046", где '\uFB00' — символ LATIN SMALL LIGATURE FF (ff). Если для этого символа нет сопоставления в верхнем регистре, возвращается результат toString() этого символа.

import java.util.*
import kotlin.test.*

fun main(args: Array<String>) {
//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
}

fun String.uppercase(locale: Locale): String

Возвращает копию этой строки, преобразованной в верхний регистр, используя правила указанного региона.

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

import java.util.Locale
import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
println("Kotlin".uppercase()) // KOTLIN
val turkishLocale = Locale.forLanguageTag("tr")
println("Kotlin".uppercase(turkishLocale)) // KOTLİN
//sampleEnd
}