fkeuctoibmj(3K)                  3/11/92                    fkeuctoibmj(3K)

NAME
     fkeuctoibmj - EUC to IBM host code kanji converter

SYNOPSIS
     cc [flag...] file... -lkanji [library...]

     #include <mlx-j/kanji.h>

     int fkeuctoibmj(FILE *in, FILE *out, int exp);

DESCRIPTION
     fkeuctoibmj converts EUC encoded text  into  IBM  Japanese  (Katakana)
     Kanji Mixed Host Code (IBM CCSID's 13218 and 09122).

     The exp argument must be set to KJEXP or KJNOEXP. KJEXP  indicates
     that   half-size  katakana  should  be  expanded  to  their  full-size
     equivalents, KJNOEXP causes half-size katakana to  be  preserved  in
     the output.

     in  and  out  are  the  input  and  output  stream   for   conversion,
     respectively.  in  must  be  open  for  reading,  out must be open for
     writing.

RETURN VALUE
     Successful conversion returns a value of 0, I/O errors on  in  or  out
     return -1.  Otherwise,  one  of  the  (non-fatal) error codes below is
     returned. Conversion does  not  stop  when  one  of  these  errors  is
     detected.

     KJERROR
          An invalid byte or byte  sequence  was  detected  in  the  input.
          Typically,  this  happens  when  a  byte which introduces a kanji
          character is not followed by a byte sequence to validly  complete
          it, or when a partial character is found at EOF.

     KJGAIJI
          An EUC codeset 3 (gaiji) character was found in the input.  Gaiji
          characters are not part of IBM host code and are skipped.

     KJESC
          When converting from EUC to IBM host code, it is possible that  a
          shift-in or shift-out byte is present in the ASCII portion of the
          input. These bytes cannot be passed through to the  output  since
          they  would  change  the  shift state. Instead, such bytes in the
          input are skipped and the return value is set to KJESC.

     KJNOMAP
          An EUC kanji character which does not exist in IBM host code  was
          present in the input. Such characters are skipped.

NOTES
     Invalid byte sequences in the input are copied through to  the  output



Page 1                       Reliant UNIX 5.44                      3, 1911

fkeuctoibmj(3K)                  3/11/92                    fkeuctoibmj(3K)

     unchanged (in shifted-out mode).

     in must initially be in shifted-out mode and  must  be  aligned  on  a
     character boundary.

     The output stream is always left in shifted-out mode.

BUGS
     If more than one error condition is detected  during  conversion,  the
     return code always indicates the first problem that was found.

     Invalid byte sequences in the input  may  cause  fkeuctoibmj  to  lose
     synchronization  with kanji character boundaries. If this happens, all
     converted output following the error is likely to be garbage.

FILES
     /usr/lib/libkanji.a

SEE ALSO
     keuctoibmj(3K), seuctoibmj(3K), ceuctoibmj(3K), fkibmjtoeuc(3K), fkconv(3K).


































Page 2                       Reliant UNIX 5.44                      3, 1911