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¶

Copyright (C) 2007-2009 by Jonny Schulz. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.