Get a human readable string from a LibGAlloc resource list

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 list, 
                  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'.

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);
}