Функция require

Функция require используется для проверки условий в Kotlin. Если переданное условие ложно, функция выбрасывает исключение IllegalArgumentException с указанным сообщением. Часто применяется для валидации параметров в начале функций.

Синтаксис

inline fun require(value: Boolean): Unit

inline fun require(value: Boolean, lazyMessage: () -> Any): Unit

Пример

Проверим, что число положительное:

val num = 5
require(num > 0)
println("Number is positive")

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

"Number is positive"

Пример

Проверим условие с кастомным сообщением об ошибке:

val num = -1
require(num > 0) { "Number must be positive" }

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

Exception in thread "main" java.lang.IllegalArgumentException: Number must be positive

Пример

Использование require для проверки параметров функции:

fun calculateSqrt(x: Double): Double {
	require(x >= 0) { "Number can't be negative" }
	return Math.sqrt(x)
}

val res = calculateSqrt(9.0)
println(res)

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

3.0

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

функцию assert,
которая проверяет условия только в тестовом режиме