RKMAPROMA(3)

NAME

RRkkMMaappRRoommaa - perform Romaji-kana conversion by using a specified Romajikana conversion table

SYNOPSIS

##iinncclluuddee <<ccaannnnaa//RRKK..hh>>
iinntt RRkkMMaappRRoommaa((rroommaajjii,, ddsstt,, mmaaxxddsstt,, ssrrcc,, ssrrcclleenn,, ffllaaggss,, ssttaattuuss))
ssttrruucctt RRkkRRxxDDiicc **rroommaajjii;;
uunnssiiggnneedd cchhaarr **ddsstt;;
iinntt mmaaxxddsstt;;
uunnssiiggnneedd cchhaarr **ssrrcc;;
iinntt ssrrcclleenn;;
iinntt ffllaaggss;;
iinntt **ssttaattuuss;;

DESCRIPTION

RkMapRoma performs Romaji-kana conversion by using a specified Romajikana conversion table. romaji specifies a pointer to the Romaji-kana conversion table that has been returned by RkOpenRoma(3). RkMapRoma interprets the srclen bytes of contiguous data starting at the area src as a Romaji character string and searches through the Romaji-kana conversion table for the rule of Romaji-kana conversion that matches the beginning of the Romaji character string. If the corresponding conversion rule is found, the corresponding kana character string is stored in the area dst. The resulting character string is truncated when its byte length exceeds maxdst -1. dst is padded with null characters at the end if possible.

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.

RK_FLUSH Converts all Romaji characters compulsorily.

Useful for handling n appearing at the end of a character string.

The flags listed below specify the type of characters stored in src. These specified code conversion to be performed on the character string derived from the Romaji-kana conversion table. These flags can use one by one.

RK_NFER No conversion

RK_XFER Hiragana

RK_HFER Single-byte character

RK_KFER Katakana

RK_ZFER Double-byte character

status is set to the byte length of the character string set in the area dst. A negative value means that there is no matching Romaji character string.

RETURN VALUE

This function returns the starting byte length of the Romaji character string matched by Romaji-kana conversion.

RKMAPROMA(3)