NAME
    Dpchrist::Is - various type tests

DESCRIPTION
    This documentation describes module revision $Revision: 1.28 $.

    This is alpha test level software and may change or disappear at any
    time.

  SUBROUTINES
   _isa($$)
        if (_isa EXPR1,EXPR2) {
            # do something...
        }

    Returns true (1) if EXPR1 is an object or class of type EXPR2, or
    derived from EXPR2. Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

   is_arrayref($)
        if (is_arrayref EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is an array reference, including an empty
    array. Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

   is_filehandle($)
        if (is_filehandle EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is a file handle. Otherwise, returns the
    undefined value.

    This subroutine should not generate exceptions.

   is_filename($)
        if (is_filename EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is the name of an existing file or if Perl can
    open a file for writing on that name (opens, closes, and unlinks file to
    find out). Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

   is_hashref($)
        if (is_hashref EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is a hash reference, including an empty hash.
    Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

   is_nonempty_string($)
        if (is_nonempty_string EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is a non-empty string. Otherwise, returns the
    undefined value.

    This subroutine should not generate exceptions.

   is_rxref($)
        if (is_rxref EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is a reference to a regular expression,
    including an empty regular expression. Otherwise, returns the undefined
    value.

    This subroutine should not generate exceptions.

   is_string($)
        if (is_string EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is a string, including an empty string.
    Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

   is_wholenumber($)
        if (is_wholenumber EXPR) {
            # do something...
        }

    Returns true (1) if EXPR is a whole number. Otherwise, returns the
    undefined value.

    This subroutine should not generate exceptions.

   isa_class($$)
        if (isa_class EXPR1,EXPR2) {
            # do something...
        }

    Returns true (1) if EXPR1 is a class of type EXPR2, or derived from
    EXPR2. Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

   isa_object($$)
        if (isa_object EXPR1,EXPR2) {
            # do something...
        }

    Returns true (1) if EXPR1 is an object of type EXPR2, or derived from
    EXPR2. Otherwise, returns the undefined value.

    This subroutine should not generate exceptions.

  EXPORTS
    This module exports nothing by default.

    All subroutines except those starting with an underscore '_' may be
    exported by using the ':all' tag:

        use Dpchrist::Is    qw( :all );

    Specific subroutines may be exported on request. See 'perldoc Exporter'
    for details.

INSTALLATION
    Old school:

        $ perl Makefile.PL
        $ make
        $ make test
        $ make install

    Minimal:

        $ cpan Dpchrist::Is

    Complete:

        $ cpan Bundle::Dpchrist

    The following warning may be safely ignored:

        Can't locate Dpchrist/Module/MakefilePL.pm in @INC (@INC contains: /
        etc/perl /usr/local/lib/perl/5.10.0 /usr/local/share/perl/5.10.0 /us
        r/lib/perl5 /usr/share/perl5 /usr/lib/perl/5.10 /usr/share/perl/5.10
         /usr/local/lib/site_perl .) at Makefile.PL line 22.

  PREREQUISITES
    See Makefile.PL in the source distribution root directory.

SEE ALSO
        Scalar::Util

AUTHOR
    David Paul Christensen dpchrist@holgerdanske.com

COPYRIGHT AND LICENSE
    Copyright 2010 by David Paul Christensen dpchrist@holgerdanske.com

    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by the
    Free Software Foundation; version 2.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
    Public License for more details.

    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.