---
name: "Log::Handler::Output::Screen"
section: "3pm"
platform: "linux"
package: "liblog-handler-perl"
version: "0.90-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Log::Handler::Output::Screen"
---

# Log::Handler::Output::Screen(3pm)

Log messages to the screen.

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