


Log::Dispatch::User(Contributed Perl DocumeLog::Dispatch::Null(3)


NAME
       Log::Dispatch::File - Object that accepts messages and does nothing

SYNOPSIS
         use Log::Dispatch::Null;

         my $null = Log::Dispatch::Null->new( name      => 'null',
                                              min_level => 'info' );

         $null->log( level => 'emerg', message => "I've fallen and I can't get up\n" );

DESCRIPTION
       This class provides a null logging object. Messages can be sent to the
       object but it does nothing with them.

METHODS
       o   new(%p)

           This method takes a hash of parameters.  The following options are
           valid:

           o       name ($)

                   The name of the object (not the filename!).  Required.

           o       min_level ($)

                   The minimum logging level this object will accept.  See the
                   Log::Dispatch documentation on Log Levels for more
                   information.  Required.

           o       max_level ($)

                   The maximum logging level this obejct will accept.  See the
                   Log::Dispatch documentation on Log Levels for more
                   information.  This is not required.  By default the maximum
                   is the highest possible level (which means functionally
                   that the object has no maximum).

           o       callbacks( \& or [ \&, \&, ... ] )

                   This parameter may be a single subroutine reference or an
                   array reference of subroutine references.  These callbacks
                   will be called in the order they are given and passed a
                   hash containing the following keys:

                    ( message => $log_message, level => $log_level )

                   The callbacks are expected to modify the message and then
                   return a single scalar containing that modified message.
                   These callbacks will be called when either the "log" or
                   "log_to" methods are called and will only be applied to a
                   given message once.




perl v5.12.2                2011-02-23                          1





Log::Dispatch::User(Contributed Perl DocumeLog::Dispatch::Null(3)


       o   log_message( message => $ )

           Sends a message to the appropriate output.  Generally this
           shouldn't be called directly but should be called through the
           "log()" method (in Log::Dispatch::Output).

AUTHOR
       Dave Rolsky, <autarch@urth.org>

















































perl v5.12.2                2011-02-23                          2


