Same as the standard UNIX routine iconv
, but may be implemented via libiconv on UNIX flavors that lack a native
implementation.
GLib provides convert and locale_to_utf8 which are likely more convenient than the raw iconv wrappers.
Note that the behaviour of iconv
for characters which are valid in the input character set, but which have no representation
in the output character set, is implementation defined. This function may return success (with a positive number of non-reversible
conversions as replacement characters were used), or it may return -1 and set an error such as eilseq,
in such a situation.
inbuf |
bytes to convert |
inbytes_left |
inout parameter, bytes remaining to convert in |
outbuf |
converted output bytes |
outbytes_left |
inout parameter, bytes available to fill in |
converter |
conversion descriptor from open |
count of non-reversible conversions, or -1 on error |