iconv: String encoding conversion

[ bsd3, library, text ] [ Propose Tags ]

Provides an interface to the POSIX iconv library functions for string encoding conversion.

[Skip to Readme]




Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS] 0.2, 0.4,,,,,
Change log changelog.md
Dependencies base (>=3 && <5), bytestring (>=0.9 && <0.11) [details]
License BSD-3-Clause
Copyright (c) 2006-20015 Duncan Coutts
Author Duncan Coutts <duncan@community.haskell.org>
Maintainer Duncan Coutts <duncan@community.haskell.org>
Category Text
Source repo head: darcs get http://code.haskell.org/iconv/
Uploaded by DuncanCoutts at 2015-06-01T09:22:17Z
Distributions Debian:, NixOS:
Reverse Dependencies 11 direct, 9 indirect [details]
Downloads 11208 total (43 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-06-03 [all 1 reports]

Readme for iconv-

[back to package description]


This is a Haskell binding to the iconv() C library function.

The only module exported is Codec.Text.IConv, which provides a single function:

-- | Convert fromCharset toCharset input output
convert :: EncodingName -> EncodingName -> Lazy.ByteString -> Lazy.ByteString

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 as lazy ByteStrings. For example:

 import qualified Codec.Text.IConv as IConv
 import qualified Data.ByteString.Lazy as BS
 main = do
   -- read UTF8, but convert to UTF32 internally
   content <- fmap (IConv.convert "UTF-8" "UTF-32") (BS.readFile file)

An example program, similar to the iconv program, is included.

Character set encodings

To see a list of encoding names which are known by your operating system, run iconv --list in a shell. Likely encodings are listed on the libiconv web site.

Availability of iconv()

The iconv(3) function conforms to POSIX.1-2001. It is provided by the GNU C library.

On systems which do not have a native iconv() implementation you may need to install libiconv.