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]

Modules

[Index]

Codec
- Text
  - Codec.Text.IConv

Flags

Automatic Flags

Name	Description	Default
bytestring_in_base		Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

iconv-0.4.tar.gz [browse] (Cabal source package)
Package description (revised from the package)

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

DuncanCoutts, IanLynagh

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	0.2, 0.4, 0.4.0.2, 0.4.1.0, 0.4.1.1, 0.4.1.2, 0.4.1.3
Dependencies	base (<4), bytestring (>=0.9) [details]
License	BSD-3-Clause
Copyright	(c) 2006-2007 Duncan Coutts
Author	Duncan Coutts <duncan@haskell.org>
Maintainer	Duncan Coutts <duncan@haskell.org>
Revised	Revision 1 made by HerbertValerioRiedel at 2015-05-29T21:48:01Z
Uploaded	by DuncanCoutts at 2007-10-21T17:39:33Z
Distributions	Debian:0.4.1.3, LTSHaskell:0.4.1.3, NixOS:0.4.1.3, Stackage:0.4.1.3
Reverse Dependencies	11 direct, 9 indirect [details]
Downloads	11549 total (50 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs uploaded by user Build status unknown [no reports yet]

Readme for iconv-0.4

[back to package description]

Codec.Text.IConv
================

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 :: String -> String -> 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.

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

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 page:

  http://www.gnu.org/software/libiconv/

Availability of iconv()
-----------------------

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

  http://www.gnu.org/software/libc/manual/html_node/Character-Set-Handling.html

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

  http://www.gnu.org/software/libiconv/