Функция toUByteOrNull

Функция toUByteOrNull выполняет безопасное преобразование строки или числа в беззнаковый байт типа UByte. Если преобразование невозможно (например, строка содержит нечисловые символы или число выходит за диапазон 0 - 255), функция возвращает null вместо выбрасывания исключения.

Синтаксис

fun String.toUByteOrNull(): UByte?
fun String.toUByteOrNull(radix: Int): UByte?
fun Int.toUByteOrNull(): UByte?
fun Long.toUByteOrNull(): UByte?

Пример

Преобразуем строку "123" в UByte:

val str = "123"
val res: UByte? = str.toUByteOrNull()
println(res)

Результат выполнения кода:

UByte 123

Пример

Попробуем преобразовать строку с нечисловыми символами:

val str = "12a"
val res: UByte? = str.toUByteOrNull()
println(res)

Результат выполнения кода:

null

Пример

Попробуем преобразовать число, выходящее за диапазон UByte:

val num = 300
val res: UByte? = num.toUByteOrNull()
println(res)

Результат выполнения кода:

null

Пример

Преобразуем шестнадцатеричную строку в UByte:

val str = "FF"
val res: UByte? = str.toUByteOrNull(16)
println(res)

Результат выполнения кода:

UByte 255

Пример

Использование с оператором безопасного вызова и Elvis:

val input = "200"
val result = input.toUByteOrNull() ?: 0.toUByte()
println(result)

Результат выполнения кода:

UByte 200

Смотрите также

функцию toUByte,
которая выбрасывает исключение при ошибке преобразования
функцию toUIntOrNull,
которая безопасно преобразует в UInt
функцию toULongOrNull,
которая безопасно преобразует в ULong
функцию toUShortOrNull,
которая безопасно преобразует в UShort