ggiGAanprintf

Name

ggiGAanprintf -- Get a human readable string from a LibGAlloc resource list

Synopsis

#include <ggi/galloc.h>

int ggiGAanprintf(ggi_visual_t vis, ggiGA_resource_list *request, size_t size, char *format, char **out);

Description

Allocates a string of maximum length size + 1, and puts in it zero terminated string with a textual representation of the resource list pointed to by request. The format argument is for future expansion. *out is pointed to the newly allocated string.

Return value

The length of the generated string is returned, less the terminating '\0'.

Examples

Example 1. ggiGAanprintf Example


ggi_visual_t vis;

void sub autopsy(ggiGA_resquest_list req) {
       char *str;
       ggiGAanprintf(vis, req, 1024, NULL, &str);
       fprintf(stderr, "Resource list contained:\n%s\n", str);
       free(str);
       exit(-1);
}