Encoding

class Encoding(*args, **kwargs)

Character encoding.

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

Methods

class Encoding

free() → None

Used by language bindings.

classmethod get_all() → list[Encoding]

Gets all encodings.

get_charset() → str

Gets the character set of the Encoding, such as “UTF-8” or “ISO-8859-1”.

classmethod get_current() → Encoding

Gets the Encoding for the current locale.

See also get_charset.

classmethod get_default_candidates() → list[Encoding]

Gets the list of default candidate encodings to try when loading a file.

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

classmethod get_from_charset() → Encoding | None

Gets a Encoding from a character set such as “UTF-8” or “ISO-8859-1”.

get_name() → str

Gets the name of the Encoding such as “Unicode” or “Western”.

classmethod get_utf8() → Encoding

to_string() → str