aboutsummaryrefslogtreecommitdiffstats
path: root/man/iconv_open.3
diff options
context:
space:
mode:
authorBruno Haible <bruno@clisp.org>2002-05-21 12:50:46 +0000
committerBruno Haible <bruno@clisp.org>2009-06-21 11:43:43 +0200
commitf91d7f06f824ff7b5836da9f334c8b04beaf242b (patch)
tree43bd0fa0c1ca73dc2a1d496de02ef39989b5cfc6 /man/iconv_open.3
parenta2e30ec5a97fa2b4e8c6e32b98ebb74fc6405021 (diff)
downloadandroid-libiconv-f91d7f06f824ff7b5836da9f334c8b04beaf242b.tar.gz
android-libiconv-f91d7f06f824ff7b5836da9f334c8b04beaf242b.tar.bz2
android-libiconv-f91d7f06f824ff7b5836da9f334c8b04beaf242b.zip
Mention extra encodings.
Diffstat (limited to 'man/iconv_open.3')
-rw-r--r--man/iconv_open.364
1 files changed, 61 insertions, 3 deletions
diff --git a/man/iconv_open.3 b/man/iconv_open.3
index 6781072..1931eb6 100644
--- a/man/iconv_open.3
+++ b/man/iconv_open.3
@@ -9,7 +9,7 @@
.\" GNU glibc-2 source code and manual
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\"
-.TH ICONV_OPEN 3 "May 9, 2002" "GNU" "Linux Programmer's Manual"
+.TH ICONV_OPEN 3 "May 12, 2002" "GNU" "Linux Programmer's Manual"
.SH NAME
iconv_open \- allocate descriptor for character set conversion
.SH SYNOPSIS
@@ -28,6 +28,8 @@ combinations are system dependent. For the libiconv library, the following
encodings are supported, in all combinations.
.TP
European languages
+.nf
+.fi
ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
KOI8-R, KOI8-U, KOI8-RU,
CP{1250,1251,1252,1253,1254,1257}, CP{850,866},
@@ -36,62 +38,115 @@ Mac{Cyrillic,Ukraine,Greek,Turkish},
Macintosh
.TP
Semitic languages
+.nf
+.fi
ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
.TP
Japanese
+.nf
+.fi
EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1
.TP
Chinese
+.nf
+.fi
EUC-CN, HZ, GBK, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS,
ISO-2022-CN, ISO-2022-CN-EXT
.TP
Korean
+.nf
+.fi
EUC-KR, CP949, ISO-2022-KR, JOHAB
.TP
Armenian
+.nf
+.fi
ARMSCII-8
.TP
Georgian
+.nf
+.fi
Georgian-Academy, Georgian-PS
.TP
Tajik
+.nf
+.fi
KOI8-T
.TP
Thai
+.nf
+.fi
TIS-620, CP874, MacThai
.TP
Laotian
+.nf
+.fi
MuleLao-1, CP1133
.TP
Vietnamese
+.nf
+.fi
VISCII, TCVN, CP1258
.TP
Platform specifics
+.nf
+.fi
HP-ROMAN8, NEXTSTEP
.TP
Full Unicode
.nf
+.fi
UTF-8
+.nf
+.fi
UCS-2, UCS-2BE, UCS-2LE
+.nf
+.fi
UCS-4, UCS-4BE, UCS-4LE
+.nf
+.fi
UTF-16, UTF-16BE, UTF-16LE
+.nf
+.fi
UTF-32, UTF-32BE, UTF-32LE
+.nf
+.fi
UTF-7
-JAVA
+.nf
.fi
+JAVA
.TP
Full Unicode, in terms of \fBuint16_t\fP or \fBuint32_t\fP
(with machine dependent endianness and alignment)
.nf
-UCS-2-INTERNAL, UCS-4-INTERNAL
.fi
+UCS-2-INTERNAL, UCS-4-INTERNAL
.TP
Locale dependent, in terms of \fBchar\fP or \fBwchar_t\fP
(with machine dependent endianness and alignment, and with semantics
depending on the OS and the current LC_CTYPE locale facet)
.nf
+.fi
char, wchar_t
+.PP
+When configured with the option \fB\-\-enable-extra-encodings\fP, it also
+provides support for a few extra encodings:
+.TP
+European languages
+.nf
+CP{437,737,775,852,855,857,858,860,861,863,865,869,1125}
+.fi
+.TP
+Semitic languages
+.nf
.fi
+CP864
+.TP
+Japanese
+.nf
+.fi
+EUC-JISX0213, Shift_JISX0213, ISO-2022-JP-3
+.PP
The empty encoding name "" is equivalent to "char": it denotes the
locale dependent character encoding.
.PP
@@ -100,6 +155,9 @@ is activated. This means that when a character cannot be represented in the
target character set, it can be approximated through one or several
similarly looking characters.
.PP
+When the string "//IGNORE" is appended to \fItocode\fP, characters that
+cannot be represented in the target character set will be silently discarded.
+.PP
The resulting conversion descriptor can be used with \fBiconv\fP any number
of times. It remains valid until deallocated using \fBiconv_close\fP.
.PP