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
}