GtkSourceEncoding

GtkSourceEncoding — Character encoding

Functions

Types and Values

Object Hierarchy

    GBoxed
    ╰── GtkSourceEncoding

Includes

#include <gtksourceview/gtksource.h>

Description

The GtkSourceEncoding boxed type represents a character encoding. It is used for example by GtkSourceFile. Note that the text in GTK+ widgets is always encoded in UTF-8.

Functions

gtk_source_encoding_get_utf8 ()

const GtkSourceEncoding *
gtk_source_encoding_get_utf8 (void);

Returns

the UTF-8 encoding.

Since: 3.14


gtk_source_encoding_get_current ()

const GtkSourceEncoding *
gtk_source_encoding_get_current (void);

Gets the GtkSourceEncoding for the current locale. See also g_get_charset().

Returns

the current locale encoding.

Since: 3.14


gtk_source_encoding_get_from_charset ()

const GtkSourceEncoding *
gtk_source_encoding_get_from_charset (const gchar *charset);

Gets a GtkSourceEncoding from a character set such as "UTF-8" or "ISO-8859-1".

Parameters

charset

a character set.

 

Returns

the corresponding GtkSourceEncoding, or NULL if not found.

[nullable]

Since: 3.14


gtk_source_encoding_to_string ()

gchar *
gtk_source_encoding_to_string (const GtkSourceEncoding *enc);

Parameters

enc

a GtkSourceEncoding.

 

Returns

a string representation. Free with g_free() when no longer needed.

Since: 3.14


gtk_source_encoding_get_name ()

const gchar *
gtk_source_encoding_get_name (const GtkSourceEncoding *enc);

Gets the name of the GtkSourceEncoding such as "Unicode" or "Western".

Parameters

enc

a GtkSourceEncoding.

 

Returns

the name of the GtkSourceEncoding.

Since: 3.14


gtk_source_encoding_get_charset ()

const gchar *
gtk_source_encoding_get_charset (const GtkSourceEncoding *enc);

Gets the character set of the GtkSourceEncoding, such as "UTF-8" or "ISO-8859-1".

Parameters

enc

a GtkSourceEncoding.

 

Returns

the character set of the GtkSourceEncoding.

Since: 3.14


gtk_source_encoding_get_all ()

GSList *
gtk_source_encoding_get_all (void);

Gets all encodings.

Returns

a list of all GtkSourceEncoding's. Free with g_slist_free().

[transfer container][element-type GtkSource.Encoding]

Since: 3.14


gtk_source_encoding_get_default_candidates ()

GSList *
gtk_source_encoding_get_default_candidates
                               (void);

Gets the list of default candidate encodings to try when loading a file. See gtk_source_file_loader_set_candidate_encodings().

This function returns a different list depending on the current locale (i.e. language, country and default encoding). The UTF-8 encoding and the current locale encoding are guaranteed to be present in the returned list.

Returns

the list of default candidate encodings. Free with g_slist_free().

[transfer container][element-type GtkSource.Encoding]

Since: 3.18


gtk_source_encoding_copy ()

GtkSourceEncoding *
gtk_source_encoding_copy (const GtkSourceEncoding *enc);

Used by language bindings.

Parameters

enc

a GtkSourceEncoding.

 

Returns

a copy of enc .

Since: 3.14


gtk_source_encoding_free ()

void
gtk_source_encoding_free (GtkSourceEncoding *enc);

Used by language bindings.

Parameters

enc

a GtkSourceEncoding.

 

Since: 3.14

Types and Values

GtkSourceEncoding

typedef struct _GtkSourceEncoding GtkSourceEncoding;

See Also

GtkSourceFileSaver, GtkSourceFileLoader