Allocates an array of cairo_text_cluster_t's. 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_clusters is not positive, or if out of memory. That means, the NULL return value signals out-of-memory only if num_clusters was positive. Since 1.8

class Context


numClusters int

number of text_clusters to allocate

Return Value

the newly allocated array of text clusters that should be freed using cairo_text_cluster_free()