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`	`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`	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`.
	The length of the array is specified in the `argc` argument.
	The called function takes ownership of the data, and is responsible for freeing it.
	Each element is a NUL terminated UTF-8 string.

Return value

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