kotlin-stdlib/kotlin.text/toShortOrNull

toShortOrNull

fun String.toShortOrNull(): Short?(source)

Parses the string to a Short number or returns null if the string is not a valid representation of a Short.

The string must consist of an optional leading + or - sign and decimal digits (0-9), and fit the valid Short value range (within Short.MIN_VALUE..Short.MAX_VALUE), otherwise null is returned.

Since Kotlin

1.1

Samples

import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   println("0".toShortOrNull()) // 0
println("42".toShortOrNull()) // 42
println("042".toShortOrNull()) // 42
println("-42".toShortOrNull()) // -42
// Short.MAX_VALUE
println("32767".toShortOrNull()) // 32767
// Short overflow
println("32768".toShortOrNull()) // null
// 'a' is not a digit
println("-1a".toShortOrNull()) // null
// underscore
println("1_00".toShortOrNull()) // null
// whitespaces
println(" 22 ".toShortOrNull()) // null 
   //sampleEnd
}
fun String.toShortOrNull(radix: Int): Short?(source)

Parses the string as a Short number and returns the result or null if the string is not a valid representation of a number.

Since Kotlin

1.1

Throws

when radix is not a valid radix for string to number conversion.