The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

warnings - Perl pragma to control optional warnings

SYNOPSIS

    use warnings;
    no warnings;

    use warnings "all";
    no warnings "all";

    if (warnings::enabled("void") {
        warnings::warn("void", "some warning");
    }

DESCRIPTION

If no import list is supplied, all possible warnings are either enabled or disabled.

Two functions are provided to assist module authors.

warnings::enabled($category)

Returns TRUE if the warnings category in $category is enabled in the calling module. Otherwise returns FALSE.

warnings::warn($category, $message)

If the calling module has not set $category to "FATAL", print $message to STDERR. If the calling module has set $category to "FATAL", print $message STDERR then die.

See "Pragmatic Modules" in perlmod and perllexwarn.