Function

GLibunichar_decompose

Declaration

gboolean
g_unichar_decompose (
  gunichar ch,
  gunichar* a,
  gunichar* b
)

Description

Performs a single decomposition step of the Unicode canonical decomposition algorithm.

This function does not include compatibility decompositions. It does, however, include algorithmic Hangul Jamo decomposition, as well as ‘singleton’ decompositions which replace a character by a single other character. In the case of singletons *b will be set to zero.

If ch is not decomposable, a is set to ch and b is set to zero.

Note that the way Unicode decomposition pairs are defined, it is guaranteed that b would not decompose further, but a may itself decompose. To get the full canonical decomposition for ch, one would need to recursively call this function on a. Or use g_unichar_fully_decompose().

See UAX#15 for details.

Available since:2.30

Parameters

ch gunichar
 

A Unicode character.

a gunichar*
 

Return location for the first component of ch.

 The argument will be set by the function.
 The called function takes ownership of the data, and is responsible for freeing it.
b gunichar*
 

Return location for the second component of ch.

 The argument will be set by the function.
 The called function takes ownership of the data, and is responsible for freeing it.

Return value

Returns: gboolean
 

TRUE if the character could be decomposed.