NAME

Path::Class::Unicode - Maps Unicode filenames to local encoding and code pages

SYNOPSIS

  use Path::Class::Unicode;

  # Use ufile() to create Unicode objects
  my $fn   = "\x{55ed}.txt";
  my $file = ufile("path", $fn);

  my $fh = $file->open;

  my $fn   = "\x{55ed}.txt";
  my $file = ufile("/path", $fn);
  my $uri  = $file->uri;  # file:///path/%E5%97%AD.txt (always utf-8)

  my $fh   = ufile_from_uri($uri)->open;

DESCRIPTION

Path::Class::Unicode is a Path::Class extension to handle Unicode file names by mapping them to local encodings when stringified. It maps to UTF-8 for all UNIX systems including Mac OS X and uses Windows code page (like cp932 for Japanese) in Win32 systems.

It's very useful if you store file paths using URI representation like <file://> and uses URI escaped UTF-8 characters for non-ASCII characters. See Path::Class::URI for details.

TODO

It would be nice if we could proxy filehandles using Win32API::File.

AUTHOR

Tatsuhiko Miyagawa <miyagawa@cpan.org>

mattn

LICENSE