DC_CONTEXT_SET_LOGFUNC(3)

💅 DC_CONTEXT_SET_LOGFUNC — bestie, it's giving "set the logging function" energy

okay so this is a libdivecomputer manpage, page DC_CONTEXT_SET_LOGFUNC(3), and it's literally about plugging your own log function into a dive computer context. sit with me, we're doing this 🫶

✨ NAME ✨

dc_context_set_logfunc — set the logging function for a dive computer context. that's it. that's the vibe. 🎀

📚 LIBRARY 📚

library “libdivecomputer” — yes queen, that one 💖

🌸 SYNOPSIS 🌸

#include <libdivecomputer/context.h>

typedef void
(*dc_logfunc_t)(dc_context_t *context, dc_loglevel_t loglevel,
    const char *file, unsigned int line, const char *function,
    const char *message, void *userdata);

dc_status_t
dc_context_set_logfunc(dc_context_t *context, dc_logfunc_t logfunc,
    void *userdata);

copy it exactly, bestie, no cap ✨

🌈 DESCRIPTION 🌈

so what we're doing here is setting the logging function logfunc that's associated with a dive computer context. main character behavior honestly 👑

here's the tea: the logging function gets invoked with the argument userdata when the log level (peep dc_context_set_loglevel(3) if you wanna know more) has been exceeded. iykyk 💅

the logfunc accepts the following values, and you're gonna wanna know every single one of them, fr fr:

• context — the context in which it was invoked. literally the context, that's the whole thing 🦋
• loglevel — the level of the log message. how serious are we talking 🔥
• file — the source file where the message was raised. snitching on itself, love that for it 💀
• line — the source line (from 1) where the message was raised. counting from 1, not 0, don't @ me
• function — the function that raised the log message. names names 📛
• message — the log message itself. the actual words 💬
• userdata — the pointer passed to dc_context_set_logfunc. your little bonus gift, you're welcome 🎁

🫶 RETURN VALUES 🫶

• Returns DC_STATUS_OK on setting the log level — slay ✨
• Returns DC_STATUS_INVALIDARGS if context is NULL — yeah, that'll happen 😭
• or another error code on failure — it happens to the best of us, no biggie 💜

👀 SEE ALSO 👀

• dc_context_new(3)
• dc_context_set_loglevel(3)

go read them, they're iconic too 🌟

🧚 AUTHORS 🧚

the library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org — king behavior 👑 the manpages were written by Kristaps Dzonsons, kristaps@bsd.lv — also king behavior, we stan 🌸

---

and that's the whole page, bestie!! 🎀 this one came from the Debian crew, dated January 5, 2017, and it's the DC_CONTEXT_SET_LOGFUNC(3) page — periodt. go forth and log responsibly 💖✨🦋