al_trace(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

🌸 NAME 🌸

okay so this page is from the Allegro manual, and it's about one tiny but iconic function, bestie 💖

  • al_trace — outputs a debugging trace message. Allegro game programming library.

✨ SYNOPSIS ✨

you include it like this, no cap:

#include <allegro.h>

void al_trace(const char *msg, ...);

🦋 DESCRIPTION 🦋

okay so al_trace is your little “what is even happening” button. It outputs a debugging trace message, using a printf() format string given in ASCII. 💅

Here’s the tea on where that message actually goes:

  • If you have installed a custom trace handler, it uses that.
  • Or, if the environment variable ALLEGRO_TRACE is set, it writes into the file specified by the environment.
  • Otherwise, it writes the message to "allegro.log" in the current directory.

Also? You will usually want to use the TRACE() macro instead of calling this function directly. fr fr ✨

💖 SEE ALSO 💖

this has been al_trace(3) from the Allegro manual, Allegro version 4.4.3 🎀✨💜

📦 where this page comes from