TS_ERROR_FN(3)

💖 TS_ERROR_FN(3) 💖

okay bestie, welcome to the tslib manual, section 3 — this is the page about ts_error_fn, and it's lowkey one of the cutest little hooks in the whole library. let's get into it 🫶

✨ NAME ✨

ts_error_fn — use a custom error function for libts library errors

like, you get to decide where your errors go. iconic behaviour, honestly. 👑

🌸 SYNOPSIS 🌸

#include <tslib.h>

int (*ts_error_fn)(const char *fmt, va_list ap);

so it's a function pointer, bestie. a pointer to a function that takes a const char *fmt and a va_list ap, and hands you back an int. that's the whole vibe check. ✨

🎀 DESCRIPTION 🎀

okay so here's the tea. ts_error_fn() is, by default, implemented similar like this:

static int errfn(const char *fmt, va_list ap)
{
    return vfprintf(stderr, fmt, ap);
}

that lives inside the library. it's the default, it's the factory setting, it's the plain vanilla of error handling. 🍦

but — and this is the good part — it is exposed to the user and can be replaced by a custom error function. simply assign your custom implementation to ts_error_fn like:

ts_error_fn = my_custom_errfn;

and boom. that's it. that's the whole ritual. 💅

what's it good for? writing to the system log files, for example. so if you've ever been like "why is my error just going to stderr when i need it in syslog", yeah, this is your moment. the ts_print_mt test program has an example, so go peek at it if you want to see it in the wild. 🦋

⭐ RETURN VALUE ⭐

user defined. yeah, that's the whole answer — you decide what it returns. main character energy: the return value is whatever you make it. 🫶

🌈 SEE ALSO 🌈

• ts_read(3)
• ts_open(3)
• ts_setup(3)
• ts_close(3)
• ts.conf(5)

💀 heads up bestie: the return value is literally "user defined". that's not me being vague, that's the actual spec. whatever you return is on you. no cap.

and that's the page!! this lil beauty comes to you straight from the tslib manual, section 3 — TS_ERROR_FN(3), signed, sealed, slayed. mwah 💋 go write some custom error functions, i believe in you 🎀✨