Spec-Zone.ru › Kotlin 2

uppercase

kotlin-stdlib/kotlin.text/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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API