ROMAJIHIRAGANA(3X)

NAME

RomajiHiragana, RomajiKatakana, RomajiHankakuKatakana− translate characters

SYNOPSIS

#include <jlib.h>

unsigned char *RomajiHiragana (s1, s2)
char *s1;
unsigned char *s2;

unsigned char *RomajiKatakana (s1, s2)
char *s1;
unsigned char *s2;

unsigned char *RomajiHankakuKatakana (s1, s2)
char *s1;
unsigned char *s2;

DESCRIPTION

The arguments s1 and s2 point to strings (arrays of characters terminated by a null character). The string s1 is ROMAJI, which is an alphabetic representation of Japanese characters. Each character included in s1 must be an 8-bit alphabet.

RomajiHiragana translates s1 to string s2 spelled by HIRAGANA. RomajiKatakana translates s1 to string s2 spelled by KATAKANA. RomajiHankakuKatakana translates s1 to string s2 spelled by HANKAKU KATAKANA.

Translation is performed based on romaji(5) which shows how Japanese is spelled using Roman characters.

DIAGNOSTICS

Each function returns a NULL pointer upon successful completion.

If string s1 contains illegal or undetermined ROMAJI spelling, each function returns a pointer to the first character of the ROMAJI spelling and jlib_errno is set to indicate translation result.

[JNEEDMORE] The string s1 is undetermined ROMAJI.

[JNOTFOUND] The string s1 is unacceptable ROMAJI.

[JNOTRESPOND] A server does not respond.

WARNINGS

Each function cannot check for overflow of any receiving string. The length of the resultant string is twice the length of s1 at most. NULL destinations cause errors. NULL sources are treated as zero-length strings.

Museum