GflsUtf8AutoConverter: libgedit-gfls 1 Reference Manual

GflsUtf8AutoConverter

GflsUtf8AutoConverter — Encoding auto-detection and conversion to UTF-8

Functions

GflsUtf8AutoConverter *	gfls_utf8_auto_converter_new ()
void	gfls_utf8_auto_converter_free ()
GflsValidatedString *	gfls_utf8_auto_converter_get_validated_string ()
const GflsEncoding *	gfls_utf8_auto_converter_get_chosen_encoding ()
gboolean	gfls_utf8_auto_converter_get_lossy_conversion ()

Types and Values

GflsUtf8AutoConverter

Includes

#include <gfls/gfls.h>

Description

Work-in-progress.

Functions

gfls_utf8_auto_converter_new ()

GflsUtf8AutoConverter *
gfls_utf8_auto_converter_new (GBytes *input_bytes,
                              GSList *candidate_encodings,
                              gboolean allow_invalid_bytes);

[skip]

Parameters

input_bytes	the input data.
candidate_encodings	a list of GflsEncoding's.	[element-type GflsEncoding]
allow_invalid_bytes	whether to allow invalid bytes during the conversion.

Returns

a new GflsUtf8AutoConverter.

[transfer full]

Since: 0.5

gfls_utf8_auto_converter_free ()

void
gfls_utf8_auto_converter_free (GflsUtf8AutoConverter *auto_converter);

Frees auto_converter .

Parameters

auto_converter

a GflsUtf8AutoConverter.

[nullable]

Since: 0.5

gfls_utf8_auto_converter_get_validated_string ()

GflsValidatedString *
gfls_utf8_auto_converter_get_validated_string
                               (GflsUtf8AutoConverter *auto_converter);

Returns the converted data.

NULL can be returned if invalid bytes are disallowed.

Parameters

auto_converter

a GflsUtf8AutoConverter.

Returns

the converted data.

[transfer none][nullable]

Since: 0.5

gfls_utf8_auto_converter_get_chosen_encoding ()

const GflsEncoding *
gfls_utf8_auto_converter_get_chosen_encoding
                               (GflsUtf8AutoConverter *auto_converter);

Returns the auto-detected GflsEncoding.

NULL can be returned if invalid bytes are disallowed.

Parameters

auto_converter

a GflsUtf8AutoConverter.

Returns

the auto-detected GflsEncoding.

[transfer none][nullable]

Since: 0.5

gfls_utf8_auto_converter_get_lossy_conversion ()

gboolean
gfls_utf8_auto_converter_get_lossy_conversion
                               (GflsUtf8AutoConverter *auto_converter);

Returns whether the conversion was lossy for the result as returned by gfls_utf8_auto_converter_get_validated_string().

Parameters

auto_converter

a GflsUtf8AutoConverter.

Returns

whether GFLS_ICONV_RESULT_LOSSY_CONVERSION was encountered.

Since: 0.5

Types and Values

GflsUtf8AutoConverter

typedef struct _GflsUtf8AutoConverter GflsUtf8AutoConverter;