toLongOrNull

Начиная с Kotlin: 1.1

fun String.toLongOrNull(): Long?

Преобразует строку в число типа Long или возвращает null, если строка не является допустимым представлением числа типа Long.

Строка должна состоять из необязательного знака + или - в начале и десятичных цифр (0-9), а также соответствовать допустимому диапазону значений типа Long (в пределах Long.MIN_VALUE..Long.MAX_VALUE); в противном случае возвращается null.

Примеры

import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   println("0".toLongOrNull()) // 0
println("42".toLongOrNull()) // 42
println("042".toLongOrNull()) // 42
println("-42".toLongOrNull()) // -42
// Long.MAX_VALUE
println("9223372036854775807".toLongOrNull()) // 9223372036854775807
// Long overflow
println("9223372036854775808".toLongOrNull()) // null
// 'a' is not a digit
println("-1a".toLongOrNull()) // null
// underscore
println("1_00".toLongOrNull()) // null
// whitespaces
println(" 22 ".toLongOrNull()) // null 
   //sampleEnd
}

fun String.toLongOrNull(radix: Int): Long?

Преобразует строку в число типа Long и возвращает результат или null, если строка не является допустимым представлением числа.

Исключения

IllegalArgumentException

если radix не является допустимым основанием системы счисления для преобразования строки в число.

© 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-long-or-null.html