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.
56 nkf - Network Kanji Filter
62 nkf B<[-butjnesliohrTVvwWJESZxXFfmMBOcdILg]> B<[>I<file ...>B<]>
68 B<Nkf> is a yet another kanji code converter among networks, hosts and terminals.
69 It converts input kanji code to designated kanji code
70 such as ISO-2022-JP, Shift_JIS, EUC-JP, UTF-8 or UTF-16.
72 One of the most unique faculty of B<nkf> is the guess of the input kanji encodings.
73 It currently recognizes ISO-2022-JP, Shift_JIS, EUC-JP, UTF-8 and UTF-16.
74 So users needn't set the input kanji code explicitly.
76 By default, X0201 kana is converted into X0208 kana.
77 For X0201 kana, SO/SI, SSO and ESC-(-I methods are supported.
78 For automatic code detection, nkf assumes no X0201 kana in Shift_JIS.
79 To accept X0201 in Shift_JIS, use B<-X>, B<-x> or B<-S>.
87 Output is buffered (DEFAULT), Output is unbuffered.
89 =item B<-j -s -e -w -w16>
91 Output code is ISO-2022-JP (7bit JIS), Shift_JIS, EUC-JP,
93 Without this option and compile option, ISO-2022-JP is assumed.
95 =item B<-J -S -E -W -W16>
97 Input assumption is JIS 7 bit, Shift_JIS, EUC-JP,
109 Assume Shift_JIS and X0201 kana input.
110 EUC-JP is recognized as X0201 kana. Without B<-x> flag,
111 X0201 kana (halfwidth kana) is converted into X0208.
125 Specify the Esc Seq for JIS X 0208-1978/83. (DEFAULT B)
129 Specify the Esc Seq for ASCII/Roman. (DEFAULT B)
133 {de/en}crypt ROT13/47
135 =item B<-h[123] --hiragana --katakana --katakana-hiragana>
139 =item B<-h1 --hiragana>
141 Katakana to Hiragana conversion.
143 =item B<-h2 --katakana>
145 Hiragana to Katakana conversion.
147 =item B<-h3 --katakana-hiragana>
149 Katakana to Hiragana and Hiragana to Katakana conversion.
155 Text mode output (MS-DOS)
159 ISO8859-1 (Latin-1) support
161 =item B<-f[I<m> [- I<n>]]>
163 Folding on I<m> length with I<n> margin in a line.
164 Without this option, fold length is 60 and fold margin is 10.
168 New line preserving line folding.
172 Convert X0208 alphabet (Fullwidth Alphabets) to ASCII.
178 Convert X0208 alphabet to ASCII.
182 Convert X0208 kankaku to single ASCII space.
186 Convert X0208 kankaku to double ASCII spaces.
190 Replacing fullwidth >, <, ", & into '>', '<', '"', '&' as in HTML.
196 Assume X0201 kana in MS-Kanji.
197 With B<-X> or without this option, X0201 is converted into X0208 Kana.
198 With B<-x>, try to preserve X0208 kana and do not convert X0201 kana to X0208.
199 In JIS output, ESC-(-I is used. In EUC output, SSO is used.
203 Assume broken JIS-Kanji input, which lost ESC.
204 Useful when your site is using old B-News Nihongo patch.
210 allows any chars after ESC-( or ESC-$.
214 force ASCII after NL.
220 Replacing non iso-2022-jp char into a geta character
221 (substitute character in Japanese).
225 MIME ISO-2022-JP/ISO8859-1 decode. (DEFAULT)
226 To see ISO8859-1 (Latin-1) -l is necessary.
232 Decode MIME base64 encoded stream. Remove header or other part before
237 Decode MIME quoted stream. '_' in quoted stream is converted to space.
242 It allows line break in the middle of the base64 encoding.
252 MIME encode. Header style. All ASCII code and control characters are intact.
258 MIME encode Base64 stream.
259 Kanji conversion is performed before encoding, so this cannot be used as a picture encoder.
263 Perform quoted encoding.
269 Input and output code is ISO8859-1 (Latin-1) and ISO-2022-JP.
270 B<-s>, B<-e> and B<-x> are not compatible with this option.
272 =item B<-L[uwm] -d -c>
290 Without this option, nkf doesn't convert line breaks.
294 =item B<--fj --unix --mac --msdos --windows>
296 Convert for these systems.
298 =item B<--jis --euc --sjis --mime --base64>
300 Convert to named code.
302 =item B<--jis-input --euc-input --sjis-input --mime-input --base64-input>
306 =item B<--ic=I<input codeset> --oc=I<output codeset>>
308 Set the input or output codeset.
309 NKF supports following codesets and those codeset names are case insensitive.
315 a.k.a. RFC1468, 7bit JIS, JUNET
317 =item EUC-JP (eucJP-nkf)
319 a.k.a. AT&T JIS, Japanese EUC, UJIS
327 Microsoft Version of EUC-JP.
331 a.k.a. SJIS, MS-Kanji
349 =item UTF8-MAC (input only)
359 UTF-16 Big Endian without BOM
363 UTF-16 Big Endian with BOM
367 UTF-16 Little Endian without BOM
371 UTF-16 Little Endian with BOM
375 =item B<--fb-{skip, html, xml, perl, java, subchar}>
377 Specify the way that nkf handles unassigned characters.
378 Without this option, --fb-skip is assumed.
380 =item B<--prefix=I<escape character>I<target character>..>
382 When nkf converts to Shift_JIS,
383 nkf adds a specified escape character to specified 2nd byte of Shift_JIS characters.
384 1st byte of argument is the escape character and following bytes are target characters.
386 =item B<--no-cp932ext>
388 Handle the characters extended in CP932 as unassigned characters.
390 =item B<--no-best-fit-chars>
392 When Unicode to Encoded byte conversion,
393 don't convert characters which is not round trip safe.
394 When Unicode to Unicode conversion,
395 with this and -x option, nkf can be used as UTF converter.
396 (In other words, without this and -x option, nkf doesn't save some characters)
398 When nkf converts strings that related to path, you should use this opion.
402 Decode hex encoded characters.
406 Unescape percent escaped characters.
408 =item B<--numchar-input>
410 Decode character reference, such as "&#....;".
413 =item B<--in-place[=>I<SUFFIX>B<]> B<--overwrite[=>I<SUFFIX>B<]>
415 Overwrite B<original> listed files by filtered result.
417 B<Note> --overwrite preserves timestamps of original files.
421 Print guessed encoding.
434 Ignore rest of -option.
440 Copyright (C) 1987, FUJITSU LTD. (I.Ichikawa),2000 S. Kono, COW
441 Copyright (C) 2002-2007 Kono, Furukawa, Naruse, mastodon