CGI::Ex::Dump.3pm

Langue: en

Autres versions - même langue

Version: 2010-02-25 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

CGI::Ex::Dump - A debug utility

SYNOPSIS

   use CGI::Ex::Dump; # auto imports dex, dex_warn, dex_text and others
 
   my $hash = {
     foo => ['a', 'b', 'Foo','a', 'b', 'Foo','a', 'b', 'Foo','a'],
   };
 
   dex $hash; # or dex_warn $hash;
 
   dex;
 
   dex "hi";
 
   dex $hash, "hi", $hash;
 
   dex \@INC; # print to STDOUT, or format for web if $ENV{REQUEST_METHOD}
 
   dex_warn \@INC;  # same as dex but to STDOUT
 
   print FOO dex_text \@INC; # same as dex but return dump
 
   # ALSO #
 
   use CGI::Ex::Dump qw(debug);
   
   debug; # same as dex
 
 

DESCRIPTION

Uses the base Data::Dumper of the distribution and gives it nicer formatting - and allows for calling just about anytime during execution.

Calling &CGI::Ex::set_deparse() will allow for dumped output of subroutines if available.

perl -e 'use CGI::Ex::Dump; dex ``foo'';'

See also Data::Dumper.

Setting any of the Data::Dumper globals will alter the output.

SUBROUTINES

dex, debug
Prints out pretty output to STDOUT. Formatted for the web if on the web.
dex_warn
Prints to STDERR.
dex_text
Return the text as a scalar.
ctrace
Caller trace returned as an arrayref. Suitable for use like ``debug ctrace''. This does require at least perl 5.8.0's Carp.
on, off
Turns calls to routines on or off. Default is to be on.

LICENSE

This module may distributed under the same terms as Perl itself.

AUTHORS

Paul Seamons <perl at seamons dot com>