Функция toULongOrNull

Функция toULongOrNull выполняет преобразование строки или числа в беззнаковое длинное целое число типа ULong. В случае невозможности преобразования (например, при нечисловых символах в строке или переполнении), функция возвращает null вместо выброса исключения. Поддерживает преобразование из строк с десятичными, шестнадцатеричными и двоичными числами.

Импорт

kotlinimport kotlin.text.toULongOrNull

Синтаксис

kotlinfun String.toULongOrNull(): ULong?
kotlinfun String.toULongOrNull(radix: Int): ULong?
kotlinfun Int.toULongOrNull(): ULong?
kotlinfun Long.toULongOrNull(): ULong?

Пример

Преобразуем корректную числовую строку в ULong:

kotlinval str = "18446744073709551615"
val res: ULong? = str.toULongOrNull()
println(res)

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

kotlinULong 18446744073709551615

Пример

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

kotlinval str = "123abc"
val res: ULong? = str.toULongOrNull()
println(res)

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

kotlinnull

Пример

Преобразуем шестнадцатеричное число с указанием системы счисления:

kotlinval str = "FF"
val res: ULong? = str.toULongOrNull(16)
println(res)

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

kotlinULong 255

Пример

Преобразуем двоичное число:

kotlinval str = "1010"
val res: ULong? = str.toULongOrNull(2)
println(res)

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

kotlinULong 10

Пример

Преобразуем отрицательное число типа Int:

kotlinval num = -5
val res: ULong? = num.toULongOrNull()
println(res)

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

kotlinnull

Пример

Преобразуем положительное число типа Long:

kotlinval num: Long = 1000L
val res: ULong? = num.toULongOrNull()
println(res)

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

kotlinULong 1000

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

  • функцию toULong,
    которая выбрасывает исключение при ошибке преобразования
  • функцию toUIntOrNull,
    которая преобразует в беззнаковое целое число UInt
  • функцию toLongOrNull,
    которая преобразует в знаковое длинное целое число Long
  • функцию toDoubleOrNull,
    которая преобразует в число с плавающей точкой Double