NAME
   String::Palindrome - Determine if a string is a palindrome

VERSION
   version 1.02

SYNOPSIS
       use String::Palindrome qw/ is_palindrome /;


       #  Simple strings

       my $is     = 'abccba';
       my $is_not = 'abcdef';

       is_palindrome( $is      );  # 1

       is_palindrome( $is_not  );  # 0

       is_palindrome( {a => 1} );  # undef
       is_palindrome(          );  # undef



       #  Arrays

       my @is     = qw/ a ab cc ab a /;
       my @is_not = qw/ a ab cc a ba /;

       is_palindrome(  @is     );  # 1
       is_palindrome( \@is     );  # 1

       is_palindrome(  @is_not );  # 0
       is_palindrome( \@is_not );  # 0

       is_palindrome( []       );  # undef

EXPORTS
   *   is_palindrome

FUNCTIONS
 is_palindrome
   Returns true if the string, array_ref, or array is a palindrome. If more
   than one parameter is passed to the function, then it will blindly
   assume that you want to treat them as an array to be tested. This means
   that you could, theoretically, pass in a palindrome of array_refs and it
   would still pass.

   If only one arg is passed, then it is first checked to see if it is an
   array ref. If it is an array ref it is treated as a normal array. If it
   is a simple scalar, then it is treated as a string. If it is any other
   type of ref, then undef is returned. Additionally, a blank array ref
   also returns undef.

AUTHOR
   Adam Lesperance <[email protected]>

SUPPORT
   You can find documentation for this module with the perldoc command.

     perldoc String::Palindrome

 Websites
   *   Search CPAN

       <http://search.cpan.org/dist/String-Palindrome>

   *   AnnoCPAN: Annotated CPAN documentation

       <http://annocpan.org/dist/String-Palindrome>

   *   CPAN Ratings

       <http://cpanratings.perl.org/d/String-Palindrome>

   *   CPAN Forum

       <http://cpanforum.com/dist/String-Palindrome>

   *   RT: CPAN's Bug Tracker

       <http://rt.cpan.org/NoAuth/Bugs.html?Dist=String-Palindrome>

   *   CPANTS Kwalitee

       <http://cpants.perl.org/dist/overview/String-Palindrome>

   *   CPAN Testers Results

       <http://cpantesters.org/distro/S/String-Palindrome.html>

   *   CPAN Testers Matrix

       <http://matrix.cpantesters.org/?dist=String-Palindrome>

   *   Source Code Repository

       The code is open to the world, and available for you to hack on.
       Please feel free to browse it and play with it, or whatever. If you
       want to contribute patches, please send me a diff or prod me to pull
       from your repository :)

       <git://github.com/lespea/String-Palindrome>

 Bugs
   Please report any bugs or feature requests to "bug-string-palindrome at
   rt.cpan.org", or through the web interface at
   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=String-Palindrome>. I
   will be notified, and then you'll automatically be notified of progress
   on your bug as I make changes.

COPYRIGHT AND LICENSE
   This software is copyright (c) 2010 by Adam Lesperance.

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