Copyright (C) 2000-2012 |
Manpages CarpSection: Perl Programmers Reference Guide (3perl)Updated: 2001-02-22 Index Return to Main Contents NAMEcarp - warn of errors (from perspective of caller)
cluck - warn of errors with stack backtrace
croak - die of errors (from perspective of caller) confess - die of errors with stack backtrace SYNOPSISuse Carp; croak "We're outta here!"; use Carp qw(cluck); cluck "This is how we got here!"; DESCRIPTIONThe Carp routines are useful in your own modules because they act like die() or warn(), but report where the error was in the code they were called from. Thus if you have a routine Foo() that has a carp() in it, then the carp() will report the error as occurring where Foo() was called, not where carp() was called.Forcing a Stack TraceAs a debugging aid, you can force Carp to treat a croak as a confess and a carp as a cluck across all modules. In other words, force a detailed stack trace to be given. This can be very helpful when trying to understand why, or from where, a warning or error is being generated.This feature is enabled by 'importing' the non-existent symbol 'verbose'. You would typically enable it by saying
perl -MCarp=verbose script.plor by including the string "MCarp=verbose" in the PERL5OPT environment variable. BUGSThe Carp routines don't handle exception objects currently. If called with a first argument that is a reference, they simply call die() or warn(), as appropriate.
IndexThis document was created by man2html, using the manual pages. Time: 07:53:37 GMT, March 29, 2024 |