Debian Codegraph @

upstream/debian-unstable/man3/Encode::CN.3perl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "Encode::CN 3perl"
58 .TH Encode::CN 3perl 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 Encode::CN \- China\-based Chinese Encodings
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 .Vb 3
68 \& use Encode qw/encode decode/;
69 \& $euc_cn = encode("euc\-cn", $utf8); # loads Encode::CN implicitly
70 \& $utf8 = decode("euc\-cn", $euc_cn); # ditto
71 .Ve
72 .SH DESCRIPTION
73 .IX Header "DESCRIPTION"
74 This module implements China-based Chinese charset encodings.
75 Encodings supported are as follows.
76 .PP
77 .Vb 10
78 \& Canonical Alias Description
79 \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
80 \& euc\-cn /\ebeuc.*cn$/i EUC (Extended Unix Character)
81 \& /\ebcn.*euc$/i
82 \& /\ebGB[\-_ ]?2312(?:\eD.*$|$)/i (see below)
83 \& gb2312\-raw The raw (low\-bit) GB2312 character map
84 \& gb12345\-raw Traditional chinese counterpart to
85 \& GB2312 (raw)
86 \& iso\-ir\-165 GB2312 + GB6345 + GB8565 + additions
87 \& MacChineseSimp GB2312 + Apple Additions
88 \& cp936 Code Page 936, also known as GBK
89 \& (Extended GuoBiao)
90 \& hz 7\-bit escaped GB2312 encoding
91 \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
92 .Ve
93 .PP
94 To find how to use this module in detail, see Encode.
95 .SH NOTES
96 .IX Header "NOTES"
97 Due to size concerns, \f(CW\*(C`GB 18030\*(C'\fR (an extension to \f(CW\*(C`GBK\*(C'\fR) is distributed
98 separately on CPAN, under the name Encode::HanExtra. That module
99 also contains extra Taiwan-based encodings.
100 .SH BUGS
101 .IX Header "BUGS"
102 When you see \f(CW\*(C`charset=gb2312\*(C'\fR on mails and web pages, they really
103 mean \f(CW\*(C`euc\-cn\*(C'\fR encodings. To fix that, \f(CW\*(C`gb2312\*(C'\fR is aliased to \f(CW\*(C`euc\-cn\*(C'\fR.
104 Use \f(CW\*(C`gb2312\-raw\*(C'\fR when you really mean it.
105 .PP
106 The ASCII region (0x00\-0x7f) is preserved for all encodings, even though
107 this conflicts with mappings by the Unicode Consortium.
108 .SH "SEE ALSO"
109 .IX Header "SEE ALSO"
110 Encode