Function

GLibunichar_fully_decompose

Declaration

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

Description

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`.
`result_len`	`gsize`
	Length of `result`.

Return value

Returns:	`gsize`
	The length of the full decomposition.