PX_NEW3(3)

💖 PX_NEW3 💖

okay bestie, welcome to PX_new3(3) — it lives in the Library Functions Manual section 3, and it's the one that makes you a whole brand new Paradox file instance. let's get into it 🦋

✨ NAME ✨

PX_new3 — create new instance of Paradox file 🌸

🌈 SYNOPSIS 🌈

#include <paradox.h>

pxdoc_t* PX_new3(void  (*errorhandler)(pxdoc_t *p, int type, const char
*msg, void *para), void* (*allocproc)(pxdoc_t *p, size_t size, const
char *caller), void* (*reallocproc)(pxdoc_t *p, void *mem, size_t size,
const char *caller), void  (*freeproc)(pxdoc_t *p, void *mem), void
*errorhandler_user_data)

👑 DESCRIPTION 👑

so this makes you a new instance of a Paradox file. and listen — this function, or PX_new(3), or PX_new2(3) — one of them must be called before you touch literally anything else. it's the vibe check before the party, fr fr. 🔥

and if you're the kind of main character who has their own error and memory management functions? you can just pass them in. no gatekeeping, we love that for you. 💅

now here's the tea on how it differs from PX_new2(3): this one has an extra parameter, errorhandler_user_data, and it's a pointer to user data that gets passed to the error handler function as its fourth parameter. it's giving "custom context" energy ✨. like, you could pass a widget pointer where the error messages are supposed to be output, or a context that otherwise would've had to be smuggled to the error handler through a global variable. not me saving you from globals 😭🫶

🎀 RETURN VALUE 🎀

returns a pointer to an internal representation of a Paradox file. and if it doesn't work out? NULL. that's the whole thing. no cap. 🙈

🦋 SEE ALSO 🦋

• PX_new(3)
• PX_new2(3)
• PX_open_file(3)
• PX_open_fp(3)

💜 AUTHOR 💜

this manual page was written by Uwe Steinmann uwe@steinmann.cx. iconic of him, honestly. 👑

and that's a wrap on PX_NEW3(3), page PX_NEW3(3) — go forth and instantiate, bestie 💖✨