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.

See iconv(3posix) and iconv(3) for more details about behavior when an error occurs.

This function is not directly available to language bindings.

Parameters

converter

Type: GIConv

Conversion descriptor from g_iconv_open().

inbuf

Type: gchar**

Bytes to convert.

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

Type: gsize*

Inout parameter, bytes remaining to convert in inbuf.

The argument will be modified by the function.
outbuf

Type: gchar**

Converted output bytes.

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

Type: gsize*

Inout parameter, bytes available to fill in outbuf.

The argument will be modified by the function.

Return value

Type: gsize

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