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
}