Функция toUByte

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

Синтаксис

fun Int.toUByte(): UByte

fun Long.toUByte(): UByte

fun Double.toUByte(): UByte

fun Float.toUByte(): UByte

fun Short.toUByte(): UByte

fun Byte.toUByte(): UByte

fun String.toUByte(): UByte

fun UInt.toUByte(): UByte

fun ULong.toUByte(): UByte

fun UShort.toUByte(): UByte

Пример

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

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

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

UByte 100

Пример

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

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

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

UByte 255

Пример

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

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

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

UByte 128

Пример

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

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

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

Exception: Value out of range: 300

Пример

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

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

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

UByte 50

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

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