register_trace_handler(3alleg)

register_trace_handler3alleg

Registers a custom handler for trace output. allegro game programming library.

Usage

#include <allegro.h>

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

Overview

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");

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0

From liballegro-doc 2:4.2.2-2.2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.