.\" Generated by the Allegro makedoc utility
.TH register_trace_handler 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
register_trace_handler \- Registers a custom handler for trace output. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B void register_trace_handler(int (*handler)(const char *msg));
.SH 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:

.nf
   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");
.fi

.SH SEE ALSO
.BR al_trace (3alleg4),
.BR TRACE (3alleg4),
.BR register_assert_handler (3alleg4)