Log::Dispatch::Screen

Section: User Contributed Perl Documentation (3)
Updated: 2021-01-27
Page Index

NAME

Log::Dispatch::Screen - Object for logging to the screen

VERSION

version 2.70

SYNOPSIS

  use Log::Dispatch;

  my $log = Log::Dispatch->new(
      outputs => [
          [
              'Screen',
              min_level => 'debug',
              stderr    => 1,
              newline   => 1
          ]
      ],
  );

  $log->alert("I'm searching the city for sci-fi wasabi");

DESCRIPTION

This module provides an object for logging to the screen (really "STDOUT" or "STDERR").

Note that a newline will not be added automatically at the end of a message by default. To do that, pass "newline => 1".

The handle will be autoflushed, but this module opens it's own handle to fd 1 or 2 instead of using the global "STDOUT" or "STDERR".

CONSTRUCTOR

The constructor takes the following parameters in addition to the standard parameters documented in Log::Dispatch::Output:

•

stderr (0 or 1)

Indicates whether or not logging information should go to "STDERR". If false, logging information is printed to "STDOUT" instead.

This defaults to true.

•

utf8 (0 or 1)

If this is true, then the output uses "binmode" to apply the ":encoding(UTF-8)" layer to the relevant handle for output. This will not affect "STDOUT" or "STDERR" in other parts of your code.

This defaults to false.

SUPPORT

Bugs may be submitted at <https://github.com/houseabsolute/Log-Dispatch/issues>.

I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".

SOURCE

The source code repository for Log-Dispatch can be found at <https://github.com/houseabsolute/Log-Dispatch>.

AUTHOR

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

The full text of the license can be found in the LICENSE file included with this distribution.