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
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.