OPEN_KANA_KAN(3X)

NAME

open_kana_kan, close_kana_kan − initialize KANA to KANJI conversion

SYNOPSIS

#include <jlib.h>

int open_kana_kan (filename)
char *filename;

int close_kana_kan (ed)
int ed;

DESCRIPTION

Open_kana_kan initializes and sets up the environment for KANA to KANJI conversion. The file named filename is used to update and store HINDO information. If the file does not exist, it is created. If a NULL pointer is specified, it is disabled to update and store HINDO information.

Open_kana_kan returns an environment descriptor which is used in calling the following function:

Henkan (ed, string, len, buf, size, mode)	perform KANA to KANJI conversion
JiKouho (ed, pb, nb)	get all KOUHOs
Kakutei (ed, pb, nb, nk)	update HINDO information
HenkanOwari (ed, pb)	free a space allocated by Henkan
SetUserDict (ed, dp, mode)	enable or disable to consult a user dictionary

Close_kana_kan closes the environment descriptor indicated by ed, which is obtained from an open_kana_kan call.

DIAGNOSTICS

Open_kana_kan returns an environment descriptor upon successful completion. Otherwise, -1 is returned and jlib_errno is set to indicate the error:

[JSDACCES] The system dictionary exists but permission is denied.

[JSDWRONG] The system dictionary has an incorrect format

[JSDNOENT] The system dictionary does not exist.

[JSDBADENT] The file having the same path name as the system dictionary exists.

[JHTACCES] The file named filename exists but permission is denied.

[JHTWRONG] The format of the file named filename is wrong.

[JHTBADENT] The named file exists but it is not the file to update and store HINDO information.

[JMENV] The maximum allowed number of environment descriptors are already open.

Close_kana_kan returns 0 upon successful completion. Otherwise, -1 is returned and jlib_errno is set to indicate the error.

[JBADED] Ed is not a valid environment descriptor.

WARNINGS

The maximum number of environment descriptors allowed is 1.