Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
register_trace_handler(3)	Allegro	manual	     register_trace_handler(3)

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)

Allegro				 version 4.4.2	     register_trace_handler(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=register_trace_handler&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help