iconvctl(3)

ICONVCTL(3)            C LIBRARY FUNCTIONS            ICONVCTL(3)

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  func-
     tion, when invoked with the specified conversion descriptor,
     depending on the request value.

REQUEST VALUES

     The following are permissible values for the request parame-
     ter.

     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 oth-
          erwise.

     ICONV_SET_TRANSLITERATE
          argument should be a const int *, pointing  to  an  int
          value.  A non-zero value is used to enable translitera-
          tion 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:

GNU                Last change: March 31, 2007                  1

ICONVCTL(3)            C LIBRARY FUNCTIONS            ICONVCTL(3)

     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)

GNU                Last change: March 31, 2007                  2