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)