gfls_encoding_try_convert ()

gboolean
gfls_encoding_try_convert (GBytes *input_bytes,
                           const gchar *to_codeset,
                           const gchar *from_codeset);

Tries a conversion on input_bytes , discarding the output.

from_codeset and to_codeset must be compatible with iconv, see gfls_iconv_open().

If input_bytes ends with an incomplete multi-byte character, that part is ignored. So input_bytes can be for example the first chunk of a file when loading it.

Since: 0.4

gfls_encoding_convert ()

gboolean
gfls_encoding_convert (GBytes *input_bytes,
                       const gchar *to_codeset,
                       const gchar *from_codeset,
                       gboolean allow_invalid_characters,
                       GBytes **output_bytes,
                       GflsBytesRegion **output_bytes_valid_region,
                       GError **error);

This function converts input_bytes from a codeset to another.

from_codeset and to_codeset must be compatible with iconv, see gfls_iconv_open().

Note that from_codeset and to_codeset can be equal. It is useful to identify the valid characters from the invalid ones.

The output is the combination of output_bytes and output_bytes_valid_region . Output bytes that are part of output_bytes_valid_region are the valid characters (successfully converted). The other output bytes are invalid characters (copied as is from input_bytes ).

If allow_invalid_characters is FALSE:

Since: 0.4