![]() |
![]() |
Gwyddion Library Reference Manual | ![]() |
|
---|---|---|---|---|
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);
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()
.
typedef struct { const gchar *entity; const gchar *utf8; } GwyTextEntity;
The type of text entity data.
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).
|
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. |
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. |