Steven Haryanto

NAME

Data::Unixish::bool - Format bool

VERSION

version 1.32

SYNOPSIS

In Perl:

 use Data::Unixish::List qw(dux);
 my @res = dux([bool => {style=>"check_cross"}], [0, "one", 2, ""])
 # => ("✕","✓","✓","✕")

In command line:

 % echo -e "0\none\n2\n\n" | dux bool -s y_n --format=text-simple
 n
 y
 y
 n

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

DESCRIPTION

FUNCTIONS

None are exported by default, but they are exportable.

bool(%args) -> [status, msg, result, meta]

Format boolean.

Arguments ('*' denotes required arguments):

  • false_char => str

    Instead of style, you can also specify character for true value.

  • in => any

    Input stream (e.g. array or filehandle).

  • notion => str (default: "perl")

    What notion to use to determine true/false.

    perl uses Perl notion.

    n1 (for lack of better name) is just like Perl notion, but empty array and empty hash is considered false.

    TODO: add Ruby, Python, PHP, JavaScript, etc notion.

  • out => any

    Output stream (e.g. array or filehandle).

  • style => str (default: "one_zero")

    Available styles:

    • Y_N: N Y

    • check (uses Unicode): ✓

    • check_cross (uses Unicode): ✕ ✓

    • dot (uses Unicode): ●

    • dot_cross (uses Unicode): ✘ ●

    • heavycheckcross (uses Unicode): ✘ ✔

    • one_zero: 0 1

    • t_f: f t

    • true_false: false true

    • v_X: X v

    • y_n: n y

    • yes_no: no yes

  • true_char => str

    Instead of style, you can also specify character for true value.

Return value:

Returns an enveloped result (an array). First element (status) is an integer containing HTTP status code (200 means OK, 4xx caller error, 5xx function error). Second element (msg) is a string containing error message, or 'OK' if status is 200. Third element (result) is optional, the actual result. Fourth element (meta) is called result metadata and is optional, a hash that contains extra information.