Spec-Zone.ru › Kotlin 1.9

digitToInt

kotlin-stdlib / kotlin.text / digitToInt
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
fun Char.digitToInt(): Int

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

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

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

fun main(args: Array<String>) {
//sampleStart
println('5'.digitToInt()) // 5
println('3'.digitToInt(radix = 8)) // 3
println('A'.digitToInt(radix = 16)) // 10
println('k'.digitToInt(radix = 36)) // 20

// radix argument should be in 2..36
// '0'.digitToInt(radix = 1) //  will fail
// '1'.digitToInt(radix = 100) //  will fail
// only 0 and 1 digits are valid for binary numbers
// '5'.digitToInt(radix = 2) //  will fail
// radix = 10 is used by default
// 'A'.digitToInt() //  will fail
// symbol '+' is not a digit in any radix
// '+'.digitToInt() //  will fail
// Only Latin letters are valid for digits greater than 9.
// 'β'.digitToInt(radix = 36) //  will fail
//sampleEnd
}
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
fun Char.digitToInt(radix: Int): Int

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

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

  • isDigit истинно для символа Char и значение 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(args: Array<String>) {
//sampleStart
println('5'.digitToInt()) // 5
println('3'.digitToInt(radix = 8)) // 3
println('A'.digitToInt(radix = 16)) // 10
println('k'.digitToInt(radix = 36)) // 20

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

© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/digit-to-int.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API