Function

GLibunichar_fully_decompose

Declaration [src]

gsize
g_unichar_fully_decompose (
  gunichar ch,
  gboolean compat,
  gunichar* result,
  gsize result_len
)

Description [src]

Computes the canonical or compatibility decomposition of a Unicode character. For compatibility decomposition, pass TRUE for compat; for canonical decomposition pass FALSE for compat.

The decomposed sequence is placed in result. Only up to result_len characters are written into result. The length of the full decomposition (irrespective of result_len) is returned by the function. For canonical decomposition, currently all decompositions are of length at most 4, but this may change in the future (very unlikely though). At any rate, Unicode does guarantee that a buffer of length 18 is always enough for both compatibility and canonical decompositions, so that is the size recommended. This is provided as G_UNICHAR_MAX_DECOMPOSITION_LENGTH.

See UAX#15 for details.

Available since:2.30

Parameters

ch gunichar
 

A Unicode character.

compat gboolean
 

Whether perform canonical or compatibility decomposition.

result gunichar*
 

Location to store decomposed result, or NULL.

 The argument will be set by the function.
 The argument can be NULL.
 The data is owned by the caller of the function.
result_len gsize
 

Length of result.

Return value

Returns: gsize
 

The length of the full decomposition.