Provided by: allegro4-doc_4.4.3.1-6_all bug

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(3alleg4), TRACE(3alleg4), register_assert_handler(3alleg4)

Allegro                                           version 4.4.3                  register_trace_handler(3alleg4)