rkcvthan(3) [debian man page]

RKCVTHAN(3)						     Library Functions Manual						       RKCVTHAN(3)

NAME

       RkCvtHan / RkwCvtHan - convert double-width symbols, alphanumeric characters, hiragana, and katakana to single-width characters

SYNOPSIS

       #include <canna/RK.h>
       int RkCvtHan(dst, maxdst, src, srclen)
       unsigned char *dst;
       int maxdst;
       unsigned char *src;
       int srclen;
       int RkwCvtHan(dst, maxdst, src, srclen)
       wchar_t *dst;
       int maxdst;
       wchar_t *src;
       int srclen;

DESCRIPTION

       RkCvtHan converts the srclen bytes of double-width symbol, alphanumeric characters, hiragana, and katakana data to single-width characters,
       starting at the area src.  A null character in src is not interpreted as the end of the string.	The conversion result  is  stored  in  the
       area dst.  Characters that are not subject to conversion are copied as they are.  The conversion result is truncated to adjust to character
       boundaries in the EUC code when its byte length exceeds maxdst -1.  dst is padded with null characters at the end if possible.  EUC code is
       used to represent both src and dst.

       RkwCvtHan  is  the wchar_t version of RkCvtHan.	Arguments which specify the length are regarded as they count the character length instead
       of byte length.

       NULL can be specified in dst.  NULL overrides the entire conversion result.

RETURN VALUE

       This function returns the byte length (or character length for RkwCvtHan) of the conversion result, or returns 0 if the value of maxdst	is
       invalid.

																       RKCVTHAN(3)

RKMAPROMA(3)						     Library Functions Manual						      RKMAPROMA(3)

NAME

       RkMapRoma - perform Romaji-kana conversion by using a specified Romaji-kana conversion table

SYNOPSIS

       #include <canna/RK.h>
       int RkMapRoma(romaji, dst, maxdst, src, srclen, flags, status)
       struct RkRxDic *romaji;
       unsigned char *dst;
       int maxdst;
       unsigned char *src;
       int srclen;
       int flags;
       int *status;

DESCRIPTION

       RkMapRoma 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).  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 char-
       acters 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)