cairo-glyph-allocate (num)

num -- an integer with the number of glyphs to allocate

The newly allocated array of cairo-glyph-t glyphs that should be freed using the cairo-glyph-free function.

Allocates an array of cairo-glyph-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 glyphs that cairo will free. For all other uses, user can use their own allocation method for glyphs.

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.