Функция toBoolean

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

Синтаксис

kotlinfun String.toBoolean(): Boolean
kotlinfun Int.toBoolean(): Boolean
kotlinfun Long.toBoolean(): Boolean

Пример

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

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

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

kotlinBoolean true

Пример

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

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

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

kotlinBoolean false

Пример

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

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

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

kotlinBoolean true

Пример

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

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

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

kotlinBoolean false

Пример

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

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

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

kotlinError: Invalid Boolean format: 'abc'

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

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

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

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

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

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

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

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