LIBMAWK_CALL_FUNCTION(3libmawk)

💖 LIBMAWK_CALL_FUNCTION — bestie edition 💖

okay so this is from the libmawk manual, and we're talking about calling your own awk functions from C. no cap, it's giving ✨bridges✨. sit down, hydrate, let's go 🫶

✨ NAME ✨

libmawk_call_function — call an user defined (script) function 🌸

✨ SYNOPSIS ✨

#include <libmawk.h>

int libmawk_call_function(mawk_state_t *MAWK, const char *fname, CELL *res, const char *argtpes, ...);
int libmawk_call_functionp(mawk_state_t *MAWK, const char *fname, CELL *res, const char *argtpes, void **args);

✨ DESCRIPTION ✨

so like, the whole vibe here is: you've written some awk function in a script, and now your C program is like "hey. run that for me." iconic behavior honestly 💅

libmawk_call_function() goes and looks up an user defined awk function called fname, fills the stack with arguments converted from the varargs, and then calls the function. that's it. that's the whole thing. slay.

libmawk_call_functionp() does the exact same action but it avoids using vararg by requiring an array of generic pointers to the function arguments. so if you're the type who hates varargs (valid), this one's your girl 🎀

Argtype is a zero terminated string for both functions, bestie — each character corresponds to an argument. Type characters are described in libmawk_set_cell() manual page. go read that one, it's the lore iykyk 📖

⚠️ now pay attention because this part is important: if res is non-NULL, it is cell_destroyed (regardless of errors — yes, even if things go sideways 😭) and the return value of the user function is copied into it. The caller shall run libmawk_cell_destroy on it. don't forget. don't be that person. 🫶

Argument m is a libmawk context previously returned by libmawk_initialize() or libmawk_initialize_stage3(). gotta have your context, no context no function call, periodt. 💀

✨ RETURN VALUE ✨

A pointer to the cell returned by the user function. 🔥

The cell returned must be destroyed by the application using libmawk_cell_destroy. like, actually. the way that memory is just sitting there waiting for you to clean it up… main character energy but for leaks 🙈

✨ SEE ALSO ✨

• libmawk_initialize_stage(3libmawk)
• libmawk_initialize(3libmawk)
• libmawk_cell_destroy(3libmawk)
• libmawk_set_cell(3libmawk)

okay that's the whole page bestie, you ate it up fr fr 👑

libmawk · 2009-08-10 · LIBMAWK_CALL_FUNCTION(3libmawk) 🌈✨🦋

mwah, go call some functions 💜