


warnings(3p)     Perl Programmers Reference Guide    warnings(3p)


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 `$mes-
           sage' STDERR then die.

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

       See the Pragmatic Modules entry in the perlmod manpage and
       the perllexwarn manpage.






2000-04-06                 perl v5.6.0                          1


