uconv: String encoding conversion with ICU

Codec.Text.UConv
================

This is a Haskell binding to the uconv() ICU library function.

The only module exported is Codec.Text.UConv, which provides one function:

  -- | Convert fromCharset toCharset input output
  convert :: (UConvertible a, UConvertible b, Monad m)
      => String -> String -> a -> m b

where fromCharset and toCharset are the names of the input and output
character set encodings, and input and output are the input and output text.

Valid UConvertible instances include Strings, ByteStrings and Lazy ByteStrings.

An example program to convert the encoding of an input file, similar to the
uconv program, is given in examples/huconv.hs

Character set encodings
-----------------------

To see a list of encoding names which are known by your operating system,
run "uconv --list" in a shell. Likely encodings are listed on the ICU
"Converter Explorer" web page:

  http://demo.icu-project.org/icu-bin/convexp

Availability of uconv()
-----------------------

The uconv(3) function is provided by IBM's ICU project:

  http://icu-project.org/

You'd need to install ICU first before compiling this library.