NAME

shtk_bool_check — Converts a string to a boolean value

LIBRARY

shtk_import bool

SYNOPSIS

DESCRIPTION

The shtk_bool_check function takes the string value and returns the corresponding boolean value according to shell conventions.

RETURN VALUES

shtk_bool_check returns 0 for any value representing truth. These include the strings ‘yes’ and ‘true’, including any variations in their capitalization, and the integer number ‘1’.

shtk_bool_check returns 1 for any value representing falsehood. These include the strings ‘no’ and ‘false’, including any variations in their capitalization, and the integer number ‘0’.

EXAMPLES

local verbose=no
# Parse flags to see if verbose mode is enabled and set verbose=yes.

if shtk_bool_check "${verbose}"; then
    # Print messages.
fi

ERRORS

shtk_bool_check prints the error given in error_message and exits the shell with non-zero if the value does not represent a valid boolean value. If error_message is not provided, a default message is printed.

SEE ALSO

shtk(3), shtk_bool(3)

HISTORY

shtk_bool_check first appeared in shtk 1.4.