1Unicode::EastAsianWidthU(s3e)r Contributed Perl DocumentaUtniiocnode::EastAsianWidth(3)
2
3
4
6 Unicode::EastAsianWidth - East Asian Width properties
7
9 use Unicode::EastAsianWidth;
10
11 $_ = chr(0x2010); # HYPHEN, an ambiguous-width character
12
13 /\p{InEastAsianAmbiguous}/; # True
14 /\p{InFullwidth}/; # False
15
16 To mark ambiguous-width characters as InFullwidth:
17
18 BEGIN { $Unicode::EastAsianWidth::EastAsian = 1; }
19 use Unicode::EastAsianWidth;
20
21 $_ = chr(0x2010); # HYPHEN, an ambiguous-width character
22 /\p{InFullwidth}/; # True
23
25 This module provide user-defined Unicode properties that deal with
26 width status of East Asian characters, as specified in
27 <http://www.unicode.org/unicode/reports/tr11/>.
28
29 It exports the following functions to the caller's scope, to be used by
30 Perl's Unicode matching system: "InEastAsianFullwidth",
31 "InEastAsianHalfwidth", "InEastAsianAmbiguous", "InEastAsianNarrow"
32 "InEastAsianWide", "InEastAsianNeutral".
33
34 In accord to TR11 cited above, two additional context-sensitive
35 properties are exported: "InFullwidth" (union of "Fullwidth" and
36 "Wide") and "InHalfwidth" (union of "Halfwidth", "Narrow" and
37 "Neutral").
38
39 Ambiguous characters are treated by default as part of "InHalfwidth",
40 but you can modify this behaviour by assigning a true value to
41 $Unicode::EastAsianWidth::EastAsian at compile time within a "BEGIN"
42 block before loading this module:
43
44 BEGIN { $Unicode::EastAsianWidth::EastAsian = 1; }
45 use Unicode::EastAsianWidth;
46
47 Setting $Unicode::EastAsianWidth::EastAsian at run-time used to work on
48 Perl versions between 5.8 and 5.14 due to an implementation detail, but
49 it will no longer work on Perl 5.16 and later versions, and hence is
50 not recommended.
51
53 perlunicode, <http://www.unicode.org/unicode/reports/tr11/>
54
56 Audrey Tang <cpan@audreyt.org>
57
59 This work is under the CC0 1.0 Universal license.
60
61 To the extent possible under law, 唐鳳 has waived all copyright and
62 related or neighboring rights to Unicode-EastAsianWidth.
63
64 This work is published from Taiwan.
65
66 <http://creativecommons.org/publicdomain/zero/1.0>
67
68
69
70perl v5.30.1 2020-01-30 Unicode::EastAsianWidth(3)