boolean man page on Pidora

Man page or keyword search:  
man Server   31170 pages
apropos Keyword Search (all sections)
Output format
Pidora logo
[printable version]

boolean(3)	      User Contributed Perl Documentation	    boolean(3)

NAME
       boolean - Boolean support for Perl

SYNOPSIS
	   use boolean;

	   do &always if true;
	   do &never if false;

	   do &maybe if boolean($value)->isTrue;

       and:

	   use boolean ':all';

	   $guess = int(rand(2)) % 2 ? true : false;

	   do &something if isTrue($guess);
	   do &something_else if isFalse($guess);

DESCRIPTION
       Most programming languages have a native "Boolean" data type.  Perl
       does not.

       Perl has a simple and well known Truth System. The following scalar
       values are false:

	   $false1 = undef;
	   $false2 = 0;
	   $false3 = 0.0;
	   $false4 = '';
	   $false5 = '0';

       Every other scalar value is true.

       This module provides basic Boolean support, by defining two special
       objects: "true" and "false".

RATIONALE
       When sharing data between programming languages, it is important to
       support the same group of basic types. In Perlish programming
       languages, these types include: Hash, Array, String, Number, Null and
       Boolean. Perl lacks native Boolean support.

       Data interchange modules like YAML and JSON can now "use boolean" to
       encode/decode/roundtrip Boolean values.

FUNCTIONS
       This module defines the following functions:

       true
	   This function returns a scalar value which will evaluate to true.
	   The value is a singleton object, meaning there is only one "true"
	   value in a Perl process at any time. You can check to see whether
	   the value is the "true" object with the isTrue function described
	   below.

       false
	   This function returns a scalar value which will evaluate to false.
	   The value is a singleton object, meaning there is only one "false"
	   value in a Perl process at any time. You can check to see whether
	   the value is the "false" object with the isFalse function described
	   below.

       boolean($scalar)
	   Casts the scalar value to a boolean value. If $scalar is true, it
	   returns "boolean::true", otherwise it returns "boolean::false".

       isTrue($scalar)
	   Returns "boolean::true" if the scalar passed to it is the
	   "boolean::true" object. Returns "boolean::false" otherwise.

       isFalse($scalar)
	   Returns "boolean::true" if the scalar passed to it is the
	   "boolean::false" object. Returns "boolean::false" otherwise.

       isBoolean($scalar)
	   Returns "boolean::true" if the scalar passed to it is the
	   "boolean::true" or "boolean::false" object. Returns
	   "boolean::false" otherwise.

METHODS
       Since true and false return objects, you can call methods on them.

       $boolean->isTrue
	   Same as isTrue($boolean).

       $boolean->isFalse
	   Same as isFalse($boolean).

EXPORTABLES
       By default this module exports the "true", "false" and "boolean"
       functions.

       The module also defines these export tags:

       :all
	   Exports "true", "false", "boolean", "isTrue", "isFalse",
	   "isBoolean"

AUTHOR
       Ingy doet Net <ingy@cpan.org>

COPYRIGHT
       Copyright (c) 2007, 2008, 2010, 2011. Ingy doet Net.

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

       See http://www.perl.com/perl/misc/Artistic.html

perl v5.14.1			  2011-06-28			    boolean(3)
[top]

List of man pages available for Pidora

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net