About

Metadata

  • Last updated , by AudreyTang
  • License BSD-3-Clause
  • Maintained by: Audrey Tang <audreyt@audreyt.org>

  • Lottery factor: 0

Links

Installation

This package uses the Custom cabal build type

Package Flags

Use the -f option with cabal commands to enable flags

    bytestring_in_base (on by default)

Readme

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.