whenNull

Returns its argument when the value is null. Using this method may avoid the use of an if/else block. It can be used to ensure that a method chain never returns a null value.

See also $, $val, $value.

Syntax

whenNull(someValue)

Parameter

Description

someValue

The value to return when the original value is null.

Examples

// the call to any() may result is null. Thus, adding whenNull ensures that the chain never returns null.
$('MyVar').any('YES').whenNull(false);

// This complex chain, may result in null for many reasons. Again, adding the whenNull ensures the result is never null.
$('MyVar').or(
$('SomeOtherVar').and($('YetAnotherVar'))
).whenNull(false);

// Returns a text Value when null
$('MyTextVar').whenNull('foo');
$('MyTextVar').whenNull($('AnotherTextVar'));

// Returns a integer Value when null
$('MyIntegerVar').whenNull(999);
$('MyIntegerVar').whenNull('999');

// Applies to each value in a value sequence
$('MyRepeatableVar').whenNull(99);