CONTENTS

• NAME
• SYNOPSIS
• DESCRIPTION

#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.

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.