ICONVCTL(3) Linux Programmer's Manual ICONVCTL(3)

NAME
       iconvctl - control iconv behavior

SYNOPSIS
       ##iinncclluuddee <>

       iinntt iiccoonnvvccttll ((iiccoonnvvtt cd ,, iinntt request,, vvooiidd ** argument));;

DESCRIPTION
       The argument cd must be a conversion descriptor created using the func-
       tion iiccoonnvvooppeenn.

       iiccoonnvvccttll queries or adjusts the behavior of the  iiccoonnvv  function,  when
       invoked  with  the  specified  conversion  descriptor, depending on the
       request value.

RREEQQUUEESSTT VVAALLUUEESS
       The following are permissible values for the request parameter.

       IICCOONNVVTTRRIIVVIIAALLPP
              argument should be an iinntt ** which will receive 1 if the  conver-
              sion is trivial, or 0 otherwise.

       IICCOONNVVGGEETTTTRRAANNSSLLIITTEERRAATTEE
              argument should be an iinntt ** which will receive 1 if translitera-
              tion is enabled in the conversion, or 0 otherwise.

       IICCOONNVVSSEETTTTRRAANNSSLLIITTEERRAATTEE
              argument should be a ccoonnsstt iinntt **, pointing to an iinntt  value.   A
              non-zero  value is used to enable transliteration in the conver-
              sion. A zero value disables it.

       IICCOONNVVGGEETTDDIISSCCAARRDDIILLSSEEQQ
              argument should be an iinntt ** which will  receive  1  if  "illegal
              sequence  discard and continue" is enabled in the conversion, or
              0 otherwise.

       IICCOONNVVSSEETTDDIISSCCAARRDDIILLSSEEQQ
              argument should be a ccoonnsstt iinntt **, pointing to an iinntt  value.   A
              non-zero  value  is used to enable "illegal sequence discard and
              continue" in the conversion. A zero value disables it.

RREETTUURRNN VVAALLUUEE
       The iiccoonnvvccttll function returns 0 if it succeeds. In case  of  error,  it
       sets eerrrrnnoo and returns -1.

EERRRROORRSS
       The following errors can occur, among others:

       EEIINNVVAALL The request is invalid.

CCOONNFFOORRMMIINNGG TTOO
       This  function  is  implemented  only  in GNU libiconv and not in other
       iiccoonnvv implementations. It is not backed by a standard. You can test for
       its presence through ((LLIIBBIICCOONNVVVVEERRSSIIOONN >>== 00xx00110088)).

SEE ALSO
       iiccoonnvvooppeenn(3), iiccoonnvv(3)



GNU                            February 2, 2004                    ICONVCTL(3)