kconv version 0.3 -- usage

kconv.convert(input_string[, output_code[, input_code]])

the module name is 'kconv' and there is one function defined called
'convert'.  'convert' takes an input string, and two optional arguments which
define an output encoding scheme and an input encoding scheme (in that
order).

here are some examples, assuming the following:

AUTO = 0
JIS  = 1
EUC  = 2
SJIS = 3

aJisString   = 'imagine this is a string in JIS'
aEucString   = 'imagine this is a string in EUC'
aSjisString  = 'imagine this is a string in SJIS'
aKanjiString = 'imagine this is some kanji string'

example 1:

  convertedString = kconv.convert(aKanjiString, JIS)

should assign convertedString a string in JIS coverted from aKanjiString.
Note, an attempt is made to detect the input code automatically since no
input encoding scheme was specified as the third argument.  Ideally, an
exception would be raised if automatic code detection fails...

example 2:

  convertedString = kconv.convert(aJisString, EUC, JIS)

should assign convertedString a string in EUC converted from aJisString.
Note, since an input encoding scheme has been specified, convert assumes
aJisString is in JIS.

example 3:

  convertedString = kconv.convert(aEucString)

should assign convertedString a string in JIS converted from aEucString.
Note, the default output encoding scheme is JIS.

I still need to add support for exceptions as well as the encoding scheme
constants (AUTO, JIS, EUC, SJIS).  (AUTO means use automatic detection...
not sure why this is necessary...I've left it in because Kconv for perl
had it.)

Sen Nagata - 2/13/97
