Spec-Zone.ru › Kotlin 2

parseOrNull

kotlin-stdlib/kotlin.uuid/Uuid/Companion/parseOrNull

Версия Kotlin: 2.4

fun parseOrNull(uuidString: String): Uuid?

Разбирает UUID в одном из поддерживаемых строковых представлений и возвращает null, если он не соответствует ни одному из них.

Эта функция поддерживает разбор стандартных строковых представлений с шестнадцатеричными цифрами и дефисами, а также в шестнадцатеричном формате. Подробные сведения о формате с шестнадцатеричными цифрами и дефисами см. в описании toHexDashString. Если требуется разбирать только формат с шестнадцатеричными цифрами и дефисами, используйте вместо неё parseHexDashOrNull. Подробные сведения о шестнадцатеричном формате см. в описании toHexString. Если требуется разбирать только шестнадцатеричный формат, используйте вместо неё parseHexOrNull.

Обратите внимание, что эта функция не учитывает регистр: допустимыми считаются как строчные, так и прописные шестнадцатеричные цифры. Кроме того, в будущем может быть добавлена поддержка других форматов UUID. Поэтому не следует полагаться на то, что форматы, которые в настоящее время не поддерживаются, будут отклонены.

Возвращает

UUID, соответствующий указанной строке UUID, или null, если строка не соответствует ни одному из поддерживаемых форматов.

Параметры

uuidString

Строка в одном из поддерживаемых форматов UUID.

См. также

Uuid.parseHexDashOrNull
Uuid.parseHexOrNull
Uuid.parse

Примеры

import kotlin.test.*
import kotlin.time.Instant
import kotlin.uuid.*

fun main() { 
   //sampleStart 
   // Parsing is case-insensitive
val uuid1 = Uuid.parseOrNull("550E8400-e29b-41d4-A716-446655440000") // hex-and-dash
val uuid2 = Uuid.parseOrNull("550e8400E29b41D4a716446655440000") // hexadecimal

println("uuid1 == uuid2 is ${uuid1 == uuid2}") // true
println(uuid1) // 550e8400-e29b-41d4-a716-446655440000
println(uuid2) // 550e8400-e29b-41d4-a716-446655440000

assertNull(Uuid.parseOrNull("I'm not a UUID, sorry")) 
   //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.uuid/-uuid/-companion/parse-or-null.html

Spec-Zone.ru

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