Log::Dispatch::Screen(3) Object for logging to the screen


version 2.56


use Log::Dispatch;
my $log = Log::Dispatch->new(
outputs => [
min_level => 'debug',
stderr => 1,
newline => 1
$log->alert("I'm searching the city for sci-fi wasabi");


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


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.


Bugs may be submitted through the RT bug tracker <http://rt.cpan.org/Public/Dist/Display.html?Name=Log-Dispatch> (or bug-log-dis[email protected] <mailto:[email protected]>).

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


Dave Rolsky <[email protected]>


This software is Copyright (c) 2016 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)