GCharsetConverter

GCharsetConverter — Convert between charsets

Functions

Properties

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

Types and Values

Object Hierarchy

    GObject
    ╰── GCharsetConverter

Implemented Interfaces

GCharsetConverter implements GConverter and GInitable.

Includes

#include <gio/gio.h>

Description

GCharsetConverter is an implementation of GConverter based on GIConv.

Functions

g_charset_converter_new ()

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

Creates a new GCharsetConverter.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

converter

a GCharsetConverter

 

Returns

the number of fallbacks that converter has applied

Since: 2.24

Types and Values

GCharsetConverter

typedef struct _GCharsetConverter GCharsetConverter;

Conversions between character sets.

Property Details

The “from-charset” property

  “from-charset”             gchar *

The character encoding to convert from.

Flags: Read / Write / Construct Only

Default value: NULL


The “to-charset” property

  “to-charset”               gchar *

The character encoding to convert to.

Flags: Read / Write / Construct Only

Default value: NULL


The “use-fallback” property

  “use-fallback”             gboolean

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

Flags: Read / Write / Construct

Default value: FALSE