register_trace_handler

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

NAME

register_trace_handler - Registers a custom handler for trace output. Allegro game programming library.

SYNOPSIS

#include <allegro.h>

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

DESCRIPTION

Supplies a custom handler function for dealing with trace output. Your callback will be passed a formatted error message in ASCII, and should return non-zero if it has processed the message, or zero to continue with the default actions. You could use this to ignore trace output, or to display the messages on a second monochrome monitor, etc. You can call this function even when Allegro has not been initialised. Example:
    int network_broadcaster(const char *text)
    {
       int f;
    
       for (int f = 0; f 
          send_msg_to_client(client[f], text);
          
       return 0; /* Let normal tracing occur. */
    }
    ...
       register_trace_handler(network_broadcaster);
       TRACE("Networked tracing activated\n");
 

SEE ALSO

al_trace(3), TRACE(3), register_assert_handler(3)