[ CCode ( cname = "g_iconv" ) ]
public size_t iconv (ref char[] inbuf, ref size_t inbytes_left, ref char[] outbuf, ref size_t outbytes_left)
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.
See [`iconv(3posix)`](man:iconv(3posix)) and [`iconv(3)`](man:iconv(3)) for more details about behavior when an error occurs.
| 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 |