Function

Purplemarkup_unescape_entity

Declaration [src]

const char*
purple_markup_unescape_entity (
  const char* text,
  int* length
)

Description [src]

Returns a constant string of the character representation of the HTML entity pointed to by text. For example, purple_markup_unescape_entity(“&”) will return “&”. The text variable is expected to point to an ‘&’, the first character of the entity. If given an unrecognized entity, the function returns NULL.

Note that this function, unlike purple_unescape_html(), does not search the string for the entity, does not replace the entity, and does not return a newly allocated string.

Parameters

text

Type: const char*

A string containing an HTML entity.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

length

Type: int*

If not NULL, the string length of the entity is stored in this location.

The data is owned by the caller of the function.

Return value

Type: const char*

A constant string containing the character representation of the given entity.

The data is owned by the called function.

The value is a NUL terminated UTF-8 string.