Функция toIntOrNull

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

Синтаксис

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

Пример

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

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

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

kotlinInt 123

Пример

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

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

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

kotlinnull

Пример

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

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

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

kotlinInt 123

Пример

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

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

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

kotlinInt 255

Пример

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

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

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

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

kotlin"Conversion failed"

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

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