Функция toUByteOrNull

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

Синтаксис

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

Пример

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

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

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

kotlinUByte 123

Пример

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

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

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

kotlinnull

Пример

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

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

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

kotlinnull

Пример

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

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

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

kotlinUByte 255

Пример

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

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

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

kotlinUByte 200

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

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