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.

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

get_current() → Encoding

Gets the Encoding for the current locale.

See also get_charset.

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.

get_from_charset(charset: str) → Encoding | None

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

Parameters:: charset – a character set.

get_name() → str: Gets the name of the Encoding such as “Unicode” or “Western”.

get_utf8() → Encoding

to_string() → str