RKGETDICLIST(3)

✨ NAME ✨

RkGetDicList — bestie, this one grabs you the name of a dictionary that can be added to the dictionary list 💅

🌸 SYNOPSIS 🌸

#include <canna/RK.h>
int RkGetDicList(cxnum, dics, maxdics)
int cxnum;
char *dics;
int maxdics;

🦋 DESCRIPTION 🦋

okay so, RkGetDicList gets the name of a dictionary that can be added to the dictionary list. that's the whole vibe. 🎀

Multiple dictionaries can be used simultaneously during kana-kanji conversion — yes, plural, she's multitasking, main character energy fr fr 👑. The simultaneously available dictionaries are chained to the dictionary list in the conversion context. The dictionary named at the beginning of the dictionary list gets referenced first of all, and candidates generated from it are also treated on a priority basis — so like, first in the list = first in line = the priority girlie 💖. Dictionaries are identified by the dictionary name in the dictionary table.

Dictionary names are got in the area dics in the following format:

dictionary-name-1 ¡ï0 dictionary-name-2 ¡ï0 ... dictionary-name-n ¡ï0
¡ï0

The size of the area dics is given in bytes by maxdics. And heads up — the dictionary list gets truncated in character strings when it exceeds this size. it's giving "we ran out of room, sorry babe" 😭

💀 RETURN VALUE 💀

This function returns the number of dictionary names, or returns -1 if the context is invalid. that's it. that's the whole report card 🫶

🌈 SIGN-OFF 🌈

and that's the tea, bestie ✨ this iconic little page comes from the Library Functions Manual, section 3, and her whole name is RKGETDICLIST(3) — you already knew that tho. go forth and get those dictionary names 💜🦋🌸