Функция toBoolean

Функция toBoolean преобразует различные типы данных в логическое значение Boolean. Может применяться к строкам, числам и другим типам данных. Для строк преобразование происходит по определенным правилам распознавания булевых значений.

Синтаксис

fun String.toBoolean(): Boolean

fun Int.toBoolean(): Boolean

fun Long.toBoolean(): Boolean

Пример

Преобразуем строку "true" в Boolean:

val str: String = "true"
val res: Boolean = str.toBoolean()
println(res)

Результат выполнения кода:

Boolean true

Пример

Преобразуем строку "false" в Boolean:

val str: String = "false"
val res: Boolean = str.toBoolean()
println(res)

Результат выполнения кода:

Boolean false

Пример

Преобразуем число 1 типа Int в Boolean:

val num: Int = 1
val res: Boolean = num.toBoolean()
println(res)

Результат выполнения кода:

Boolean true

Пример

Преобразуем число 0 типа Int в Boolean:

val num: Int = 0
val res: Boolean = num.toBoolean()
println(res)

Результат выполнения кода:

Boolean false

Пример

При преобразовании строки "abc" возникнет исключение, так как строка не является допустимым булевым значением:

try {
	val str: String = "abc"
	val res: Boolean = str.toBoolean()
	println(res)
} catch (e: IllegalArgumentException) {
	println("Error: ${e.message}")
}

Результат выполнения кода:

Error: Invalid Boolean format: 'abc'

Правила преобразования строк

Функция toBoolean для строк распознает следующие значения как true:

"true" (регистронезависимо: "True", "TRUE")

Следующие значения распознаются как false:

"false" (регистронезависимо: "False", "FALSE")

Все остальные строки вызывают исключение IllegalArgumentException.

Правила преобразования чисел

Для числовых типов:

0 преобразуется в false
Любое другое число преобразуется в true

Смотрите также

функцию toBooleanStrict,
которая выполняет строгое преобразование только для "true" и "false"
функцию toBooleanStrictOrNull,
которая возвращает null вместо исключения
функцию toInt,
которая преобразует в целое число
функцию toDouble,
которая преобразует в число с плавающей точкой