NAME

PerlIO::win32console - unicode console output on windows

SYNOPSIS

  binmode STDOUT, ":raw:win32console" if -t STDOUT;
  binmode STDERR, ":raw:win32console" if -t STDERR;

  # input not implemented
  binmode STDIN, ":raw:win32console" if -t STDIN;

  print "unicode characters\n";

  # apply :win32console to STDOUT/STDERR if they're console output
  use PerlIO::win32console "-installout";
  # apply :win32console to STDIN if it's a console
  use PerlIO::win32console "-installin";
  # apply :win32console to any of STDIN, STDOUT, STDERR if they're
  # consoles
  use PerlIO::win32console "-install";

-head1 DESCRIPTION

Implements UTF-8 output to the Win32 console, using the wide character console APIs.

You can load the module with -installout to automatically push this layer onto STDOUT/STDERR on Windows:

  use PerlIO::win32console "-installout";

but do nothing on non-Windows.

When this layer is pushed this module attempts to enable ANSI escapes for that console.

The PerlIO layer is only ever available on Windows.

Future possibilities:

• text input from the console

• non-text (mouse, resizes) input from the console

• handling ANSI escapes (Windows has an option do this itself)

AUTHOR

Tony Cook <tony@develop-help.com>

SEE ALSO

Win32::Console::ANSI