CONTENTS

NAME

warnings - Perl pragma to control optional warnings

SYNOPSIS

use warnings;
no warnings;

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

use warnings::register;
if (warnings::enabled()) {
    warnings::warn("some warning");
}

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

DESCRIPTION

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

A number of functions are provided to assist module authors.

use warnings::register

Creates a new warnings category which has the same name as the module where the call to the pragma is used.

warnings::enabled([$category])

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

If the parameter, $category, isn't supplied, the current package name will be used.

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.

If the parameter, $category, isn't supplied, the current package name will be used.

See "Pragmatic Modules" in perlmod and perllexwarn.