[p5sagit/p5-mst-13.2.git] / pod / modpods / Carp.pod

=head1 NAME

carp - warn of errors (from perspective of caller)

croak - die of errors (from perspective of caller)

confess - die of errors with stack backtrace

=head1 SYNOPSIS

    use Carp;
    croak "We're outta here!";

=head1 DESCRIPTION

The 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.
Commit	Line	Data
a0d0e21e	1	=head1 NAME
	2
	3	carp - warn of errors (from perspective of caller)
	4
	5	croak - die of errors (from perspective of caller)
	6
	7	confess - die of errors with stack backtrace
	8
	9	=head1 SYNOPSIS
	10
	11	use Carp;
	12	croak "We're outta here!";
	13
	14	=head1 DESCRIPTION
	15
	16	The Carp routines are useful in your own modules because
	17	they act like die() or warn(), but report where the error
	18	was in the code they were called from. Thus if you have a
	19	routine Foo() that has a carp() in it, then the carp()
	20	will report the error as occurring where Foo() was called,
	21	not where carp() was called.
	22