Функция toIntOrNull

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

Синтаксис

fun String.toIntOrNull(): Int?
fun String.toIntOrNull(radix: Int): Int?

fun Int.toIntOrNull(): Int?
fun Long.toIntOrNull(): Int?
fun Short.toIntOrNull(): Int?
fun Byte.toIntOrNull(): Int?
fun Double.toIntOrNull(): Int?
fun Float.toIntOrNull(): Int?

Пример

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

val str: String = "123"
val res: Int? = str.toIntOrNull()
println(res)

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

Int 123

Пример

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

val str: String = "123abc"
val res: Int? = str.toIntOrNull()
println(res)

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

null

Пример

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

val num: Double = 123.45
val res: Int? = num.toIntOrNull()
println(res)

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

Int 123

Пример

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

val str: String = "FF"
val res: Int? = str.toIntOrNull(16)
println(res)

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

Int 255

Пример

Использование с обработкой null:

val input: String = "abc123"
val number: Int? = input.toIntOrNull()

if (number != null) {
	println("Conversion successful: $number")
} else {
	println("Conversion failed")
}

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

"Conversion failed"

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

функцию toInt,
которая выбрасывает исключение при ошибке преобразования
функцию toLongOrNull,
которая выполняет безопасное преобразование в Long
функцию toDoubleOrNull,
которая выполняет безопасное преобразование в Double
функцию toFloatOrNull,
которая выполняет безопасное преобразование в Float