new(3FORM)

✨ new(3FORM) ✨

okay bestie, welcome to new(3FORM) from the Library calls section of the manual — this is the one about making and unmaking forms, and honestly? it's giving main character energy for the whole forms library. 💅

---

🎀 NAME 🎀

new_form, free_form — create and destroy forms. that's it, that's the whole vibe. 💖

---

🌸 SYNOPSIS 🌸

#include <form.h>

FORM *new_form(FIELD **fields);
int free_form(FORM *form);

like, include the header first, obviously. 🙈

---

🦋 DESCRIPTION 🦋

okay so, new_form creates a brand new form, and it connects that form to a specified field pointer array. important detail: that array must be NULL-terminated. no cap. if you forget the NULL at the end, that's on you, bestie. 💀

and then free_form? she's the closer. she disconnects form from its field array and frees the storage that was allocated for the form. clean exit, no mess, periodt. ✨

---

💜 RETURN VALUE 💜

new_form returns NULL on error. and when it does that, it sets errno according to how the function went:

• E_OK — the routine succeeded. slay. 🎉
• E_BAD_ARGUMENT — the routine detected an incorrect or out-of-range argument. 🙈
• E_CONNECTED — the field is already connected to a form. she's taken, babes. 💔
• E_SYSTEM_ERROR — a system error occurred, e.g., malloc failure. 😭

meanwhile free_form returns one of these:

• E_OK — the routine succeeded. 🫶
• E_BAD_ARGUMENT — the routine detected an incorrect or out-of-range argument. 🍓
• E_POSTED — the form has already been posted. you can't just free a posted form, bestie, that's not the move. 💅

---

🌈 PORTABILITY 🌈

these routines emulate the System V forms library. they were not supported on Version 7 or BSD versions. so if you're time-traveling to ancient Unix, this is not the moment, iykyk. 🧚

---

👑 AUTHORS 👑

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. legends, honestly. 💖

---

⭐ SEE ALSO ⭐

• ncurses(3NCURSES)
• form(3FORM)

---

and that's the whole page, bestie!! 🎀 this was ncurses 6.6, dated 2024-12-28 — go forth and build ur forms, you absolute icon. 🦋💖✨