rkmapphonogram(3) [debian man page]
RKMAPPHONOGRAM(3) Library Functions Manual RKMAPPHONOGRAM(3) NAME
RkMapPhonogram - perform Romaji-kana conversion by using a specified Romaji-kana conversion table SYNOPSIS
#include <canna/RK.h> int RkMapPhonogram(romaji, dst, maxdst, src, srclen, flags, ulen, dlen, tlen, rule) struct RkRxDic *romaji; unsigned char *dst; int maxdst; unsigned char *src; int srclen; int flags; int *ulen; int *dlen; int *tlen; int *rule; DESCRIPTION
RkMapPhonogram performs Romaji-kana conversion by using a specified Romaji-kana conversion table. romaji specifies a pointer to the Romaji-kana conversion table that has been returned by RkOpenRoma(3). RkMapPhonogram interprets the srclen bytes of contiguous data start- ing at the area src as a Romaji character string and searches through the Romaji-kana conversion table for the rule of Romaji-kana conver- sion that matches the beginning of the Romaji character string. If the corresponding conversion rule is found, the area dst is loaded with the corresponding kana character string, with dlen being set to its byte length. The resulting character string is truncated when its byte length exceeds maxdst -1. flags is a combination of the following Romaji-kana conversion flags connected by or: RK_SOKUON Enables gemination, in which a sequence of two occurrences of the same character, xx, is converted to small kana character "tsu" only if it is not defined in the Romaji-kana conversion table file. This process provides for situa- tions in which an obsolete Romaji-kana conversion table is used. RK_FLUSH Converts all Romaji characters compulsorily. Useful for handling n appearing at the end of a character string. ulen, dlen, and tlen are used to manage the progress of Romaji-kana conversion. For example, if the character string "tt" is given to RkMapPhonogram, the first "t" is submitted to Romaji-kana conversion, with dst being set to small kana character "tsu". The remaining "t" is put to reuse for Romaji-kana conversion. When "a" is entered subsequently, it is combined with the "t" left from the previous run of RkMapPhonogram to generate kana character "ta". ulen is set to the byte length of the characters from src used for Romaji-kana conversion. dlen is set to the byte length of the kana characters derived from Romaji-kana conversion. tlen is set to the byte length of the character string to be used in the next run of Romaji-kana conversion. The character string led by tlen is placed after the character string resulting from Romaji-kana conversion in the dst buffers. If null pointers are specified in ulen, dlen, and tlen, these parameters do not return any values and are simply ignored. rule is used to exchange information about the rule of Romaji-kana conversion. When calling RkMapPhonogram for the first time, specify a pointer to a variable loaded with 0. Upon return from the first call to RkMapPhonogram, that variable is loaded with internal information about the rule of Romaji-kana conversion, in place of 0. To continue Romaji-kana conversion, specify the same pointer to the variable to RkMapPhonogram. RETURN VALUE
This function returns information about whether the character string set in dst has been converted by using a rule existing in the Romaji- kana conversion table or not. The function returns 1 if a rule existing in the Romaji-kana conversion table has been used; otherwise, it returns 0. RKMAPPHONOGRAM(3)
Check Out this Related Man Page
DICLIBINTRO(3) Library Functions Manual DICLIBINTRO(3) NAME
DICLib intro - dictionary access library introduction DESCRIPTION
The dictionary access library provides basic functions for kana-kanji conversion. The following files are prerequisite to using the dic- tionary access library: Header file canna/RK.h An include file that contains data and function declarations for use by the kana-kanji conversion library. Include this file at compile time. Libraries libcanna.a, libcanna.so Kana-kanji conversion libraries. Specify "-lcanna" at link time. SUMMARY
The dictionary access library provides three major categories of functions: i| Code conversion functions Convert character string codes between double-width and single-width characters and between hiragana and katakana. External data and initialization procedures are not required. i| Romaji-kana conversion functions Convert Romaji to kana by using a Romaji-kana conversion table that defines the correspondence between Romaji and kana. The rules of Romaji-kana conversion can be altered by making modifications to this table. i| Kana-kanji conversion functions Convert kana to kanji through continuous clause conversion by using a kana-kanji conversion dictionary that defines the correspondence between readings and words. Kana-kanji conversion can be performed to meet specific applications by making modifications to this dic- tionary. Among all the functions of Japanese input processing, this library performs only data conversion. To be able to enter Japanese text from a keyboard, therefore, it is necessary for users to write a keyboard handling routine within the application program. i| Code conversion functions Rk(w)CvtZen Convert ASCII characters and single-width katakana to double-width characters. RkCvtHan Convert double-width symbols, alphanumeric characters, hiragana, and katakana to single-width characters. RkCvtKana Convert double-width hiragana to double-width katakana. RkCvtHira Convert double-width katakana to double-width hiragana. RkCvtEuc Convert shift JIS code to EUC code. i| Romaji-kana conversion functions RkOpenRoma Open the dictionary to use for Romaji-kana conversion. RkCloseRoma Close the dictionary used for Romaji-kana conversion. RkMapRoma Perform Romaji-kana conversion by using a specified Romaji-kana conversion dictionary. RkCvtRoma Convert an entire character string from Romaji to kana by iteratively using RkMapRoma. i| Kana-kanji conversion functions RkInitialize Initialize the kana-kanji conversion functions. RkFinalize Terminate the kana-kanji conversion functions. RkCreateContext Create a new conversion context. RkDuplicateContext Create a context having the same conversion environment as a specified context. RkCloseContext Close a specified conversion context. RkGetDicList Get the names of dictionaries that can be added to the dictionary list. RkMountDic Mount a dictionary in the dictionary list. RkGetMountList Get the names of the currently mounted dictionaries. (or characters for RkwResize) RkUnmountDic Unmount a specified dictionary from the dictionary list. RkRemountDic Alter the priority order of a dictionary already in the dictionary list. RkBgnBun Convert the reading of a specified length to kanji. RkEndBun Terminate kana-kanji conversion. RkGoTo Set the clause with a specified clause number as the current clause. RkLeft Move the current clause to the clause to its left. RkRight Move the current clause to its right. RkXfer Set the candidate with a specified candidate number as the current candidate. RkNext Set the next candidate as the current candidate. RkPrev Set the previous candidate as the current candidate. RkNfer Set a reading itself as the current candidate. RkResize Change the reading length of the current clause to len bytes. RkEnlarge Enlarge the reading of the current clause. RkShorten Shorten the reading of the current clause. RkStoreYomi Change the reading of the current clause to a specified reading, reconverting the subsequent clauses. RkGetYomi Get the reading of the current clause. RkGetKanji Get the current candidate for the current clause. RkGetKanjiList Get all kanji candidates for the current clause. RkGetStat Get analysis information about the current candidate. RkGetLex Get morphemic information on each word that makes up the current candidate. RkDefineDic Define a specified candidate in a dictionary. RkDeleteDic Delete a specified candidate from a dictionary. DICLIBINTRO(3)