/*
 * Licensed under the GNU Lesser General Public License Version 3
 *
 * This library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the license, or
 * (at your option) any later version.
 *
 * This software is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library.  If not, see <http://www.gnu.org/licenses/>.
 */

// generated automatically - do not change


module glib.Messages;

private import gi.glib;
public  import gi.glibtypes;
private import glib.Str;


/** */
public struct Messages
{

	/**
	 * Prompts the user with
	 * `[E]xit, [H]alt, show [S]tack trace or [P]roceed`.
	 * This function is intended to be used for debugging use only.
	 * The following example shows how it can be used together with
	 * the g_log() functions.
	 *
	 * |[<!-- language="C" -->
	 * #include <glib.h>
	 *
	 * static void
	 * log_handler (const gchar   *log_domain,
	 * GLogLevelFlags log_level,
	 * const gchar   *message,
	 * gpointer       user_data)
	 * {
	 * g_log_default_handler (log_domain, log_level, message, user_data);
	 *
	 * g_on_error_query (MY_PROGRAM_NAME);
	 * }
	 *
	 * int
	 * main (int argc, char *argv[])
	 * {
	 * g_log_set_handler (MY_LOG_DOMAIN,
	 * G_LOG_LEVEL_WARNING |
	 * G_LOG_LEVEL_ERROR |
	 * G_LOG_LEVEL_CRITICAL,
	 * log_handler,
	 * NULL);
	 * ...
	 * ]|
	 *
	 * If "[E]xit" is selected, the application terminates with a call
	 * to _exit(0).
	 *
	 * If "[S]tack" trace is selected, g_on_error_stack_trace() is called.
	 * This invokes gdb, which attaches to the current process and shows
	 * a stack trace. The prompt is then shown again.
	 *
	 * If "[P]roceed" is selected, the function returns.
	 *
	 * This function may cause different actions on non-UNIX platforms.
	 *
	 * Params:
	 *     prgName = the program name, needed by gdb for the "[S]tack trace"
	 *         option. If @prg_name is %NULL, g_get_prgname() is called to get
	 *         the program name (which will work correctly if gdk_init() or
	 *         gtk_init() has been called)
	 */
	public static void onErrorQuery(string prgName)
	{
		g_on_error_query(Str.toStringz(prgName));
	}

	/**
	 * Invokes gdb, which attaches to the current process and shows a
	 * stack trace. Called by g_on_error_query() when the "[S]tack trace"
	 * option is selected. You can get the current process's program name
	 * with g_get_prgname(), assuming that you have called gtk_init() or
	 * gdk_init().
	 *
	 * This function may cause different actions on non-UNIX platforms.
	 *
	 * Params:
	 *     prgName = the program name, needed by gdb for the "[S]tack trace"
	 *         option
	 */
	public static void onErrorStackTrace(string prgName)
	{
		g_on_error_stack_trace(Str.toStringz(prgName));
	}

	/**
	 * Sets the print handler.
	 *
	 * Any messages passed to g_print() will be output via
	 * the new handler. The default handler simply outputs
	 * the message to stdout. By providing your own handler
	 * you can redirect the output, to a GTK+ widget or a
	 * log file for example.
	 *
	 * Params:
	 *     func = the new print handler
	 *
	 * Return: the old print handler
	 */
	public static GPrintFunc setPrintHandler(GPrintFunc func)
	{
		return g_set_print_handler(func);
	}

	/**
	 * Sets the handler for printing error messages.
	 *
	 * Any messages passed to g_printerr() will be output via
	 * the new handler. The default handler simply outputs the
	 * message to stderr. By providing your own handler you can
	 * redirect the output, to a GTK+ widget or a log file for
	 * example.
	 *
	 * Params:
	 *     func = the new error message handler
	 *
	 * Return: the old error message handler
	 */
	public static GPrintFunc setPrinterrHandler(GPrintFunc func)
	{
		return g_set_printerr_handler(func);
	}
}
