iconv


Description:

[ 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.

Parameters:

inbuf

bytes to convert

inbytes_left

inout parameter, bytes remaining to convert in inbuf

outbuf

converted output bytes

outbytes_left

inout parameter, bytes available to fill in outbuf

converter

conversion descriptor from open

Returns:

count of non-reversible conversions, or -1 on error