NAME

Log::Handler::Output::Screen - Log messages to the screen.

SYNOPSIS

    use Log::Handler::Output::Screen;
    my $screen = Log::Handler::Output::Screen->new(
        log_to => "STDERR",
        dump   => 1,
    );
    $screen->log($message);

DESCRIPTION

This output module makes it possible to log messages to your screen.

METHODS

new()

Call new() to create a new Log::Handler::Output::Screen object.

The following options are possible:

log_to

Where do you want to log? Possible is: STDOUT, STDERR and WARN.

WARN means to call warn().

The default is STDOUT.

dump

Set this option to 1 if you want that the message will be dumped with "Data::Dumper" to the screen.

utf8, utf-8

Set utf8 or utf-8 on STDOUT or STDERR. It depends on the parameter log_to.

    utf8   =  binmode, $fh, ":utf8";
    utf-8  =  binmode, $fh, "encoding(utf-8)";

Yes, there is a difference.

<http://perldoc.perl.org/perldiag.html#Malformed-UTF-8-character-(%25s)>

<http://perldoc.perl.org/Encode.html#UTF-8-vs.-utf8-vs.-UTF8>

log()

Call log() if you want to log a message to the screen.

Example:

    $screen->log("this message goes to the screen");

validate()

Validate a configuration.

reload()

Reload with a new configuration.

errstr()

This function returns the last error message.

PREREQUISITES

    Data::Dumper
    Params::Validate

EXPORTS

No exports.

REPORT BUGS

Please report all bugs to <jschulz.cpan(at)bloonix.de>.

If you send me a mail then add Log::Handler into the subject.

AUTHOR

Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.