NAME

       RkBgnBun, RkwBgnBun - convert the reading of a specified length to kanji

SYNOPSIS

       #include <canna/RK.h>
       int RkBgnBun(cxnum, yomi, maxyomi, mode)
       int cxnum;
       unsigned char *yomi;
       int maxyomi;
       int mode;
       int RkwBgnBun(cxnum, yomi, maxyomi, mode)
       int cxnum;
       wchar_t *yomi;
       int maxyomi;
       int mode;

DESCRIPTION

       RkBgnBun  converts  the  reading  yomi with a length of maxyomi bytes to kanji.  The reading kana must be
       adjusted on character boundaries in the EUC code.  The context enters the conversion mode, with both  the
       current clause and the current clause set to 0.

       RkwBgnBun is the similar function to RkBgnBun, but it takes wchar_t argument as yomi.  maxyomi represents
       the length of yomi by characters instead  of bytes.

       mode represents the code conversion candidate to be added to each clause.  It is expressed in a bit field
       width, which can be set to one of the following with RK_XFERBITS:

              RK_XFER             Hiragana

              RK_HFER             Single-width character

              RK_KFER             Katakana

              RK_ZFER             Double-width character

       If  the  number  of  candidates  available for the current clause is N, candidates are added through code
       conversion by reading the candidates in sequence, from candidate N  to  candidate  N  +  1,  and  so  on,
       starting  with  the  lowest-order  bit  field.   Candidate addition ends when the corresponding bit field
       equals 0.

              mode                        Candidate
              RK_XFER                     (KANJI) (HIRAGANA)
              (RK_XFER << RK_XFERBITS) | RK_KFER(KANJI) (KATAKANA) (HIRAGANA)
              (RK_KFER << RK_XFERBITS) | RK_XFER(KANJI) (HIRAGANA) (KATAKANA)

       The context enters the conversion mode, from RkBgnBun to RkEndBun(3).  Conversion modes cannot be nested.

RETURN VALUE

       This function returns the number of clauses derived from conversion, or  returns  -1  if  the  conversion
       fails.

SEE ALSO

       RkEndBun(3)

                                                                                                     RKBGNBUN(3)