WhatIf

☔ WhatIf is kotlin extensions for expressing a single if-else statement, nullable and boolean.

Download

Download
Jitpack

Gradle

Add a dependency code to your module's build.gradle file.

dependencies {
    implementation "com.github.skydoves:whatif:1.0.0"
}
Gradle

Usage

WhatIf

WhatIf is an expression for invoking whatIf lambda when the given boolean is true and not-null.

val nullableBoolean: Boolean? = true
whatIf(nullableBoolean) {
  log("not-null and true : $nullableBoolean")
}
Kotlin

Here is an extension for nullable booleans.

nullableBoolean.whatIf {
  log("not-null and true : $nullableBoolean")
}
Kotlin

WhatIfNot

The whatIf expression is basically composed with given, whatIf, whatIfNot.

If the target is null or false, whatIfNot will be invoked instead of the whatIf.

If we do not need to handle whatIfNot case, it can be omitted.

whatIf(
  given = nullableBoolean,
  whatIf = { log("not-null and true : $nullableBoolean") },
  whatIfNot = { log("null or false : $nullableBoolean") }
)
Kotlin

Or here is an extension for nullable boolean.

nullableBoolean.whatIf(
  whatIf = { log("not-null and true : $nullableBoolean") },
  whatIfNot = { log("not-null or false : $nullableBoolean") }
)
Kotlin

WhatIf in the builder pattern

Sometimes we should set builder differently to depend on options.

WhatIf is useful when using a chaining function like a builder pattern.

It can be applied to any builder patterns like AlertDialog.Builder or anything.

val balloon = Balloon.Builder(baseContext)
  .setArrowSize(10)
  .setArrowVisible(true)
  .whatIf(nullableBoolean) { setTextColor(Color.YELLOW) }
  .whatIf(nullableBoolean, { setText("Hello, whatIf") }, { setText("Good-Bye whatIf") })
  .setWidthRatio(1.0f)
  .build()
Kotlin

WhatIfNotNull

WhatIfNotNull is an expression for invoking [whatIf] lambda when the target object is not null.

val nullableObject: Person? = Person()
nullableObject.whatIfNotNull {
  log("$it is not null")
}
Kotlin

And we can handle the null case.

If the target is null, [whatIfNot] will be invoked instead of the [whatIf].

nullableObject.whatIfNotNull(
  whatIf = { log("$it is not null.") },
  whatIfNot = { log("$it is null.") }
)
Kotlin

WhatIfLet

The basic concept is the same as whatIf but it is useful when the receiver and the result should be different.

val length = nullableString?.whatIfLet(
  given = nullableString.length < 5,
  whatIf = { it.length },
  whatIfNot = {
    log("$it, length can not over than 5.")
    5
  }
)
Kotlin

We can use default value instead of the whatIfNot and can be omitted the whatIfNot.

val length = nullableString?.whatIfLet(
  nullableString.length < 5,
  default = nullableString.length) { 
  log("$it, length can not over than 5.")
  5
}
Kotlin

GitHub