/ 
Encode-UTF8Mac-0.02
⭐ Starred 6 / Encode::UTF8Mac

NAME

Encode::UTF8Mac - "utf-8-mac" encoding, a variant utf-8 used by Mac OSX

SYNOPSIS

use Encode;
use Encode::UTF8Mac;

my $filename = Encode::encode('utf-8-mac', "\x{3054}\x{FA19}\x{4F53}");
# => \xE3\x81\x93\xE3\x82\x99\xEF\xA8\x99\xE4\xBD\x93
# note:
# Unicode utf-8(hex)    NFD()            MacOS
# U+3054  \xE3\x81\x94  U+3053 + U+3099  decompose
# U+3053  \xE3\x81\x93  (no-op)
# U+3099  \xE3\x82\x99  (no-op)
# U+FA19  \xEF\xA8\x99  U+795E           not decompose
# U+4F53  \xE4\xBD\x93  (no-op)

$filename = Encode::decode('utf-8-mac', $filename);
# => \x{3054}\x{FA19}\x{4F53}

DESCRIPTION

Encode::UTF8Mac provides a encoding called "utf-8-mac" used in Mac OSX.

On Mac OSX, utf-8 encoding is used and it is normalized form D (characters are decomposed). However, not follow the exact specification.

http://developer.apple.com/library/mac/#qa/qa2001/qa1173.html

Specifically, the following ranges are not decomposed.

U+2000-U+2FFF
U+F900-U+FAFF
U+2F800-U+2FAFF

In iconv (bundled Mac), this encoding can be using as "utf-8-mac".

This module adds "utf-8-mac" encoding for Encode, it encode/decode text with that rule in mind. This will help when you decode file name on Mac.

ENCODING

utf-8-mac

  • Encode::decode('utf-8-mac', $bytes)

    Decode as utf-8, and normalize form C except special range using Unicode::Normalize.

  • Encode::encode('utf-8-mac', $unicode)

    Normalize form D except special range using Unicode::Normalize, and encode as utf-8.

SEE ALSO

Encode, Encode::Locale, Unicode::Normalize

AUTHOR

Naoki Tomita <tomita@cpan.org>

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.