Функция toUByte

Функция toUByte преобразует числовое значение в беззнаковый байт типа UByte. Может применяться к числам различных типов: Int, Long, Double, Float, Short, Byte, String, а также к другим беззнаковым типам. При преобразовании выполняется проверка на вхождение значения в диапазон 0..255.

Синтаксис

kotlinfun Int.toUByte(): UByte
kotlinfun Long.toUByte(): UByte
kotlinfun Double.toUByte(): UByte
kotlinfun Float.toUByte(): UByte
kotlinfun Short.toUByte(): UByte
kotlinfun Byte.toUByte(): UByte
kotlinfun String.toUByte(): UByte
kotlinfun UInt.toUByte(): UByte
kotlinfun ULong.toUByte(): UByte
kotlinfun UShort.toUByte(): UByte

Пример

Преобразуем число 100 типа Int в UByte:

kotlinval num: Int = 100
val res: UByte = num.toUByte()
println(res)

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

kotlinUByte 100

Пример

Преобразуем число 255 типа Long в UByte:

kotlinval num: Long = 255L
val res: UByte = num.toUByte()
println(res)

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

kotlinUByte 255

Пример

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

kotlinval str: String = "128"
val res: UByte = str.toUByte()
println(res)

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

kotlinUByte 128

Пример

При попытке преобразовать значение за пределами диапазона 0..255 возникнет исключение:

kotlinval num: Int = 300
val res: UByte = num.toUByte()

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

kotlinException: Value out of range: 300

Пример

Преобразуем число с плавающей точкой типа Double в UByte:

kotlinval num: Double = 50.7
val res: UByte = num.toUByte()
println(res)

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

kotlinUByte 50

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

  • функцию toInt,
    которая преобразует значение в знаковое целое число
  • функцию toUInt,
    которая преобразует значение в беззнаковое целое число
  • функцию toUShort,
    которая преобразует значение в беззнаковое короткое целое число
  • функцию toUByteOrNull,
    которая безопасно преобразует значение в UByte