iconv_open(3C) — DG/UX R4.11



iconv_open(3C)                    SDK R4.11                   iconv_open(3C)


NAME
       iconvopen - code conversion allocation function.

SYNOPSIS
       #include <iconv.h>
       iconvt iconvopen(const char *tocode, const char *fromcode);

DESCRIPTION
       iconvopen returns a conversion descriptor for the codeset conversion
       from codeset fromcode to codeset tocode. This descriptor is used on
       subsequent calls to iconv.

       The allowable values for fromcode and tocode are dependent on the
       implementation. This is also true for the different combinations
       allowed.

       A conversion descriptor is valid until the creating process
       terminates, or until it is passed to iconvclose.

   Return Values
       If iconvopen completes successfully, a conversion descriptor is
       returned.  Should the function fail,iconvopen returns (iconvt)-1
       and errno is set to indicate an error.

   Errors
       EMFILE    There may be no more file descriptors free for the process.

       ENFILE    There may be too many open files on the system.

       ENOMEM    Not enough memory.

       EINVAL    The implementation does not support the specified
                 conversion.

REFERENCES
       iconv(3C), iconvclose(3C)

NOTICES
       In some implementations, this function uses dynamic memory allocation
       (malloc) to provide space for internal buffer areas.  If there is not
       enough space to cater for these buffers, it is likely that the
       iconvopen function will fail.

       Applications that are portable must assume that conversion
       descriptors are invalidated after one of the exec functions is
       called.


Licensed material--property of copyright holder(s)
Museum
