Function

GLibiconv

Declaration [src]

gsize
g_iconv (
  GIConv converter,
  gchar** inbuf,
  gsize* inbytes_left,
  gchar** outbuf,
  gsize* outbytes_left
)

Description [src]

Same as the standard UNIX routine iconv(), but may be implemented via libiconv on UNIX flavors that lack a native implementation.

GLib provides g_convert() and g_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

converter GIConv
 

Conversion descriptor from g_iconv_open()

inbuf gchar**
 

Bytes to convert.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
inbytes_left gsize*
 

Inout parameter, bytes remaining to convert in inbuf.

 The data is owned by the caller of the function.
outbuf gchar**
 

Converted output bytes.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
outbytes_left gsize*
 

Inout parameter, bytes available to fill in outbuf.

 The data is owned by the caller of the function.

Return value

Returns: gsize
 

Count of non-reversible conversions, or -1 on error.