gwyentities

gwyentities — Transform SGML-like symbol entities to UTF-8 and back.

Synopsis




struct      GwyTextEntity;
gchar*      gwy_entities_entity_to_utf8     (const gchar *entity);
gchar*      gwy_entities_text_to_utf8       (const gchar *text);
GwyTextEntity* gwy_entities_get_entities    (void);

Description

A subset of named SGML-like symbol entities (e.g. α), to be used namely in GwySciText.

Function gwy_entities_entity_to_utf8() converts a signle entity to UTF-8, function Function gwy_entities_text_to_utf8() converts a text containing entities to UTF-8. A list of all available entities can be obtained with gwy_entities_get_entities().

Details

struct GwyTextEntity

struct GwyTextEntity {

    const gchar *entity;
    const gchar *utf8;
};

The type of text entity data.

const gchar *entity Bare entity name, without the leading ampersand and trailing semicolon.
const gchar *utf8 The corresponding character, in UTF-8.

gwy_entities_entity_to_utf8 ()

gchar*      gwy_entities_entity_to_utf8     (const gchar *entity);

Converts a single named entity entity to UTF-8 representation.

The string passed to this function should be a bare entity name, i.e. it should not contain the ampersand and semicolon.

entity : A single entity name, as a nul-delimited string.
Returns : entity if the name was not recognized, or a valid UTF-8 string. The returned string should be considered constant and never freed or modified (except when it's entity again).

gwy_entities_text_to_utf8 ()

gchar*      gwy_entities_text_to_utf8       (const gchar *text);

Converts entities in a text to UTF-8.

text : A nul-delimited string.
Returns : A newly allocated nul-delimited string containing the converted text.

gwy_entities_get_entities ()

GwyTextEntity* gwy_entities_get_entities    (void);

Returns an array of all available entities.

The array is terminated by { NULL, NULL } item. It must be treated as constant and never modified or freed.

Returns : The entities as a GwyTextEntity array.