1 ## Copyright (C) 1996,1998
3 ## Ï¢ÍíÀ衧 ΰµåÂç³Ø¾ðÊó¹©³Ø²Ê ²ÏÌî ¿¿¼£ mime/X0208 support
4 ## ¡ÊE-Mail Address: kono@ie.u-ryukyu.ac.jp¡Ë
5 ## Ï¢ÍíÀ衧 COW for DOS & Win16 & Win32 & OS/2
6 ## ¡ÊE-Mail Address: GHG00637@niftyserve.or.p¡Ë
8 ## ¤³¤Î¥½¡¼¥¹¤Î¤¤¤«¤Ê¤ëÊ£¼Ì¡¤²þÊÑ¡¤½¤Àµ¤âµöÂú¤·¤Þ¤¹¡£¤¿¤À¤·¡¢
9 ## ¤½¤ÎºÝ¤Ë¤Ï¡¢Ã¯¤¬¹×¸¥¤·¤¿¤ò¼¨¤¹¤³¤ÎÉôʬ¤ò»Ä¤¹¤³¤È¡£
10 ## ºÆÇÛÉۤ仨»ï¤ÎÉÕÏ¿¤Ê¤É¤ÎÌ䤤¹ç¤ï¤»¤âɬÍפ¢¤ê¤Þ¤»¤ó¡£
11 ## ±ÄÍøÍøÍѤâ¾åµ¤ËÈ¿¤·¤Ê¤¤ÈϰϤǵö²Ä¤·¤Þ¤¹¡£
12 ## ¥Ð¥¤¥Ê¥ê¤ÎÇÛÉۤκݤˤÏversion message¤òÊݸ¤¹¤ë¤³¤È¤ò¾ò·ï¤È¤·¤Þ¤¹¡£
13 ## ¤³¤Î¥×¥í¥°¥é¥à¤Ë¤Ä¤¤¤Æ¤ÏÆä˲¿¤ÎÊݾڤ⤷¤Ê¤¤¡¢°¤·¤«¤é¤º¡£
15 ## Everyone is permitted to do anything on this program
16 ## including copying, modifying, improving,
17 ## as long as you don't try to pretend that you wrote it.
18 ## i.e., the above copyright notice has to appear in all copies.
19 ## Binar y distribution requires original version messages.
20 ## You don't have to ask before copying, redistribution or publishing.
21 ## THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE.
27 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK);
32 @ISA = qw(Exporter DynaLoader);
33 # Items to export into callers namespace by default. Note: do not export
34 # names by default without a very good reason. Use EXPORT_OK instead.
35 # Do not simply export all your public functions/methods/constants.
37 nkf nkf_continue inputcode
41 bootstrap NKF $VERSION;
43 # Preloaded methods go here.
45 # Autoload methods go after =cut, and are processed by the autosplit program.
51 # =begin ¤«¤é =begin COMMAND ¤Þ¤Ç¤Ï Perl/NKF ¤Î¥É¥¥å¥á¥ó¥È
52 # =begin COMMAND ¤«¤é =end ¤Þ¤Ç¤Ï nkf ¥³¥Þ¥ó¥É¤Î¥É¥¥å¥á¥ó¥È
59 NKF - Perl extension for Network Kanji Filter
63 nkf - Network Kanji Filter
72 $output = nkf("-s",$input);
76 nkf B<[-butjnesliohrTVvwWJESZxXFfmMBOcdILg]> B<[>I<file ...>B<]>
84 This is a Perl Extension version of nkf (Netowrk Kanji Filter).
85 It converts the last argument and return converted result. Conversion
86 details are specified by flags before the last argument.
90 B<Nkf> is a yet another kanji code converter among networks, hosts and terminals.
91 It converts input kanji code to designated kanji code
92 such as ISO-2022-JP, Shift_JIS, EUC-JP, UTF-8 or UTF-16.
94 One of the most unique faculty of B<nkf> is the guess of the input kanji encodings.
95 It currently recognizes ISO-2022-JP, Shift_JIS, EUC-JP, UTF-8 and UTF-16.
96 So users needn't set the input kanji code explicitly.
98 By default, X0201 kana is converted into X0208 kana.
99 For X0201 kana, SO/SI, SSO and ESC-(-I methods are supported.
100 For automatic code detection, nkf assumes no X0201 kana in Shift_JIS.
101 To accept X0201 in Shift_JIS, use B<-X>, B<-x> or B<-S>.
109 Output is buffered (DEFAULT), Output is unbuffered.
111 =item B<-j -s -e -w -w16>
113 Output code is ISO-2022-JP (7bit JIS), Shift_JIS, EUC-JP,
115 Without this option and compile option, ISO-2022-JP is assumed.
117 =item B<-J -S -E -W -W16>
119 Input assumption is JIS 7 bit, Shift_JIS, EUC-JP,
126 Assume JIS input. It also accepts EUC-JP.
127 This is the default. This flag does not exclude Shift_JIS.
131 Assume Shift_JIS and X0201 kana input. It also accepts JIS.
132 EUC-JP is recognized as X0201 kana. Without B<-x> flag,
133 X0201 kana (halfwidth kana) is converted into X0208.
137 Assume EUC-JP input. It also accepts JIS.
148 Specify the Esc Seq for JIS X 0208-1978/83. (DEFAULT B)
152 Specify the Esc Seq for ASCII/Roman. (DEFAULT B)
156 {de/en}crypt ROT13/47
158 =item B<-h[123] --hiragana --katakana --katakana-hiragana>
162 =item B<-h1 --hiragana>
164 Katakana to Hiragana conversion.
166 =item B<-h2 --katakana>
168 Hiragana to Katakana conversion.
170 =item B<-h3 --katakana-hiragana>
172 Katakana to Hiragana and Hiragana to Katakana conversion.
178 Text mode output (MS-DOS)
182 ISO8859-1 (Latin-1) support
184 =item B<-f[I<m> [- I<n>]]>
186 Folding on I<m> length with I<n> margin in a line.
187 Without this option, fold length is 60 and fold margin is 10.
191 New line preserving line folding.
195 Convert X0208 alphabet (Fullwidth Alphabets) to ASCII.
201 Convert X0208 alphabet to ASCII.
205 Converts X0208 kankaku to single ASCII space.
209 Converts X0208 kankaku to double ASCII spaces.
213 Replacing Fullwidth >, <, ", & into '>', '<', '"', '&' as in HTML.
219 Assume X0201 kana in MS-Kanji.
220 With B<-X> or without this option, X0201 is converted into X0208 Kana.
221 With B<-x>, try to preserve X0208 kana and do not convert X0201 kana to X0208.
222 In JIS output, ESC-(-I is used. In EUC output, SSO is used.
226 Assume broken JIS-Kanji input, which lost ESC.
227 Useful when your site is using old B-News Nihongo patch.
233 allows any char after ESC-( or ESC-$.
237 forces ASCII after NL.
243 Replacing non iso-2022-jp char into a geta character
244 (substitute character in Japanese).
248 MIME ISO-2022-JP/ISO8859-1 decode. (DEFAULT)
249 To see ISO8859-1 (Latin-1) -l is necessary.
255 Decode MIME base64 encoded stream. Remove header or other part before
260 Decode MIME quoted stream. '_' in quoted stream is converted to space.
265 It allows line break in the middle of the base64 encoding.
275 MIME encode. Header style. All ASCII code and control characters are intact.
281 MIME encode Base64 stream.
282 Kanji conversion is performed before encoding, so this cannot be used as a picture encoder.
286 Perfome quoted encoding.
292 Input and output code is ISO8859-1 (Latin-1) and ISO-2022-JP.
293 B<-s>, B<-e> and B<-x> are not compatible with this option.
295 =item B<-L[uwm] -d -c>
313 Without this option, nkf doesn't convert line breaks.
317 =item B<--fj --unix --mac --msdos --windows>
319 convert for these system
321 =item B<--jis --euc --sjis --mime --base64>
323 convert for named code
325 =item B<--jis-input --euc-input --sjis-input --mime-input --base64-input>
329 =item B<--ic=I<input codeset> --oc=I<output codeset>>
331 Set the input or output codeset.
332 NKF supports following codesets and those codeset name are case insensitive.
338 a.k.a. RFC1468, 7bit JIS, JUNET
340 =item EUC-JP (eucJP-nkf)
342 a.k.a. AT&T JIS, Japanese EUC, UJIS
350 Microsoft Version of EUC-JP.
354 a.k.a. SJIS, MS-Kanji
378 UTF-16 Big Endian without BOM
382 UTF-16 Big Endian with BOM
386 UTF-16 Little Endian without BOM
390 UTF-16 Little Endian with BOM
392 =item UTF8-MAC (input only)
396 =item B<--fb-{skip, html, xml, perl, java, subchar}>
398 Specify the way that nkf handles unassigned characters.
399 Without this option, --fb-skip is assumed.
401 =item B<--prefix=I<escape character>I<target character>..>
403 When nkf converts to Shift_JIS,
404 nkf adds a specified escape character to specified 2nd byte of Shift_JIS characters.
405 1st byte of argument is the escape character and following bytes are target characters.
407 =item B<--no-cp932ext>
409 Handle the characters extended in CP932 as unassigned characters.
411 =item B<--no-best-fit-chars>
413 When Unicode to Encoded byte conversion,
414 don't convert characters which is not round trip safe.
415 When Unicode to Unicode conversion,
416 with this and -x option, nkf can be used as UTF converter.
417 (In other words, without this and -x option, nkf doesn't save some characters)
419 When nkf convert string which related to path, you should use this opion.
423 Decode hex encoded characters.
427 Unescape percent escaped characters.
429 =item B<--numchar-input>
431 Decode character reference, such as "&#....;".
435 =item B<--in-place[=>I<SUFFIX>B<]> B<--overwrite[=>I<SUFFIX>B<]>
437 Overwrite B<original> listed files by filtered result.
439 B<Note> --overwrite preserves timestamp of original files.
443 Print guessed encoding.
457 Ignore rest of -option.
463 Copyright (C) 1987, FUJITSU LTD. (I.Ichikawa),2000 S. Kono, COW
464 Copyright (C) 2002-2006 Kono, Furukawa, Naruse, mastodon