to Int
Требования к платформе и версии: Common (1.0), JS (1.1), Wasm-JS (1.8), Wasm-WASI (1.8)
expect fun String.toInt(): Int
Преобразует строку в число типа Int.
Строка должна состоять из необязательного знака + или - в начале и десятичных цифр (0-9), а также укладываться в допустимый диапазон значений Int (в пределах Int.MIN_VALUE..Int.MAX_VALUE), в противном случае будет выброшено исключение NumberFormatException.
Исключения
если строка не является допустимым представлением значения типа Int.
Примеры
import kotlin.test.assertFailsWith
fun main() {
//sampleStart
println("0".toInt()) // 0
println("42".toInt()) // 42
println("042".toInt()) // 42
println("-42".toInt()) // -42
// Int.MAX_VALUE
println("2147483647".toInt()) // 2147483647
// Int overflow
// "2147483648".toInt() // will fail with NumberFormatException
// 'a' is not a digit
// "-1a".toInt() // will fail with NumberFormatException
// underscore
// "1_000".toInt() // will fail with NumberFormatException
// whitespaces
// " 1000 ".toInt() // will fail with NumberFormatException
//sampleEnd
}
expect fun String.toInt(radix: Int): Int
Преобразует строку в число типа Int и возвращает результат.
Исключения
если строка не является допустимым представлением числа.
если основание системы счисления не является допустимым основанием для преобразования строки в число.
Требования к платформе и версии: JVM (1.0), Native (1.3)
actual inline fun String.toInt(): Int
Преобразует строку в число типа Int.
Строка должна состоять из необязательного знака + или - в начале и десятичных цифр (0-9), а также укладываться в допустимый диапазон значений Int (в пределах Int.MIN_VALUE..Int.MAX_VALUE), в противном случае будет выброшено исключение NumberFormatException.
Исключения
если строка не является допустимым представлением значения типа Int.
Примеры
import kotlin.test.assertFailsWith
fun main() {
//sampleStart
println("0".toInt()) // 0
println("42".toInt()) // 42
println("042".toInt()) // 42
println("-42".toInt()) // -42
// Int.MAX_VALUE
println("2147483647".toInt()) // 2147483647
// Int overflow
// "2147483648".toInt() // will fail with NumberFormatException
// 'a' is not a digit
// "-1a".toInt() // will fail with NumberFormatException
// underscore
// "1_000".toInt() // will fail with NumberFormatException
// whitespaces
// " 1000 ".toInt() // will fail with NumberFormatException
//sampleEnd
}
actual inline fun String.toInt(radix: Int): Int
Преобразует строку в число типа Int и возвращает результат.
Исключения
если строка не является допустимым представлением числа.
если основание системы счисления не является допустимым основанием для преобразования строки в число.
© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.text/to-int.html