cairo-text-cluster-allocate (num)

num -- an integer with the number of text clusters to allocate

The newly allocated array of cairo-text-cluster-t text clusters that should be freed using the cairo-text-cluster-free function.

Allocates an array of cairo-text-cluster-t instances. This function is only useful in implementations of cairo-user-scaled-font-text-to-glyphs-func-t where the user needs to allocate an array of text clusters that Cairo will free. For all other uses, user can use their own allocation method for text clusters.

This function returns NULL if num is not positive, or if out of memory. That means, the NULL return value signals out-of-memory only if num was positive.