Function

Gtkinit_check

Declaration [src]

gboolean
gtk_init_check (
  int* argc,
  char*** argv
)

Description [src]

This function does the same work as gtk_init() with only a single change: It does not terminate the program if the commandline arguments couldn’t be parsed or the windowing system can’t be initialized. Instead it returns FALSE on failure.

This way the application can fall back to some other means of communication with the user - for example a curses or command line interface.

Note that calling any GTK function or instantiating any GTK type after this function returns FALSE results in undefined behavior.

Parameters

argc

Type: int*

Address of the argc parameter of your main() function (or 0 if argv is NULL). This will be changed if any arguments were handled.

The argument will be modified by the function.

argv

Type: An array of char**

Address of the argv parameter of main(), or NULL. Any options understood by GTK+ are stripped before return.

The argument will be modified by the function.

The argument can be set to NULL by the function.

The length of the array is specified in the argc argument.

The caller of the function takes ownership of the returned data, and is responsible for freeing it.

Each element is a NUL terminated UTF-8 string.

Return value

Type: gboolean

TRUE if the commandline arguments (if any) were valid and the windowing system has been successfully initialized, FALSE otherwise.