This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Time-HiRes uses PERL compare macro
[perl5.git] / README.jp
... / ...
CommitLineData
1=encoding utf8
2
3=head1 NAME
4
5perljp - 日本語 Perl ガイド
6
7=head1 説明
8
9Perl の世界へようこそ!
10
11Perl 5.8.0 より、Unicodeサポートが大幅に強化され、その結果ラテン文字以外の文字コードのサポートが CJK (中国語、日本語、ハングル)を含めて加わりました。Unicodeは世界中の文字を一つの文字コードで扱うことを目指した標準規格であり、東から西、はたまたその間の文字(ギリシャ文字、キリール文字、アラビア文字、ヘブライ文字、ディーヴァナガーリ文字、などなど)や、これまではOSベンダーが独自に定めていた文字(PCおよびMacintosh)がすでに含まれています。
12
13Perl 自身は Unicode で動作します。Perl スクリプト内の文字列リテラルや正規表現は Unicode を前提としています。そして入出力のためには、これまで使われてきたさまざまな文字コードに対応するモジュール、「 Encode 」が標準装備されており、Unicode とこれらの文字コードの相互変換も簡単に行えるようになっています。
14
15現時点で Encode がサポートする文字コードは以下のとおりです。
16
17 7bit-jis AdobeStandardEncoding AdobeSymbol AdobeZdingbat
18 ascii big5 big5-hkscs cp1006
19 cp1026 cp1047 cp1250 cp1251
20 cp1252 cp1253 cp1254 cp1255
21 cp1256 cp1257 cp1258 cp37
22 cp424 cp437 cp500 cp737
23 cp775 cp850 cp852 cp855
24 cp856 cp857 cp860 cp861
25 cp862 cp863 cp864 cp865
26 cp866 cp869 cp874 cp875
27 cp932 cp936 cp949 cp950
28 dingbats euc-cn euc-jp euc-kr
29 gb12345-raw gb2312-raw gsm0338 hp-roman8
30 hz iso-2022-jp iso-2022-jp-1 iso-8859-1
31 iso-8859-10 iso-8859-11 iso-8859-13 iso-8859-14
32 iso-8859-15 iso-8859-16 iso-8859-2 iso-8859-3
33 iso-8859-4 iso-8859-5 iso-8859-6 iso-8859-7
34 iso-8859-8 iso-8859-9 iso-ir-165 jis0201-raw
35 jis0208-raw jis0212-raw johab koi8-f
36 koi8-r koi8-u ksc5601-raw MacArabic
37 MacCentralEurRoman MacChineseSimp MacChineseTrad MacCroatian
38 MacCyrillic MacDingbats MacFarsi MacGreek
39 MacHebrew MacIcelandic MacJapanese MacKorean
40 MacRoman MacRomanian MacRumanian MacSami
41 MacSymbol MacThai MacTurkish MacUkrainian
42 nextstep posix-bc shiftjis symbol
43 UCS-2BE UCS-2LE UTF-16 UTF-16BE
44 UTF-16LE UTF-32 UTF-32BE UTF-32LE
45 utf8 viscii
46
47(全114種類)
48
49例えば、文字コードFOOのファイルをUTF-8に変換するには、以下のようにします。
50
51 perl -Mencoding=FOO,STDOUT,utf8 -pe1 < file.FOO > file.utf8
52
53また、Perlには、全部がPerlで書かれた文字コード変換ユーティリティ、piconvも付属しているので、以下のようにすることもできます。
54
55 piconv -f FOO -t utf8 < file.FOO > file.utf8
56 piconv -f utf8 -t FOO < file.utf8 > file.FOO
57
58=head2 (jcode.pl|Jcode.pm|JPerl) からの移行
59
605.8以前の、スクリプトがEUC-JPであればリテラルだけは扱うことができました。また、入出力を扱うモジュールとしてはJcode.pmが( L<http://openlab.ring.gr.jp/Jcode/> )、perl4用のユーティリティとしてはjcode.plがそれぞれ存在し、日本語の扱えるCGIでよく利用されていることを御存じの方も少なくないかと思われます。ただし、日本語による正規表現をうまく扱うことは不可能でした。
61
625.005以前のPerlには、日本語に特化したローカライズ版、Jperlが存在しました( L<http://homepage2.nifty.com/kipp/perl/jperl/index.html> ※1)。また、Mac OS 9.x/Classic用のPerl、MacPerlの日本語版もMacJPerlとして存在してました。( L<https://habilis.net/macjperl/> ).これらでは文字コードとしてEUC-JPに加えShift_JISもそのまま扱うことができ、また日本語による正規表現を扱うことも可能でした。
63
64Perl5.8では、これらの機能がすべてPerl本体だけで実現できる上に、日本語のみならず上記114の文字コードをすべて、しかも同時に扱うことができます。さらに、CPANなどから新しい文字コード用のモジュールを入手することも簡単にできるようになっています。
65
66※1: ホスティングサービスの終了により現在は閲覧できません。 Vector( L<https://www.vector.co.jp/soft/win95/util/se098198.html> )からWindow用のバイナリを、CPAN( L<https://www.cpan.org/src/unsupported/4.036/jperl/> )からperl4用のパッチを入手することができます。
67
68=over 4
69
70=item *
71
72入出力
73
74以下の例はいずれもShift_JISの入力をEUC-JPに変換して出力します。
75
76 # jcode.pl
77 require "jcode.pl";
78 while(<>){
79 jcode::convert(*_, 'euc', 'sjis');
80 print;
81 }
82 # Jcode.pm
83 use Jcode;
84 while(<>){
85 print Jcode->new($_, 'sjis')->euc;
86 }
87 # Perl 5.8
88 use Encode;
89 while(<>){
90 from_to($_, 'shiftjis', 'euc-jp');
91 print;
92 }
93 # Perl 5.8 - encoding を利用して
94 use encoding 'euc-jp', STDIN => 'shiftjis';
95 while(<>){
96 print;
97 }
98
99=item *
100
101Jperl 互換スクリプト
102
103いわゆる"shebang"を変更するだけで、Jperl用のscriptのほとんどは変更なしに利用可能だと思われます。
104
105 #!/path/to/jperl
106
107 #!/path/to/perl -Mencoding=euc-jp
108
109詳しくは perldoc encoding を参照してください。
110
111=back
112
113=head2 さらに詳しく
114
115Perlには膨大な資料が付属しており、Perlの新機能やUnicodeサポート、そしてEncodeモジュールの使用法などが細かく網羅されています(残念ながら、ほとんど英語ではありますが)。以下のコマンドでそれらの一部を閲覧することが可能です。
116
117 perldoc perlunicode # PerlのUnicodeサポート全般
118 perldoc Encode # Encodeモジュールに関して
119 perldoc Encode::JP # うち日本語文字コードに関して
120
121=head2 Perl全般に関する URL
122
123=over 4
124
125=item L<https://www.perl.org/>
126
127Perl ホームページ
128
129=item L<https://www.perl.com/>
130
131Perl 財団が営業する文章作品集
132
133=item L<https://www.cpan.org/>
134
135CPAN (Comprehensive Perl Archive Network)
136
137=item L<https://metacpan.org/>
138
139MetaCPAN CPANの検索エンジン
140
141=item L<https://lists.perl.org/>
142
143Perl メーリングリスト集
144
145=item L<https://perldoc.jp/>
146
147perldoc.jp Perl の公式ドキュメント、モジュールドキュメントの日本語訳
148
149=back
150
151=head2 Perlの修得に役立つ URL
152
153=over 4
154
155=item L<http://www.oreilly.com.tw/>
156
157O'Reilly 社のPerl関連書籍(繁体字中国語)
158
159=item L<http://www.oreilly.com.cn/>
160
161O'Reilly 社のPerl関連書籍(簡体字中国語)
162
163=item L<https://www.oreilly.co.jp/catalog/>
164
165オライリー社のPerl関連書籍(日本語)
166
167=back
168
169=head2 Perl に関する団体
170
171=over 4
172
173=item L<https://www.pm.org/groups/asia.html>
174
175アジア地域の Perl Mongers (Perlのユーザーグループ) 一覧
176
177=item L<https://japan.perlassociation.org>
178
179一般社団法人Japan Perl Association (JPA) Perl技術及び文化の啓蒙・促進のための組織
180
181=back
182
183=head2 Unicode関連のURL
184
185=over 4
186
187=item L<https://www.unicode.org/>
188
189Unicode コンソーシアム (Unicode規格の選定団体)
190
191=item L<https://www.cl.cam.ac.uk/%7Emgk25/unicode.html>
192
193UTF-8 and Unicode FAQ for Unix/Linux
194
195=item L<https://wiki.kldp.org/Translations/html/UTF8-Unicode-KLDP/UTF8-Unicode-KLDP.html>
196
197UTF-8 and Unicode FAQ for Unix/Linux (ハングル訳)
198
199=back
200
201=head1 AUTHORS
202
203=over
204
205=item * Jarkko Hietaniemi E<lt>jhi@iki.fiE<gt>
206
207=item * Dan Kogai (小飼 弾) E<lt>dankogai@dan.co.jpE<gt>
208
209=item * Shogo Ichinose (一野瀬 翔吾) E<lt>shogo82148@gmail.comE<gt>
210
211=back
212
213=cut