ggiParseMode, ggiPrintMode, ggiSPrintMode, ggiFPrintMode : Parse and print formatted strings specifying modes
#include <ggi/ggi.h> int ggiParseMode(const char *s, ggi_mode *m); #define ggiPrintMode(m) ggiFPrintMode(stdout,(m)) int ggiSPrintMode(char *s, ggi_mode *m); int ggiFPrintMode(FILE *s, ggi_mode *m);
ggiParseMode parses a string into a ggi_mode.
The ggi*PrintMode functions print all the members of ggi_mode in a human-readable form. ggiSPrintMode outputs to a preallocated string buffer, ggiFPrintMode outputs to a stdio FILE, and ggiPrintMode outputs to standard output. These functions correspond to :man:`sprintf(3)`, :man:`fprintf(3)` and :man:`printf(3)` respectively.
The format of the string used by these functions is exactly the same as the one used in the GGI_DEFMODE environment variable decribed in :man:`libggi(7)`.
ggiParseMode returns:
if there is text that can not be parsed. This text is printed to stderr. All parameters parsed so far are written into :p:`m`.
So :p:`m` contains all parameters that have been successfully parsed. For most applications there will be no need for testing ggiParseMode for failure.