Skip to Content

C Traceback

A colorful, lightweight error-propagation framework for C.

C Traceback

Features

  • Beautiful tracebacks
  • Support for Signal Handlers
  • Fast and Thread-safe
  • Explicit control flow
  • Works with MSVC, Clang and GCC
  • Written in C99 with minimal dependencies
  • Detailed documentations

Sample usage

#include <stdio.h>
#include <stdlib.h>
#include "c_traceback.h"
 
#define N 100
 
static void do_calculation(double *vec);
 
int main(void)
{
    ctb_clear_context();
    ctb_install_signal_handler();
 
    double *vec = malloc(N * sizeof(double));
    if (!vec)
    {
        THROW(CTB_MEMORY_ERROR, "Failed to allocate memory");
        goto error;
    }
 
    TRY_GOTO(do_calculation(vec), error);
    printf("This shouldn't be printed if there is error\n");
 
    free(vec);
    return 0;
 
error:
    free(vec);
    ctb_dump_traceback(); // Log traceback and reset context
    return 1;
}
 
static void do_calculation(double *vec)
{
    // Initialize array
    for (int i = 0; i < N; i++)
    {
        vec[i] = 0;
    }
 
    // Calculations
    for (int i = 0; i < N; i++)
    {
        vec[i] += 10;
    }
}

Support Us