From fcbf63e62c627deae76c1b8cb8c0876c536ed811 Mon Sep 17 00:00:00 2001 From: Jari Vetoniemi Date: Mon, 16 Mar 2020 18:49:26 +0900 Subject: Fresh start --- jni/iconv/man/Makefile | 69 ++++ jni/iconv/man/Makefile.in | 69 ++++ jni/iconv/man/iconv.1 | 108 +++++++ jni/iconv/man/iconv.1.html | 334 +++++++++++++++++++ jni/iconv/man/iconv.3 | 92 ++++++ jni/iconv/man/iconv.3.html | 209 ++++++++++++ jni/iconv/man/iconv_close.3 | 31 ++ jni/iconv/man/iconv_close.3.html | 97 ++++++ jni/iconv/man/iconv_open.3 | 204 ++++++++++++ jni/iconv/man/iconv_open.3.html | 602 +++++++++++++++++++++++++++++++++++ jni/iconv/man/iconv_open_into.3 | 47 +++ jni/iconv/man/iconv_open_into.3.html | 120 +++++++ jni/iconv/man/iconvctl.3 | 67 ++++ jni/iconv/man/iconvctl.3.html | 189 +++++++++++ 14 files changed, 2238 insertions(+) create mode 100644 jni/iconv/man/Makefile create mode 100644 jni/iconv/man/Makefile.in create mode 100644 jni/iconv/man/iconv.1 create mode 100644 jni/iconv/man/iconv.1.html create mode 100644 jni/iconv/man/iconv.3 create mode 100644 jni/iconv/man/iconv.3.html create mode 100644 jni/iconv/man/iconv_close.3 create mode 100644 jni/iconv/man/iconv_close.3.html create mode 100644 jni/iconv/man/iconv_open.3 create mode 100644 jni/iconv/man/iconv_open.3.html create mode 100644 jni/iconv/man/iconv_open_into.3 create mode 100644 jni/iconv/man/iconv_open_into.3.html create mode 100755 jni/iconv/man/iconvctl.3 create mode 100644 jni/iconv/man/iconvctl.3.html (limited to 'jni/iconv/man') diff --git a/jni/iconv/man/Makefile b/jni/iconv/man/Makefile new file mode 100644 index 0000000..2d80999 --- /dev/null +++ b/jni/iconv/man/Makefile @@ -0,0 +1,69 @@ +# Makefile for libiconv/man + +#### Start of system configuration section. #### + +# Directories used by "make": +srcdir = . + +# Directories used by "make install": +prefix = /usr/local +local_prefix = /usr/local +exec_prefix = ${prefix} +datarootdir = ${prefix}/share +datadir = ${datarootdir} +mandir = ${datarootdir}/man +docdir = ${datarootdir}/doc/${PACKAGE} +htmldir = ${docdir} + +# Programs used by "make": +RM = rm -f + + +# Programs used by "make install": +INSTALL = /usr/bin/install -c +INSTALL_PROGRAM = ${INSTALL} +INSTALL_DATA = ${INSTALL} -m 644 +mkinstalldirs = $(SHELL) ../build-aux/mkinstalldirs + +#### End of system configuration section. #### + +SHELL = /bin/sh + +# Used by docdir. +PACKAGE = libiconv + +all : + +install : force + if [ ! -d $(DESTDIR)$(mandir)/man1 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man1 ; fi + builddir="`pwd`"; cd $(srcdir) && for f in *.1 ; do (cd "$$builddir"; echo $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man1/$$f ; $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man1/$$f) ; done + if [ ! -d $(DESTDIR)$(mandir)/man3 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man3 ; fi + builddir="`pwd`"; cd $(srcdir) && for f in *.3 ; do (cd "$$builddir"; echo $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man3/$$f ; $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man3/$$f) ; done + if [ ! -d $(DESTDIR)$(htmldir) ] ; then $(mkinstalldirs) $(DESTDIR)$(htmldir) ; fi + builddir="`pwd`"; cd $(srcdir) && for f in *.html ; do (cd "$$builddir"; echo $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(htmldir)/$$f ; $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(htmldir)/$$f) ; done + +install-strip : install + +installdirs : force + if [ ! -d $(DESTDIR)$(mandir)/man1 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man1 ; fi + if [ ! -d $(DESTDIR)$(mandir)/man3 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man3 ; fi + if [ ! -d $(DESTDIR)$(htmldir) ] ; then $(mkinstalldirs) $(DESTDIR)$(htmldir) ; fi + +uninstall : force + cd $(srcdir) && for f in *.1 ; do echo $(RM) $(DESTDIR)$(mandir)/man1/$$f ; $(RM) $(DESTDIR)$(mandir)/man1/$$f ; done + cd $(srcdir) && for f in *.3 ; do echo $(RM) $(DESTDIR)$(mandir)/man3/$$f ; $(RM) $(DESTDIR)$(mandir)/man3/$$f ; done + cd $(srcdir) && for f in *.html ; do echo $(RM) $(DESTDIR)$(htmldir)/$$f ; $(RM) $(DESTDIR)$(htmldir)/$$f ; done + +check : + +mostlyclean : + +clean : + +distclean : force + $(RM) Makefile + +maintainer-clean : distclean + +force : + diff --git a/jni/iconv/man/Makefile.in b/jni/iconv/man/Makefile.in new file mode 100644 index 0000000..a05e7af --- /dev/null +++ b/jni/iconv/man/Makefile.in @@ -0,0 +1,69 @@ +# Makefile for libiconv/man + +#### Start of system configuration section. #### + +# Directories used by "make": +srcdir = @srcdir@ + +# Directories used by "make install": +prefix = @prefix@ +local_prefix = /usr/local +exec_prefix = @exec_prefix@ +datarootdir = @datarootdir@ +datadir = @datadir@ +mandir = @mandir@ +docdir = @docdir@ +htmldir = @htmldir@ + +# Programs used by "make": +RM = rm -f +@SET_MAKE@ + +# Programs used by "make install": +INSTALL = @INSTALL@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_DATA = @INSTALL_DATA@ +mkinstalldirs = $(SHELL) @top_srcdir@/build-aux/mkinstalldirs + +#### End of system configuration section. #### + +SHELL = /bin/sh + +# Used by docdir. +PACKAGE = @PACKAGE@ + +all : + +install : force + if [ ! -d $(DESTDIR)$(mandir)/man1 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man1 ; fi + builddir="`pwd`"; cd $(srcdir) && for f in *.1 ; do (cd "$$builddir"; echo $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man1/$$f ; $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man1/$$f) ; done + if [ ! -d $(DESTDIR)$(mandir)/man3 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man3 ; fi + builddir="`pwd`"; cd $(srcdir) && for f in *.3 ; do (cd "$$builddir"; echo $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man3/$$f ; $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(mandir)/man3/$$f) ; done + if [ ! -d $(DESTDIR)$(htmldir) ] ; then $(mkinstalldirs) $(DESTDIR)$(htmldir) ; fi + builddir="`pwd`"; cd $(srcdir) && for f in *.html ; do (cd "$$builddir"; echo $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(htmldir)/$$f ; $(INSTALL_DATA) $(srcdir)/$$f $(DESTDIR)$(htmldir)/$$f) ; done + +install-strip : install + +installdirs : force + if [ ! -d $(DESTDIR)$(mandir)/man1 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man1 ; fi + if [ ! -d $(DESTDIR)$(mandir)/man3 ] ; then $(mkinstalldirs) $(DESTDIR)$(mandir)/man3 ; fi + if [ ! -d $(DESTDIR)$(htmldir) ] ; then $(mkinstalldirs) $(DESTDIR)$(htmldir) ; fi + +uninstall : force + cd $(srcdir) && for f in *.1 ; do echo $(RM) $(DESTDIR)$(mandir)/man1/$$f ; $(RM) $(DESTDIR)$(mandir)/man1/$$f ; done + cd $(srcdir) && for f in *.3 ; do echo $(RM) $(DESTDIR)$(mandir)/man3/$$f ; $(RM) $(DESTDIR)$(mandir)/man3/$$f ; done + cd $(srcdir) && for f in *.html ; do echo $(RM) $(DESTDIR)$(htmldir)/$$f ; $(RM) $(DESTDIR)$(htmldir)/$$f ; done + +check : + +mostlyclean : + +clean : + +distclean : force + $(RM) Makefile + +maintainer-clean : distclean + +force : + diff --git a/jni/iconv/man/iconv.1 b/jni/iconv/man/iconv.1 new file mode 100644 index 0000000..6b85651 --- /dev/null +++ b/jni/iconv/man/iconv.1 @@ -0,0 +1,108 @@ +.\" Copyright (c) Bruno Haible +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 3 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html +.\" POSIX 2001 draft6 +.\" +.TH ICONV 1 "March 31, 2007" "GNU" "Linux Programmer's Manual" +.SH NAME +iconv \- character set conversion +.SH SYNOPSIS +.nf +iconv [\fIOPTION\fP...] [\fB\-f\fP \fIencoding\fP] [\fB\-t\fP \fIencoding\fP] [\fIinputfile\fP ...] +iconv \fB\-l\fP +.fi +.SH DESCRIPTION +The \fBiconv\fP program converts text from one encoding to another encoding. +More precisely, it converts \fBfrom\fP the encoding given for the \fB\-f\fP +option \fBto\fP the encoding given for the \fB\-t\fP option. Either of these +encodings defaults to the encoding of the current locale. All the +\fIinputfile\fPs are read and converted in turn; if no \fIinputfile\fP is +given, the standard input is used. The converted text is printed to standard +output. +.PP +The encodings permitted are system dependent. For the libiconv implementation, +they are listed in the iconv_open(3) manual page. +.PP +Options controlling the input and output format: +.TP +\fB\-f\fP \fIencoding\fP, \fB\-\-from\-code=\fP\fIencoding\fP +Specifies the encoding of the input. +.TP +\fB\-t\fP \fIencoding\fP, \fB\-\-to\-code=\fP\fIencoding\fP +Specifies the encoding of the output. +.PP +Options controlling conversion problems: +.TP +\fB\-c\fP +When this option is given, characters that cannot be converted are silently +discarded, instead of leading to a conversion error. +.TP +\fB\-\-unicode\-subst=\fP\fIformatstring\fP +When this option is given, Unicode characters that cannot be represented in +the target encoding are replaced with a placeholder string that is constructed +from the given \fIformatstring\fP, applied to the Unicode code point. The +\fIformatstring\fP must be a format string in the same format as for the +.I printf +command or the +.I printf() +function, taking either no argument or exactly one unsigned integer argument. +.TP +\fB\-\-byte\-subst=\fP\fIformatstring\fP +When this option is given, bytes in the input that are not valid in the source +encoding are replaced with a placeholder string that is constructed from the +given \fIformatstring\fP, applied to the byte's value. The \fIformatstring\fP +must be a format string in the same format as for the +.I printf +command or the +.I printf() +function, taking either no argument or exactly one unsigned integer argument. +.TP +\fB\-\-widechar\-subst=\fP\fIformatstring\fP +When this option is given, wide characters in the input that are not valid in +the source encoding are replaced with a placeholder string that is constructed +from the given \fIformatstring\fP, applied to the byte's value. The +\fIformatstring\fP must be a format string in the same format as for the +.I printf +command or the +.I printf() +function, taking either no argument or exactly one unsigned integer argument. +.PP +Options controlling error output: +.TP +\fB\-s\fP, \fB\-\-silent\fP +When this option is given, error messages about invalid or unconvertible +characters are omitted, but the actual converted text is unaffected. +.PP +The \fBiconv \-l\fP or \fBiconv \-\-list\fP command lists the names of the +supported encodings, in a system dependent format. For the libiconv +implementation, the names are printed in upper case, separated by whitespace, +and alias names of an encoding are listed on the same line as the encoding +itself. +.SH EXAMPLES +.TP +\fBiconv \-f ISO\-8859\-1 \-t UTF\-8\fP +converts input from the old West-European encoding ISO\-8859\-1 to Unicode. +.PP +.nf +\fBiconv \-f KOI8\-R \-\-byte\-subst="<0x%x>"\fP +\fB \-\-unicode\-subst=""\fP +.fi +.RS +converts input from the old Russian encoding KOI8\-R to the locale encoding, +substituting an angle bracket notation with hexadecimal numbers for invalid +bytes and for valid but unconvertible characters. +.RE +.TP +\fBiconv \-\-list\fP +lists the supported encodings. +.SH "CONFORMING TO" +POSIX:2001 +.SH "SEE ALSO" +.BR iconv_open (3), +.BR locale (7) diff --git a/jni/iconv/man/iconv.1.html b/jni/iconv/man/iconv.1.html new file mode 100644 index 0000000..e944bf2 --- /dev/null +++ b/jni/iconv/man/iconv.1.html @@ -0,0 +1,334 @@ + + + + + + +ICONV + + + +

ICONV

+NAME
+SYNOPSIS
+DESCRIPTION
+EXAMPLES
+CONFORMING TO
+SEE ALSO
+ +
+ +

NAME

+ + + + + +
+

iconv − character set conversion

+
+ +

SYNOPSIS

+ + + + + +
+
iconv [OPTION...] [−f encoding] [−t encoding] [inputfile ...]
+iconv −l
+
+
+ +

DESCRIPTION

+ + + + + + +
+

The iconv program converts text from one encoding +to another encoding. More precisely, it converts from +the encoding given for the −f option to +the encoding given for the −t option. Either of +these encodings defaults to the encoding of the current +locale. All the inputfiles are read and converted in +turn; if no inputfile is given, the standard input is +used. The converted text is printed to standard output.

+ +

The encodings permitted are system dependent. For the +libiconv implementation, they are listed in the +iconv_open(3) manual page.

+ +

Options controlling the input and output format:

+
+ + + + + +
+

−f encoding, +−−from−code=encoding

+ + + + + +
+

Specifies the encoding of the input.

+
+ + + + + +
+

−t encoding, +−−to−code=encoding

+ + + + + +
+

Specifies the encoding of the output.

+
+ + + + + +
+

Options controlling conversion problems:

+
+ + + + + + + +
+ +

−c

+		 + +

When this option is given, characters that cannot be +converted are silently discarded, instead of leading to a +conversion error.

+
+ + + + + +
+ +

−−unicode−subst=formatstring

+ + + + + +
+

When this option is given, Unicode characters that cannot +be represented in the target encoding are replaced with a +placeholder string that is constructed from the given +formatstring, applied to the Unicode code point. The +formatstring must be a format string in the same +format as for the printf command or the +printf() function, taking either no argument or +exactly one unsigned integer argument.

+
+ + + + + +
+ +

−−byte−subst=formatstring

+ + + + + +
+

When this option is given, bytes in the input that are +not valid in the source encoding are replaced with a +placeholder string that is constructed from the given +formatstring, applied to the byte’s value. The +formatstring must be a format string in the same +format as for the printf command or the +printf() function, taking either no argument or +exactly one unsigned integer argument.

+
+ + + + + +
+ +

−−widechar−subst=formatstring

+ + + + + +
+

When this option is given, wide characters in the input +that are not valid in the source encoding are replaced with +a placeholder string that is constructed from the given +formatstring, applied to the byte’s value. The +formatstring must be a format string in the same +format as for the printf command or the +printf() function, taking either no argument or +exactly one unsigned integer argument.

+
+ + + + + +
+

Options controlling error output:

+
+ + + + + +
+

−s, −−silent

+ + + + + +
+

When this option is given, error messages about invalid +or unconvertible characters are omitted, but the actual +converted text is unaffected.

+
+ + + + + +
+

The iconv −l or iconv +−−list command lists the names of the +supported encodings, in a system dependent format. For the +libiconv implementation, the names are printed in upper +case, separated by whitespace, and alias names of an +encoding are listed on the same line as the encoding +itself.

+
+ +

EXAMPLES

+ + + + + +
+

iconv −f ISO−8859−1 −t +UTF−8

+ + + + + +
+

converts input from the old West-European encoding +ISO−8859−1 to Unicode.

+
+ + + + + +
+
iconv −f KOI8−R −−byte−subst="<0x%x>"
+                −−unicode−subst="<U+%04X>"
+
+
+ + + + + + +
+

converts input from the old Russian encoding KOI8−R +to the locale encoding, substituting an angle bracket +notation with hexadecimal numbers for invalid bytes and for +valid but unconvertible characters.

+ + + + + +
+

iconv −−list

+ + + + + +
+

lists the supported encodings.

+
+ +

CONFORMING TO

+ + + + + +
+

POSIX:2001

+
+ +

SEE ALSO

+ + + + + +
+

iconv_open(3), locale(7)

+
+
+ + diff --git a/jni/iconv/man/iconv.3 b/jni/iconv/man/iconv.3 new file mode 100644 index 0000000..3c511ea --- /dev/null +++ b/jni/iconv/man/iconv.3 @@ -0,0 +1,92 @@ +.\" Copyright (c) Bruno Haible +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 3 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" GNU glibc-2 source code and manual +.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html +.\" +.TH ICONV 3 "September 7, 2008" "GNU" "Linux Programmer's Manual" +.SH NAME +iconv \- perform character set conversion +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "size_t iconv (iconv_t " cd , +.BI " const char* * " inbuf ", size_t * "inbytesleft , +.BI " char* * " outbuf ", size_t * "outbytesleft ); +.fi +.SH DESCRIPTION +The argument \fIcd\fP must be a conversion descriptor created using the +function \fBiconv_open\fP. +.PP +The main case is when \fIinbuf\fP is not NULL and \fI*inbuf\fP is not NULL. +In this case, the \fBiconv\fP function converts the multibyte sequence +starting at \fI*inbuf\fP to a multibyte sequence starting at \fI*outbuf\fP. +At most \fI*inbytesleft\fP bytes, starting at \fI*inbuf\fP, will be read. +At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written. +.PP +The \fBiconv\fP function converts one multibyte character at a time, and for +each character conversion it increments \fI*inbuf\fP and decrements +\fI*inbytesleft\fP by the number of converted input bytes, it increments +\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of converted +output bytes, and it updates the conversion state contained in \fIcd\fP. +If the character encoding of the input is stateful, the \fBiconv\fP function +can also convert a sequence of input bytes to an update of the conversion state +without producing any output bytes; such input is called a \fIshift sequence\fP. +The conversion can stop for four reasons: +.PP +1. An invalid multibyte sequence is encountered in the input. In this case +it sets \fBerrno\fP to \fBEILSEQ\fP and returns (size_t)(\-1). \fI*inbuf\fP +is left pointing to the beginning of the invalid multibyte sequence. +.PP +2. The input byte sequence has been entirely converted, i.e. \fI*inbytesleft\fP +has gone down to 0. In this case \fBiconv\fP returns the number of +non-reversible conversions performed during this call. +.PP +3. An incomplete multibyte sequence is encountered in the input, and the +input byte sequence terminates after it. In this case it sets \fBerrno\fP to +\fBEINVAL\fP and returns (size_t)(\-1). \fI*inbuf\fP is left pointing to the +beginning of the incomplete multibyte sequence. +.PP +4. The output buffer has no more room for the next converted character. In +this case it sets \fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1). +.PP +A different case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, but +\fIoutbuf\fP is not NULL and \fI*outbuf\fP is not NULL. In this case, the +\fBiconv\fP function attempts to set \fIcd\fP's conversion state to the +initial state and store a corresponding shift sequence at \fI*outbuf\fP. +At most \fI*outbytesleft\fP bytes, starting at \fI*outbuf\fP, will be written. +If the output buffer has no more room for this reset sequence, it sets +\fBerrno\fP to \fBE2BIG\fP and returns (size_t)(\-1). Otherwise it increments +\fI*outbuf\fP and decrements \fI*outbytesleft\fP by the number of bytes +written. +.PP +A third case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, and +\fIoutbuf\fP is NULL or \fI*outbuf\fP is NULL. In this case, the \fBiconv\fP +function sets \fIcd\fP's conversion state to the initial state. +.SH "RETURN VALUE" +The \fBiconv\fP function returns the number of characters converted in a +non-reversible way during this call; reversible conversions are not counted. +In case of error, it sets \fBerrno\fP and returns (size_t)(\-1). +.SH ERRORS +The following errors can occur, among others: +.TP +.B E2BIG +There is not sufficient room at \fI*outbuf\fP. +.TP +.B EILSEQ +An invalid multibyte sequence has been encountered in the input. +.TP +.B EINVAL +An incomplete multibyte sequence has been encountered in the input. +.SH "CONFORMING TO" +POSIX:2001 +.SH "SEE ALSO" +.BR iconv_open (3), +.BR iconvctl (3) +.BR iconv_close (3) diff --git a/jni/iconv/man/iconv.3.html b/jni/iconv/man/iconv.3.html new file mode 100644 index 0000000..e46d433 --- /dev/null +++ b/jni/iconv/man/iconv.3.html @@ -0,0 +1,209 @@ + + + + + + +ICONV + + + +

ICONV

+NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +
+ +

NAME

+ + + + + +
+

iconv − perform character set conversion

+
+ +

SYNOPSIS

+ + + + + +
+
#include <iconv.h>
+
+size_t iconv (iconv_t cd,
+              const char* * inbuf, size_t * inbytesleft,
+              char* * outbuf, size_t * outbytesleft);
+
+
+ +

DESCRIPTION

+ + + + + + +
+

The argument cd must be a conversion descriptor +created using the function iconv_open.

+ +

The main case is when inbuf is not NULL and +*inbuf is not NULL. In this case, the iconv +function converts the multibyte sequence starting at +*inbuf to a multibyte sequence starting at +*outbuf. At most *inbytesleft bytes, starting +at *inbuf, will be read. At most *outbytesleft +bytes, starting at *outbuf, will be written.

+ +

The iconv function converts one multibyte +character at a time, and for each character conversion it +increments *inbuf and decrements *inbytesleft +by the number of converted input bytes, it increments +*outbuf and decrements *outbytesleft by the +number of converted output bytes, and it updates the +conversion state contained in cd. If the character +encoding of the input is stateful, the iconv function +can also convert a sequence of input bytes to an update of +the conversion state without producing any output bytes; +such input is called a shift sequence. The conversion +can stop for four reasons:

+ +

1. An invalid multibyte sequence is encountered in the +input. In this case it sets errno to EILSEQ +and returns (size_t)(−1). *inbuf is left +pointing to the beginning of the invalid multibyte +sequence.

+ +

2. The input byte sequence has been entirely converted, +i.e. *inbytesleft has gone down to 0. In this case +iconv returns the number of non-reversible +conversions performed during this call.

+ +

3. An incomplete multibyte sequence is encountered in the +input, and the input byte sequence terminates after it. In +this case it sets errno to EINVAL and returns +(size_t)(−1). *inbuf is left pointing to the +beginning of the incomplete multibyte sequence.

+ +

4. The output buffer has no more room for the next +converted character. In this case it sets errno to +E2BIG and returns (size_t)(−1).

+ +

A different case is when inbuf is NULL or +*inbuf is NULL, but outbuf is not NULL and +*outbuf is not NULL. In this case, the iconv +function attempts to set cd’s conversion state +to the initial state and store a corresponding shift +sequence at *outbuf. At most *outbytesleft +bytes, starting at *outbuf, will be written. If the +output buffer has no more room for this reset sequence, it +sets errno to E2BIG and returns +(size_t)(−1). Otherwise it increments *outbuf +and decrements *outbytesleft by the number of bytes +written.

+ +

A third case is when inbuf is NULL or +*inbuf is NULL, and outbuf is NULL or +*outbuf is NULL. In this case, the iconv +function sets cd’s conversion state to the +initial state.

+
+ +

RETURN VALUE

+ + + + + +
+

The iconv function returns the number of +characters converted in a non-reversible way during this +call; reversible conversions are not counted. In case of +error, it sets errno and returns +(size_t)(−1).

+
+ +

ERRORS

+ + + + + +
+

The following errors can occur, among others:

+
+ + + + + + + + + + + + + + +
+ +

E2BIG

+		 + +

There is not sufficient room at *outbuf.

+
+ +

EILSEQ

+		 + +

An invalid multibyte sequence has been encountered in +the input.

+
+ +

EINVAL

+		 + +

An incomplete multibyte sequence has been encountered in +the input.

+
+ +

CONFORMING TO

+ + + + + +
+

POSIX:2001

+
+ +

SEE ALSO

+ + + + + +
+

iconv_open(3), iconvctl(3) +iconv_close(3)

+
+
+ + diff --git a/jni/iconv/man/iconv_close.3 b/jni/iconv/man/iconv_close.3 new file mode 100644 index 0000000..1989268 --- /dev/null +++ b/jni/iconv/man/iconv_close.3 @@ -0,0 +1,31 @@ +.\" Copyright (c) Bruno Haible +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 3 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" GNU glibc-2 source code and manual +.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html +.\" +.TH ICONV_CLOSE 3 "March 31, 2007" "GNU" "Linux Programmer's Manual" +.SH NAME +iconv_close \- deallocate descriptor for character set conversion +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int iconv_close (iconv_t " cd ); +.fi +.SH DESCRIPTION +The \fBiconv_close\fP function deallocates a conversion descriptor \fIcd\fP +previously allocated using \fBiconv_open\fP. +.SH "RETURN VALUE" +When successful, the \fBiconv_close\fP function returns 0. In case of error, +it sets \fBerrno\fP and returns \-1. +.SH "CONFORMING TO" +POSIX:2001 +.SH "SEE ALSO" +.BR iconv_open (3) +.BR iconv (3) diff --git a/jni/iconv/man/iconv_close.3.html b/jni/iconv/man/iconv_close.3.html new file mode 100644 index 0000000..a393a03 --- /dev/null +++ b/jni/iconv/man/iconv_close.3.html @@ -0,0 +1,97 @@ + + + + + + +ICONV_CLOSE + + + +

ICONV_CLOSE

+NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+CONFORMING TO
+SEE ALSO
+ +
+ +

NAME

+ + + + + +
+

iconv_close − deallocate descriptor for character +set conversion

+
+ +

SYNOPSIS

+ + + + + +
+
#include <iconv.h>
+
+int iconv_close (iconv_t cd);
+
+
+ +

DESCRIPTION

+ + + + + + +
+

The iconv_close function deallocates a conversion +descriptor cd previously allocated using +iconv_open.

+
+ +

RETURN VALUE

+ + + + + +
+

When successful, the iconv_close function returns +0. In case of error, it sets errno and returns +−1.

+
+ +

CONFORMING TO

+ + + + + +
+

POSIX:2001

+
+ +

SEE ALSO

+ + + + + +
+

iconv_open(3) iconv(3)

+
+
+ + diff --git a/jni/iconv/man/iconv_open.3 b/jni/iconv/man/iconv_open.3 new file mode 100644 index 0000000..4b964f4 --- /dev/null +++ b/jni/iconv/man/iconv_open.3 @@ -0,0 +1,204 @@ +.\" Copyright (c) Bruno Haible +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 3 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" GNU glibc-2 source code and manual +.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html +.\" +.TH ICONV_OPEN 3 "January 24, 2009" "GNU" "Linux Programmer's Manual" +.SH NAME +iconv_open \- allocate descriptor for character set conversion +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "iconv_t iconv_open (const char* " tocode ", const char* " fromcode ); +.fi +.SH DESCRIPTION +The \fBiconv_open\fP function allocates a conversion descriptor suitable +for converting byte sequences from character encoding \fIfromcode\fP to +character encoding \fItocode\fP. +.PP +The values permitted for \fIfromcode\fP and \fItocode\fP and the supported +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,1131}, +Mac{Roman,CentralEurope,Iceland,Croatian,Romania}, +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, CP936, GB18030, EUC\-TW, BIG5, CP950, BIG5\-HKSCS, +BIG5\-HKSCS:2001, BIG5\-HKSCS:1999, 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 +Kazakh +.nf +.fi +PT154, RK1048 +.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 +.nf +.fi +C99, JAVA +.TP +Full Unicode, in terms of \fBuint16_t\fP or \fBuint32_t\fP +(with machine dependent endianness and alignment) +.nf +.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,853,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 +.TP +Chinese +.nf +.fi +BIG5\-2003 (experimental) +.TP +Turkmen +.nf +.fi +TDS565 +.TP +Platform specifics +.nf +.fi +ATARIST, RISCOS\-LATIN1 +.PP +The empty encoding name "" is equivalent to "char": it denotes the +locale dependent character encoding. +.PP +When the string "//TRANSLIT" is appended to \fItocode\fP, transliteration +is activated. This means that when a character cannot be represented in the +target character set, it can be approximated through one or several characters +that look similar to the original character. +.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 +A conversion descriptor contains a conversion state. After creation using +\fBiconv_open\fP, the state is in the initial state. Using \fBiconv\fP +modifies the descriptor's conversion state. (This implies that a conversion +descriptor can not be used in multiple threads simultaneously.) To bring the +state back to the initial state, use \fBiconv\fP with NULL as \fIinbuf\fP +argument. +.SH "RETURN VALUE" +The \fBiconv_open\fP function returns a freshly allocated conversion +descriptor. In case of error, it sets \fBerrno\fP and returns (iconv_t)(\-1). +.SH ERRORS +The following error can occur, among others: +.TP +.B EINVAL +The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the +implementation. +.SH "CONFORMING TO" +POSIX:2001 +.SH "SEE ALSO" +.BR iconv (3) +.BR iconvctl (3) +.BR iconv_close (3) diff --git a/jni/iconv/man/iconv_open.3.html b/jni/iconv/man/iconv_open.3.html new file mode 100644 index 0000000..9232f11 --- /dev/null +++ b/jni/iconv/man/iconv_open.3.html @@ -0,0 +1,602 @@ + + + + + + +ICONV_OPEN + + + +

ICONV_OPEN

+NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +
+ +

NAME

+ + + + + +
+

iconv_open − allocate descriptor for character set +conversion

+
+ +

SYNOPSIS

+ + + + + +
+
#include <iconv.h>
+
+iconv_t iconv_open (const char* tocode, const char* fromcode);
+
+
+ +

DESCRIPTION

+ + + + + + +
+

The iconv_open function allocates a conversion +descriptor suitable for converting byte sequences from +character encoding fromcode to character encoding +tocode.

+ +

The values permitted for fromcode and +tocode and the supported combinations are system +dependent. For the libiconv library, the following encodings +are supported, in all combinations.

+
+ + + + + +
+

European languages

+ + + + + +
+

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,1131}, +Mac{Roman,CentralEurope,Iceland,Croatian,Romania}, +Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh

+
+ + + + + +
+

Semitic languages

+ + + + + +
+

ISO−8859−{6,8}, CP{1255,1256}, CP862, +Mac{Hebrew,Arabic}

+
+ + + + + +
+

Japanese

+ + + + + +
+

EUC−JP, SHIFT_JIS, CP932, ISO−2022−JP, +ISO−2022−JP−2, +ISO−2022−JP−1

+
+ + + + + +
+

Chinese

+ + + + + +
+

EUC−CN, HZ, GBK, CP936, GB18030, EUC−TW, +BIG5, CP950, BIG5−HKSCS, BIG5−HKSCS:2001, +BIG5−HKSCS:1999, ISO−2022−CN, +ISO−2022−CN−EXT

+
+ + + + + + +
+ +

Korean

+		 +
+ + + + + +
+

EUC−KR, CP949, ISO−2022−KR, JOHAB

+
+ + + + + +
+

Armenian

+ + + + + +
+

ARMSCII−8

+
+ + + + + +
+

Georgian

+ + + + + +
+

Georgian−Academy, Georgian−PS

+
+ + + + + + +
+ +

Tajik

+		 +
+ + + + + +
+

KOI8−T

+
+ + + + + + +
+ +

Kazakh

+		 +
+ + + + + +
+

PT154, RK1048

+
+ + + + + + +
+ +

Thai

+		 +
+ + + + + +
+

TIS−620, CP874, MacThai

+
+ + + + + +
+

Laotian

+ + + + + +
+

MuleLao−1, CP1133

+
+ + + + + +
+

Vietnamese

+ + + + + +
+

VISCII, TCVN, CP1258

+
+ + + + + +
+

Platform specifics

+ + + + + +
+

HP−ROMAN8, NEXTSTEP

+
+ + + + + +
+

Full Unicode

+ + + + + +
+

UTF−8

+ +

UCS−2, UCS−2BE, UCS−2LE

+ +

UCS−4, UCS−4BE, UCS−4LE

+ +

UTF−16, UTF−16BE, UTF−16LE

+ +

UTF−32, UTF−32BE, UTF−32LE

+ +

UTF−7

+ +

C99, JAVA

+
+ + + + + +
+

Full Unicode, in terms of uint16_t or +uint32_t

+ + + + + +
+

(with machine dependent endianness and alignment)

+ +

UCS−2−INTERNAL, +UCS−4−INTERNAL

+
+ + + + + +
+

Locale dependent, in terms of char or +wchar_t

+ + + + + +
+

(with machine dependent endianness and alignment, and +with semantics depending on the OS and the current LC_CTYPE +locale facet)

+ +

char, wchar_t

+
+ + + + + +
+

When configured with the option +−−enable−extra−encodings, it +also provides support for a few extra encodings:

+
+ + + + + +
+

European languages

+ + + + + +
+
CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
+
+
+ + + + + + +
+

Semitic languages

+ + + + + +
+

CP864

+
+ + + + + +
+

Japanese

+ + + + + +
+

EUC−JISX0213, Shift_JISX0213, +ISO−2022−JP−3

+
+ + + + + +
+

Chinese

+ + + + + +
+

BIG5−2003 (experimental)

+
+ + + + + +
+

Turkmen

+ + + + + +
+

TDS565

+
+ + + + + +
+

Platform specifics

+ + + + + +
+

ATARIST, RISCOS−LATIN1

+
+ + + + + +
+

The empty encoding name "" is equivalent to +"char": it denotes the locale dependent character +encoding.

+ +

When the string "//TRANSLIT" is appended to +tocode, transliteration is activated. This means that +when a character cannot be represented in the target +character set, it can be approximated through one or several +characters that look similar to the original character.

+ +

When the string "//IGNORE" is appended to +tocode, characters that cannot be represented in the +target character set will be silently discarded.

+ +

The resulting conversion descriptor can be used with +iconv any number of times. It remains valid until +deallocated using iconv_close.

+ +

A conversion descriptor contains a conversion state. +After creation using iconv_open, the state is in the +initial state. Using iconv modifies the +descriptor’s conversion state. (This implies that a +conversion descriptor can not be used in multiple threads +simultaneously.) To bring the state back to the initial +state, use iconv with NULL as inbuf +argument.

+
+ +

RETURN VALUE

+ + + + + +
+

The iconv_open function returns a freshly +allocated conversion descriptor. In case of error, it sets +errno and returns (iconv_t)(−1).

+
+ +

ERRORS

+ + + + + +
+

The following error can occur, among others:

+
+ + + + + + + +
+ +

EINVAL

+		 + +

The conversion from fromcode to tocode is +not supported by the implementation.

+
+ +

CONFORMING TO

+ + + + + +
+

POSIX:2001

+
+ +

SEE ALSO

+ + + + + +
+

iconv(3) iconvctl(3) +iconv_close(3)

+
+
+ + diff --git a/jni/iconv/man/iconv_open_into.3 b/jni/iconv/man/iconv_open_into.3 new file mode 100644 index 0000000..92c2d53 --- /dev/null +++ b/jni/iconv/man/iconv_open_into.3 @@ -0,0 +1,47 @@ +.\" Copyright (c) Bruno Haible +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 3 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" iconv.h +.\" +.TH ICONV_OPEN_INTO 3 "September 21, 2008" "GNU" "Linux Programmer's Manual" +.SH NAME +iconv_open_into \- initialize descriptor for character set conversion +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int iconv_open_into (const char* " tocode ", const char* " fromcode "," +.BI " iconv_allocation_t* " resultp ); +.fi +.SH DESCRIPTION +The \fBiconv_open_into\fP function initializes a conversion descriptor suitable +for converting byte sequences from character encoding \fIfromcode\fP to +character encoding \fItocode\fP. The conversion descriptor is stored in the +memory pointed to by \fIresultp\fP. +.PP +The values permitted for \fIfromcode\fP and \fItocode\fP are the same as for +the function \fBiconv_open\fP. +.PP +After a successful return from this function, \fIresultp\fP can be be used +as an \fBiconv_t\fP object with the \fBiconv\fP function. +.SH "RETURN VALUE" +The \fBiconv_open_into\fP function fills \fB*\fP\fIresultp\fP and returns 0 if +it succeeds. In case of error, it sets \fBerrno\fP and returns \-1. +.SH ERRORS +The following error can occur, among others: +.TP +.B EINVAL +The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the +implementation. +.SH "CONFORMING TO" +This function is implemented only in GNU libiconv and not in other \fBiconv\fP +implementations. It is not backed by a standard. You can test for its presence +through \fB(_LIBICONV_VERSION >= 0x010D)\fP. +.SH "SEE ALSO" +.BR iconv_open (3) +.BR iconv (3) diff --git a/jni/iconv/man/iconv_open_into.3.html b/jni/iconv/man/iconv_open_into.3.html new file mode 100644 index 0000000..6ed9f08 --- /dev/null +++ b/jni/iconv/man/iconv_open_into.3.html @@ -0,0 +1,120 @@ + + + + +ICONV_OPEN_INTO + + + +

ICONV_OPEN_INTO

+NAME
+SYNOPSIS
+DESCRIPTION
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +
+ + + +

NAME

+ + +
+iconv_open_into - initialize descriptor for character set conversion
+ +

SYNOPSIS

+ + + +
+
#include <iconv.h>
+
+int iconv_open_into (const char* tocode, const char* fromcode,
+                     iconv_allocation_t* resultp);
+
+ +

DESCRIPTION

+ + + +
+The iconv_open_into function initializes a conversion +descriptor suitable for converting byte sequences from +character encoding fromcode to character encoding +tocode. The conversion descriptor is stored in the +memory pointed to by resultp.
+ + + +
+The values permitted for fromcode and tocode +are the same as for the function +iconv_open.
+ + + +
+After a successful return from this function, resultp +can be be used as an iconv_t object with the +iconv function.
+ +

RETURN VALUE

+ + + +
+The iconv_open_into function fills +*resultp and returns 0 if it succeeds. In case +of error, it sets errno and returns -1.
+ +

ERRORS

+ + + +
+The following error can occur, among others:
+ + + +
+EINVAL
+ + + +
+The conversion from fromcode to tocode is not +supported by the implementation.
+ +

CONFORMING TO

+ + + +
+This function is implemented only in GNU libiconv and not in +other iconv implementations. It is not backed by a +standard. You can test for its presence through +(_LIBICONV_VERSION >= 0x010D).
+ +

SEE ALSO

+ + + +
+iconv_open(3) iconv(3)
+
+ + diff --git a/jni/iconv/man/iconvctl.3 b/jni/iconv/man/iconvctl.3 new file mode 100755 index 0000000..6caf394 --- /dev/null +++ b/jni/iconv/man/iconvctl.3 @@ -0,0 +1,67 @@ +.\" Copyright (c) Perry Rapp +.\" Copyright (c) Bruno Haible +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 3 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" iconv.h +.\" +.TH ICONVCTL 3 "March 31, 2007" "GNU" "Linux Programmer's Manual" +.SH NAME +iconvctl \- control iconv behavior +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int iconvctl (iconv_t " cd " , int " request ", void * " argument ); +.fi +.SH DESCRIPTION +The argument \fIcd\fP must be a conversion descriptor created using the +function \fBiconv_open\fP. +.PP +\fBiconvctl\fP queries or adjusts the behavior of the \fBiconv\fP function, +when invoked with the specified conversion descriptor, depending on the +request value. +.SH "REQUEST VALUES" +The following are permissible values for the \fIrequest\fP parameter. +.TP +.B ICONV_TRIVIALP +\fIargument\fP should be an \fBint *\fP which will receive 1 if the +conversion is trivial, or 0 otherwise. +.TP +.B ICONV_GET_TRANSLITERATE +\fIargument\fP should be an \fBint *\fP which will receive 1 if +transliteration is enabled in the conversion, or 0 otherwise. +.TP +.B ICONV_SET_TRANSLITERATE +\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value. +A non-zero value is used to enable transliteration in the conversion. A zero +value disables it. +.TP +.B ICONV_GET_DISCARD_ILSEQ +\fIargument\fP should be an \fBint *\fP which will receive 1 if +"illegal sequence discard and continue" is enabled in the conversion, +or 0 otherwise. +.TP +.B ICONV_SET_DISCARD_ILSEQ +\fIargument\fP should be a \fBconst int *\fP, pointing to an \fBint\fP value. +A non-zero value is used to enable "illegal sequence discard and continue" +in the conversion. A zero value disables it. +.SH "RETURN VALUE" +The \fBiconvctl\fP function returns 0 if it succeeds. In case of error, it sets +\fBerrno\fP and returns \-1. +.SH ERRORS +The following errors can occur, among others: +.TP +.B EINVAL +The request is invalid. +.SH "CONFORMING TO" +This function is implemented only in GNU libiconv and not in other \fBiconv\fP +implementations. It is not backed by a standard. You can test for its presence +through \fB(_LIBICONV_VERSION >= 0x0108)\fP. +.SH "SEE ALSO" +.BR iconv_open (3) +.BR iconv (3) diff --git a/jni/iconv/man/iconvctl.3.html b/jni/iconv/man/iconvctl.3.html new file mode 100644 index 0000000..05f1529 --- /dev/null +++ b/jni/iconv/man/iconvctl.3.html @@ -0,0 +1,189 @@ + + + + +ICONVCTL + + + +

ICONVCTL

+NAME
+SYNOPSIS
+DESCRIPTION
+REQUEST VALUES
+RETURN VALUE
+ERRORS
+CONFORMING TO
+SEE ALSO
+ +
+ + + +

NAME

+ + +
+iconvctl - control iconv behavior
+ +

SYNOPSIS

+ + + +
+
#include <iconv.h>
+
+int iconvctl (iconv_t cd , int request, void * argument);
+
+ +

DESCRIPTION

+ + + +
+The argument cd must be a conversion descriptor +created using the function iconv_open.
+ + + +
+iconvctl queries or adjusts the behavior of the +iconv function, when invoked with the specified +conversion descriptor, depending on the request +value.
+ +

REQUEST VALUES

+ + + +
+The following are permissible values for the request +parameter.
+ + + +
+ICONV_TRIVIALP
+ + + +
+argument should be an int * which will receive +1 if the conversion is trivial, or 0 otherwise.
+ + + +
+ICONV_GET_TRANSLITERATE
+ + + +
+argument should be an int * which will receive +1 if transliteration is enabled in the conversion, or 0 +otherwise.
+ + + +
+ICONV_SET_TRANSLITERATE
+ + + +
+argument should be a const int *, pointing to +an int value. A non-zero value is used to enable +transliteration in the conversion. A zero value disables +it.
+ + + +
+ICONV_GET_DISCARD_ILSEQ
+ + + +
+argument should be an int * which will receive +1 if "illegal sequence discard and continue" is +enabled in the conversion, or 0 otherwise.
+ + + +
+ICONV_SET_DISCARD_ILSEQ
+ + + +
+argument should be a const int *, pointing to +an int value. A non-zero value is used to enable +"illegal sequence discard and continue" in the +conversion. A zero value disables it.
+ +

RETURN VALUE

+ + + +
+The iconvctl function returns 0 if it succeeds. In +case of error, it sets errno and returns +-1.
+ +

ERRORS

+ + + +
+The following errors can occur, among others:
+ + + +
+EINVAL
+ + + +
+The request is invalid.
+ +

CONFORMING TO

+ + + +
+This function is implemented only in GNU libiconv and not in +other iconv implementations. It is not backed by a +standard. You can test for its presence through +(_LIBICONV_VERSION >= 0x0108).
+ +

SEE ALSO

+ + + +
+iconv_open(3), iconv(3)
+
+ + -- cgit v1.2.3-70-g09d2