## GCharsetConverter

GCharsetConverter — Convert between charsets

## Synopsis

    #include <gio/gio.h>

                        GCharsetConverter;
    GCharsetConverter * g_charset_converter_new             (const gchar *to_charset,
                                                             const gchar *from_charset,
                                                             GError **error);
    void                g_charset_converter_set_use_fallback
                                                            (GCharsetConverter *converter,
                                                             gboolean use_fallback);
    gboolean            g_charset_converter_get_use_fallback
                                                            (GCharsetConverter *converter);
    guint               g_charset_converter_get_num_fallbacks
                                                            (GCharsetConverter *converter);

## Object Hierarchy

      GObject
       +----GCharsetConverter

## Implemented Interfaces

GCharsetConverter implements GConverter and GInitable.

## Properties

      "from-charset"             gchar*                : Read / Write / Construct Only
      "to-charset"               gchar*                : Read / Write / Construct Only
      "use-fallback"             gboolean              : Read / Write / Construct

## Description

GCharsetConverter is an implementation of GConverter based on GIConv.

## Details

### GCharsetConverter

    typedef struct _GCharsetConverter GCharsetConverter;

Conversions between character sets.

### g_charset_converter_new ()

    GCharsetConverter * g_charset_converter_new             (const gchar *to_charset,
                                                             const gchar *from_charset,
                                                             GError **error);

Creates a new GCharsetConverter.

`to_charset` : | destination charset
`from_charset` : | source charset
`error` : | GError for error reporting, or `NULL` to ignore.
Returns : | a new GCharsetConverter or `NULL` on error.

Since 2.24

### g_charset_converter_set_use_fallback ()

    void                g_charset_converter_set_use_fallback
                                                            (GCharsetConverter *converter,
                                                             gboolean use_fallback);

Sets the "use-fallback" property.

`converter` : | a GCharsetConverter
`use_fallback` : | `TRUE` to use fallbacks

Since 2.24

### g_charset_converter_get_use_fallback ()

    gboolean            g_charset_converter_get_use_fallback
                                                            (GCharsetConverter *converter);

Gets the "use-fallback" property.

`converter` : | a GCharsetConverter
Returns : | `TRUE` if fallbacks are used by `converter`

Since 2.24

### g_charset_converter_get_num_fallbacks ()

    guint               g_charset_converter_get_num_fallbacks
                                                            (GCharsetConverter *converter);

Gets the number of fallbacks that `converter` has applied so far.

`converter` : | a GCharsetConverter
Returns : | the number of fallbacks that `converter` has applied

Since 2.24

## Property Details

### The `"from-charset"` property

      "from-charset"             gchar*                : Read / Write / Construct Only

The character encoding to convert from.

Default value: NULL

### The `"to-charset"` property

      "to-charset"               gchar*                : Read / Write / Construct Only

The character encoding to convert to.

Default value: NULL

### The `"use-fallback"` property

      "use-fallback"             gboolean              : Read / Write / Construct

Use fallback (of form \<hexval>) for invalid bytes.

Default value: FALSE