digitToIntOrNull

kotlin-stdlib/kotlin.text/digitToIntOrNull

Начиная с Kotlin: 1.5

fun Char.digitToIntOrNull(): Int?

Возвращает числовое значение десятичной цифры, которую представляет этот Char, или null, если этот Char не является допустимой десятичной цифрой.

Char считается десятичной цифрой, если для него isDigit возвращает true. В этом случае возвращается значение символа как десятичной цифры в Unicode.

Примеры

import java.util.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println('5'.digitToIntOrNull()) // 5
println('3'.digitToIntOrNull(radix = 8)) // 3
println('A'.digitToIntOrNull(radix = 16)) // 10
println('K'.digitToIntOrNull(radix = 36)) // 20

// radix argument should be in 2..36
// '0'.digitToIntOrNull(radix = 1) // will fail
// '1'.digitToIntOrNull(radix = 100) // will fail
// only 0 and 1 digits are valid for binary numbers
println('5'.digitToIntOrNull(radix = 2)) // null
// radix = 10 is used by default
println('A'.digitToIntOrNull()) // null
// symbol '+' is not a digit in any radix
println('+'.digitToIntOrNull()) // null
// Only Latin letters are valid for digits greater than 9.
println('β'.digitToIntOrNull(radix = 36)) // null 
   //sampleEnd
}

fun Char.digitToIntOrNull(radix: Int): Int?

Возвращает числовое значение цифры, которую этот Char представляет в указанном основании системы счисления, или null, если этот Char не является допустимой цифрой в указанном основании системы счисления. Выбрасывает исключение, если основание системы счисления не входит в диапазон 2..36.

Char считается цифрой в указанном основании системы счисления, если выполняется хотя бы одно из следующих условий:

Для Char isDigit возвращает true, а значение символа как десятичной цифры в Unicode меньше указанного основания системы счисления. В этом случае возвращается значение десятичной цифры.
Char является одной из заглавных латинских букв от 'A' до 'Z', а его код меньше radix + 'A'.code - 10. В этом случае возвращается this.code - 'A'.code + 10.
Char является одной из строчных латинских букв от 'a' до 'z', а его код меньше radix + 'a'.code - 10. В этом случае возвращается this.code - 'a'.code + 10.
Char является одной из полноширинных заглавных латинских букв от '\uFF21' до '\uFF3A', а его код меньше radix + 0xFF21 - 10. В этом случае возвращается this.code - 0xFF21 + 10.
Char является одной из полноширинных строчных латинских букв от '\uFF41' до '\uFF5A', а его код меньше radix + 0xFF41 - 10. В этом случае возвращается this.code - 0xFF41 + 10.

Примеры

import java.util.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println('5'.digitToIntOrNull()) // 5
println('3'.digitToIntOrNull(radix = 8)) // 3
println('A'.digitToIntOrNull(radix = 16)) // 10
println('K'.digitToIntOrNull(radix = 36)) // 20

// radix argument should be in 2..36
// '0'.digitToIntOrNull(radix = 1) // will fail
// '1'.digitToIntOrNull(radix = 100) // will fail
// only 0 and 1 digits are valid for binary numbers
println('5'.digitToIntOrNull(radix = 2)) // null
// radix = 10 is used by default
println('A'.digitToIntOrNull()) // null
// symbol '+' is not a digit in any radix
println('+'.digitToIntOrNull()) // null
// Only Latin letters are valid for digits greater than 9.
println('β'.digitToIntOrNull(radix = 36)) // null 
   //sampleEnd
}

© 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/digit-to-int-or-null.html