Tatsuhiko Miyagawa > Path-Class-URI-0.04 > Path::Class::Unicode

Download:
Path-Class-URI-0.04.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Module Version: 0.04   Source  

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.

SEE ALSO ^

syntax highlighting: