gtk_source_encoding_new ()

GtkSourceEncoding *
gtk_source_encoding_new (const gchar *charset);

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

The gtk_source_encoding_get_charset() function will return exactly the same string as the charset passed in to this constructor.

Since: 299.6

gtk_source_encoding_new_utf8 ()

GtkSourceEncoding *
gtk_source_encoding_new_utf8 (void);

Creates a new GtkSourceEncoding with the "UTF-8" character set.

Since: 299.6

gtk_source_encoding_new_from_locale ()

GtkSourceEncoding *
gtk_source_encoding_new_from_locale (void);

Creates a new GtkSourceEncoding from the current locale, as returned by g_get_charset().

Since: 299.6

gtk_source_encoding_copy ()

GtkSourceEncoding *
gtk_source_encoding_copy (const GtkSourceEncoding *enc);

Since: 299.6

gtk_source_encoding_copy_func ()

gpointer
gtk_source_encoding_copy_func (gconstpointer src,
                               gpointer data);

A GCopyFunc provided for convenience. It does the same as gtk_source_encoding_copy(). It is useful for example for g_slist_copy_deep().

Since: 299.6

gtk_source_encoding_free ()

void
gtk_source_encoding_free (GtkSourceEncoding *enc);

Since: 299.6

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".

Since: 299.6

gtk_source_encoding_has_known_charset ()

gboolean
gtk_source_encoding_has_known_charset (const GtkSourceEncoding *enc);

Returns TRUE if enc has a charset known by GtkSourceEncoding. In other words: if enc is equal to an encoding returned by gtk_source_encoding_get_all().

When the charset string comes from an untrusted source, it can be desirable to check it.

Since: 299.6

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". If the charset is unknown by GtkSourceEncoding, "Unknown" is returned. The return value is already translated by gettext.

Since: 299.6

gtk_source_encoding_to_string ()

gchar *
gtk_source_encoding_to_string (const GtkSourceEncoding *enc);

Returns the encoding name with the charset in parenthesis, for example "Unicode (UTF-8)". If the name is unknown, just the charset is returned. The name is translated by gettext.

Since: 299.6

gtk_source_encoding_is_utf8 ()

gboolean
gtk_source_encoding_is_utf8 (const GtkSourceEncoding *enc);

Returns whether enc is a UTF-8 encoding.

If enc was created with gtk_source_encoding_new_utf8(), the charset is "UTF-8". But iconv supports other variants: "UTF8", "utf-8" and "utf8". This function returns TRUE for all UTF-8 variants supported by iconv.

Since: 299.6

gtk_source_encoding_is_locale ()

gboolean
gtk_source_encoding_is_locale (const GtkSourceEncoding *enc);

Since: 299.6

gtk_source_encoding_equals ()

gboolean
gtk_source_encoding_equals (const GtkSourceEncoding *enc1,
                            const GtkSourceEncoding *enc2);

Returns whether enc1 and enc2 are equal. It returns TRUE if and only if:

Since: 299.6

gtk_source_encoding_compare_func ()

gint
gtk_source_encoding_compare_func (gconstpointer a,
                                  gconstpointer b);

A GCompareFunc provided for convenience. When 0 is returned it means that the two encodings are equal according to gtk_source_encoding_equals().

It is useful for example for g_slist_find_custom().

Since: 299.6

gtk_source_encoding_get_all ()

GSList *
gtk_source_encoding_get_all (void);

Gets a list of all encodings known by GtkSourceEncoding.

Since: 299.6

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.

Note that the returned list doesn't contain all encodings known by GtkSourceEncoding, it is a limited list that contains only the encodings that have the most likelihood to fit for the current locale.

Since: 299.6

gtk_source_encoding_remove_duplicates ()

GSList *
gtk_source_encoding_remove_duplicates (GSList *list,
                                       GtkSourceEncodingDuplicates removal_type);

A convenience function to remove duplicated encodings in a list.

Since: 299.6

GtkSourceEncoding

typedef struct _GtkSourceEncoding GtkSourceEncoding;

enum GtkSourceEncodingDuplicates

Specifies which GtkSourceEncoding occurrence to keep when removing duplicated encodings in a list with gtk_source_encoding_remove_duplicates().

Since: 299.6