Log::Dispatch::Handle(3pm) - phpMan

Log::Dispatch::Handle(3pm)     User Contributed Perl Documentation     Log::Dispatch::Handle(3pm)



NAME
       Log::Dispatch::Handle - Object for logging to IO::Handle objects (and subclasses thereof)

SYNOPSIS
         use Log::Dispatch::Handle;

         my $handle = Log::Dispatch::Handle->new( name      => 'a handle',
                                                  min_level => 'emerg',
                                                  handle    => $io_socket_object );

         $handle->log( level => 'emerg', message => 'I am the Lizard King!' );

DESCRIPTION
       This module supplies a very simple object for logging to some sort of handle object.
       Basically, anything that implements a "print()" method can be passed the object construc-
       tor and it should work.

METHODS
       * new(%p)
           This method takes a hash of parameters.  The following options are valid:

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

           * min_level ($)
                   The minimum logging level this object will accept.  See the Log::Dispatch doc-
                   umentation on Log Levels for more information.  Required.

           * max_level ($)
                   The maximum logging level this obejct will accept.  See the Log::Dispatch doc-
                   umentation 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).

           * handle ($)
                   The handle object.  This object must implement a "print()" method.

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

       * 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 AT urth.org>



perl v5.8.8                                 2007-11-01                 Log::Dispatch::Handle(3pm)

Generated by $Id: phpMan.php,v 4.49 2006/02/26 13:18:18 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2012-05-24 15:46 @38.107.179.237 Crawled by CCBot/1.0 (+http://www.commoncrawl.org/bot.html)