Text::Kakasi::JP(3)   User Contributed Perl Documentation  Text::Kakasi::JP(3)


NAME
       Text::Kakasi::JP - Text::Kakasi AEuEU,iYEYYaYaYoYE

SYNOPSIS
         use Text::Kakasi;
         # functional
         $res = Text::Kakasi::getopt_argv('kakasi', '-ieuc', '-w');
         $str = Text::Kakasi::do_kakasi($japanese_text);
         # object-oriented
         $obj = Text::Kakasi->new('-ieuc','-w');
         $str = $obj->get($japanese_text);

DESCRIPTION
       EUYaY,Ya!1/4YexIkakasi (kanji kana simple
       inverter)xOxIYxYoY?!1/4YOY<section>!1/4Y^1
       xoAo<paragraph>!x.xThx^1!Lkakasix~Ao<paragraph>!x^1xexIxI!cinput
       methodxE<micro>O!cx^1xExixAx<<xE'A>>u
       xThx,xeE,xoxOxex~xE!cY<<Y?Y<<YE!cYi!1/4YTh>>uxExExE<micro>OEN'^1x^1xe<micro>!C1/2xCx^1!Lkakasi
       xIxThx?E,1/2nxIE~x<<xA1/2nxxExaIoINx^1xex^3xEx~xCxxThx^1!L3/4Ux.x-xI
       <http://kakasi.namazu.org/> xo,aeI/^21/4x<micro>xx!L

       Text::Kakasi
       xI!cAAAyAaxE'O?oYU!1/4Y^1xaxexOYaYOY,Y<section>Y-YE>>O,thxIADhEyxIYxYo
       Y?!1/4YOY<section>YxY^1xoAo<paragraph>!x.xThx^1!L'O?oYU!1/4Y^1xIEyxI
       ver. 1.05 xE 100% ,ss'^1xCx^1 x~!cPerl 5.8
       <degree>E^1ssxI?.<micro>!C1/2xo>>Ex|xExIYaYOY,Y<section>Y-YE>>O,thYxYoY?!1/4YOY<section>YxY^1xo
       >>Ex|E~Ixx~xcxexThx^1!L

Functional APIs
       Ai<degree>O:<degree>E^21/4xIAaIAxCxI "Text::Kakasi::"
       xI3/4EI~x.xAExxxThx^1!LYCYOY(C)YeYExCxI Text::Kakasi xI^2?xa export
       x.xThx>>xo!L<degree>E^21/4xI'O?oxo import x^1xexExI!cIa
       x"xDh<degree>E^21/4xIxex|xEx.xThx^1!L

         use Text::Kakasi qw/getopt_argv do_kakasi/;

       $err = getopt_argv($arg1, $arg2, ...)
           kakasixo1/2e'u^21/2x.xThx^1!L<degree>u?oxIkakasixIYaYxY.YcYoxEAE+-AuxCx^1!L<degree>E^21/4xI
           kakasi 2.3.4 xExax+-xeYaYxY.YcYoxI^3<micro>IxxCx^1!L

             -a[jE] -j[aE] -g[ajE] -k[ajKH]
             -E[aj] -K[ajkH] -H[ajkK] -J[ajkKH]
             -i{oldjis,newjis,dec,euc,sjis}
              -o{oldjis,newjis,dec,euc,sjis}
             -r{hepburn,kunrei} -p -s -f -c"chars"
              [jisyo1, jisyo2,,,]

             Character Sets:
                  a: ascii  j: jisroman  g: graphic  k: kana
                  (j,k     defined in jisx0201)
                  E: kigou  K: katakana  H: hiragana J: kanji
                  (E,K,H,J defined in jisx0208)

             Options:
               -i: input coding system    -o: output coding system
               -r: romaji conversion system
               -p: list all readings (with -J option)
               -s: insert separate characters (with -J option)
               -f: furigana mode (with -J option)
               -c: skip chars within jukugo
                   (with -J option: default TAB CR LF BLANK)
               -C: romaji Capitalize (with -Ja or -Jj option)
               -U: romaji Upcase     (with -Ja or -Jj option)
               -u: call fflush() after 1 character output
               -w: wakatigaki mode

           EU'O?oxI!cA(R),u>>thxE0xo!c1/4oCO>>thxExIx1/2xi<degree>E^3<degree>xIAIxoEOx.xThx^1!L

       $processed_str = do_kakasi($str)
           $strxEADhx.xAEkakasixo1/4A^1Ox.!c.e^2IxoEOx.xThx^1!L^2?xex<<xIIaAex~E-A,x.x?
           3/4i^1c!c"undef"xoEOx.xThx^1!L

           Ver. 1.x
           xE<degree>UxExe!c<degree>u?oxIoC1/2exE"kakasi"xoxAx+-xeE~IxxIxcxexThx>>xo!LxaxA
           xixooLxThxCxExaxexAx+-xAExa^11/2xxxThx>>xo!L

       close_kanwadic()
           <degree>A1/4"AaxEopenx<micro>xix?1/41/2nYOY!YxYexoclosex.xThx^1!LEU'O?oxI^2a<micro>ixI,ss'^1AxIxss
           xIx?xaxEA,ossx.!c,1/2ossxCxIIoINx^1xeE~IxxIxThxoxExxxCx.xcx|!L

Object-Oriented APIs
       Version 2.0
       xexe!cEUYaY,Ya!1/4YexIYaYOY,Y<section>Y-YE>>O,th(OOP)xIAPIxaAo<paragraph>!x.xThx^1!L

       $k = Text::Kakasi->new($args ...)
           YaYOY,Y<section>Y-YExoA,A(R)x.xThx^1!L<degree>u?ox~A,ossx^1xe3/4i^1cxI!c
           "Text::Kakasi->new->set($args ...)"
           x.x?xIxEAE+-x,.e^2IxExExexThx^1!L

       $k->set($args ...)
           "getopt_argv" xOxIOOPYxYoY?!1/4YOY<section>YxY^1!L

             my $k = Text::Kakasi->new;
             $k->set('-w'); # Text::Kakasi::getopt_argv('-w');

           Y^1YAE!1/4Y?Y^1xoEOx^1 getopt_argv() xExI<degree>UxExe!c "set"
           xI3/4ixEYaYOY,Y<section>Y-
           YE1/4<<?ExoEOx^1xIxC!c<degree>E^21/4xIxex|xEE1/2<micro>x~^2AC1/2xCx^1!L

             my $tokenized = $k->set('-w')->get($raw_japanese);

           Y^1YAE!1/4Y?Y^1x~Issx.xx3/4i^1cxExI!c "$k->error" xo>>ExxxThx^1!L

       $k->error
           oC,axE,AExDhxix?YaY1/2YAYExIY^1YAE!1/4Y?Y^1xoEOx.xThx^1!L

       $processed = $k->get($raw_japanese);
           "do_kakasi"
           xOxIOOPYxYoY?!1/4YOY<section>YxY^1!L<degree>E^21/4xIAEoxAxIY^3!1/4YExIAu^2AxCx^1!L

             # Functional
             getopt_argv('-w'); $processed = do_kakasi($raw_japanese);
             # OOP
             $k->set('-w')->get($raw_japanese);

Perl 5.8 Features
       Perl 5.8
       xC!cE,>>uY^3!1/4YEEN'^1xIE,1/2aAaxEIEAExssx~EncodeYaY,Ya!1/4YexExexA
       xAEAo<paragraph>!x<micro>xixThx.x?!LEUYaY,Ya!1/4YexI perl 5.8
       <degree>E^1ssxExAEx^3xI<micro>!C1/2xoIoINx^1xexe x|xExExAxAExxxThx^1!L

       "$k->set($args ...)"xOxI<degree>u?oxE!c"-iencoding" xaxexO
       "-oencoding"!!x~'ThxThxixe3/4i^1c!cE,>>uY^3!1/4YEEN'^1xIEncodex~^1OxxxThx^1!L
       <degree>u?oxExIkakasix~Y<micro>YY!1/4YEx.xAExxxexaxI<degree>E^3<degree>xExa!cEncodex~Y<micro>YY!1/4YEx.xAE
       xxxexaxIxIA'xAE>>Ex"xThx^1!L Iax"xDh!c

         $result = $k->set(qw/-iutf8 -outf8 -w/)->get($utf8);

       xI<degree>E^21/4xExUxUAE+-<micro>AxCx^1!L

         $euc = encode('eucjp' => $utf8);
         getopt_argv('-w');
         $tmp = do_kakasi($euc);
         $result = decode('eucjp' => $tmp);

       "-outf8",x~'ThxThxixAExxxe3/4i^1cxI!c "$k->get"
       xIutf8YOYeY<degree>EOxxIE,>>u IoxoEOx.xThx^1!L

       x^3xixexI<micro>!C1/2xI!c
       $Text::Kakasi::HAS_ENCODExE0xoAssAex^1xex^3xExCIoINx.
       xExxxex|xEx^1xex^3xExa^2AC1/2xCx^1!LAI3/4iEN?oxI!cEUYaY,Ya!1/4Yexousex.x?oYxE1/4<<
       AE<degree>AaxEAssAex<micro>xixThx^1!L

SEE ALSO
       kakasi(1), <http://kakasi.namazu.org/>,Encode,perlunicode

COPYRIGHT
         (C) 1998, 1999, 2000 NOKUBI Takatsugu <knok@daionet.gr.jp>
         (C) 2003 Dan Kogai <dankogai@dan.co.jp>

       There is no warranty for this free software. Anyone can modify and/or
       redistribute this module under GNU GENERAL PUBLIC LICENSE. See COPYING
       file that is included in the archive for more details.

POD ERRORS
       Hey! The above document had some coding errors, which are explained
       below:

       Around line 7:
           Non-ASCII character seen before =encoding in 'AEuEU,iYEYYaYaYoYE'.
           Assuming CP1252

perl v5.38.0                      2023-07-26               Text::Kakasi::JP(3)