Spec-Zone.ru › Kotlin 1.6

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 имеет значение true для символа 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–2022 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