Alan Haggai Alavi > Scalar-Boolean-1.02 > Scalar::Boolean

Download:
Scalar-Boolean-1.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source  

NAME ^

Scalar::Boolean - Makes scalar variables store Boolean values only

VERSION ^

version 1.02

SYNOPSIS ^

    use Scalar::Boolean;

    bool my $value;
    $value = [];       # $value gets set to 1
    $value = 'Perl';   # $value gets set to 1
    $value = '';       # $value gets set to 0
    $value = '0';      # $value gets set to 0
    $value = undef;    # $value gets set to 0
    $value = ();       # $value gets set to 0

    unbool $value;
    $value = 'foo';  # $value gets set to 'foo'

    boolean [];     # returns 1
    boolean undef;  # returns 0

METHODS ^

bool or booleanise or booleanize

Accepts scalar variables which will be booleanised. Once booleanised, the variable will convert all values that are assigned to it to their corresponding Boolean values. No effect on already booleanised variables.

unbool or unbooleanise or unbooleanize

Accepts scalar variables which will be unbooleanised if already booleanised. No effect on not already booleanised variables.

boolean

Accepts a single value and returns its boolean value without affecting its original value.

PERFORMANCE ^

For performance reasons, Scalar::Boolean prefers Variable::Magic if it is installed, else uses Tie::Scalar for magic.

ACKNOWLEDGEMENT ^

Many thanks to Eric Brine (ikegami) for suggesting several improvements, for valuable suggestions and also for sending sample code. Thank you Eric! :-)

AUTHOR ^

Alan Haggai Alavi <alanhaggai@alanhaggai.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2012 by Alan Haggai Alavi.

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

syntax highlighting: