Spec-Zone.ru › Kotlin 2

toShort

kotlin-stdlib/kotlin.text/toShort

Требования к платформе и версии: Common (1.0), JS (1.1), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun String.toShort(): Short

Преобразует строку в число типа Short.

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

Выбрасывает

NumberFormatException

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

Примеры

import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   println("0".toShort()) // 0
println("42".toShort()) // 42
println("042".toShort()) // 42
println("-42".toShort()) // -42
// Short.MAX_VALUE
println("32767".toShort()) // 32767
// Short overflow
// "32768".toShort() // will fail with NumberFormatException
// 'a' is not a digit
// "-1a".toShort() // will fail with NumberFormatException
// underscore
// "1_000".toShort() // will fail with NumberFormatException
// whitespaces
// " 1000 ".toShort() // will fail with NumberFormatException 
   //sampleEnd
}

expect fun String.toShort(radix: Int): Short

Преобразует строку в число типа Short и возвращает результат.

Выбрасывает

NumberFormatException

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

IllegalArgumentException

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

Требования к платформе и версии: JVM (1.0), Native (1.3)

actual inline fun String.toShort(): Short

Преобразует строку в число типа Short.

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

Выбрасывает

NumberFormatException

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

Примеры

import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   println("0".toShort()) // 0
println("42".toShort()) // 42
println("042".toShort()) // 42
println("-42".toShort()) // -42
// Short.MAX_VALUE
println("32767".toShort()) // 32767
// Short overflow
// "32768".toShort() // will fail with NumberFormatException
// 'a' is not a digit
// "-1a".toShort() // will fail with NumberFormatException
// underscore
// "1_000".toShort() // will fail with NumberFormatException
// whitespaces
// " 1000 ".toShort() // will fail with NumberFormatException 
   //sampleEnd
}

actual inline fun String.toShort(radix: Int): Short

Преобразует строку в число типа Short и возвращает результат.

Выбрасывает

NumberFormatException

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

IllegalArgumentException

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

© 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-short.html

Spec-Zone.ru

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