register_assert_handler

Langue: en

Version: version 4.2.2 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

register_assert_handler - Registers a custom handler for assert failures. Allegro game programming library.

SYNOPSIS

#include <allegro.h>

void register_assert_handler(int (*handler)(const char *msg));

DESCRIPTION

Supplies a custom handler function for dealing with assert failures. Your callback will be passed a formatted error message in ASCII, and should return non-zero if it has processed the error, or zero to continue with the default actions. You could use this to ignore assert failures, or to display the error messages on a graphics mode screen without aborting the program. You can call this function even when Allegro has not been initialised. Example:
    int show_but_continue(const char *text)
    {
        alert("Uh oh...", "Fasten your seat belts.", text,
              "&Go on!", NULL, 'g', 0);
        return 1;
    }
    ...
       register_assert(show_but_continue);
       ASSERT(0); /* This won't crash the program now. */
 

SEE ALSO

al_assert(3), ASSERT(3), register_trace_handler(3)