Функция toULongOrNull

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

Импорт

import kotlin.text.toULongOrNull

Синтаксис

fun String.toULongOrNull(): ULong?

fun String.toULongOrNull(radix: Int): ULong?

fun Int.toULongOrNull(): ULong?

fun Long.toULongOrNull(): ULong?

Пример

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

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

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

ULong 18446744073709551615

Пример

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

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

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

null

Пример

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

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

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

ULong 255

Пример

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

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

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

ULong 10

Пример

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

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

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

null

Пример

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

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

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

ULong 1000

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

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