RKBGNBUN(3)

💖 RKBGNBUN — bestie, it's giving "kanji conversion time" ✨

okay so this one is from the Library Functions Manual, page RKBGNBUN(3), and we're about to convert readings into kanji. buckle up 🎀

---

🌸 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 takes your reading yomi — that's maxyomi bytes long, bestie — and turns it into kanji. no cap. 🫶

⚠️ tiny little detail that will absolutely wreck your day if you ignore it: the reading kana must be adjusted on character boundaries in the EUC code. so like, don't slice it mid-character. that's the vibe check. 💀

when it runs, the context enters the conversion mode, and both the current clause and the current clause set get set to 0. iconic.

RkwBgnBun is the sibling function — same energy, but it takes a wchar_t argument as yomi instead. and for this one, maxyomi represents the length of yomi by characters instead of bytes. character girlies, this one's for you 🧚

---

🎀 the mode thing 🎀

mode represents the code conversion candidate to be added to each clause. it's expressed in a bit field width, and you can set it to one of these with RK_XFERBITS:

• RK_XFER — Hiragana
• RK_HFER — Single-width character
• RK_KFER — Katakana
• RK_ZFER — Double-width character

---

🌈 how candidates get added (the lore) 🌈

so if the number of candidates available for the current clause is N, candidates get 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. that's the periodt. 🙈

the mapping is literally this:

• RK_XFER → Candidate: (KANJI) (HIRAGANA)
• (RK_XFER << RK_XFERBITS) | RK_KFER → Candidate: (KANJI) (KATAKANA) (HIRAGANA)
• (RK_KFER << RK_XFERBITS) | RK_XFER → Candidate: (KANJI) (HIRAGANA) (KATAKANA)

---

👑 one more thing, fr fr 👑

the context enters the conversion mode, and it stays in it from RkBgnBun all the way to RkEndBun(3). 🎀

🚨 conversion modes cannot be nested. not a suggestion. not a vibe. it's a rule, and the nesting will simply not happen. 💅

---

⭐ RETURN VALUE ⭐

this function returns the number of clauses derived from conversion 🥳 … or it returns -1 if the conversion fails. and yeah, -1 is the "we don't talk about it" number. 😭

---

💜 SEE ALSO 💜

• RkEndBun(3)

---

that's the whole page, bestie — no notes, you ate 💅✨

anyway, this was RKBGNBUN(3) from the Library Functions Manual, and the page footer just says RKBGNBUN(3) right back at you 🦋 (no date, no version — the manual keeps it mysterious, and honestly? main character energy 👑). mwah, go convert something 🎀💖