form_new(3X)

💖 new_form — bestie edition 💖

okay so this is form_new(3X) from the Library calls section, and it's literally the page where you make forms and then un-make them. creation and destruction. main character arc fr fr ✨

---

🌸 NAME 🌸

new_form, free_form — create and destroy forms 🎀

---

🦋 SYNOPSIS 🦋

#include <form.h>

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

---

✨ DESCRIPTION ✨

okay so new_form is the one that creates a new form and connects it to a specified field pointer array. and bestie, listen — that array must be NULL-terminated. no cap. if you forget the NULL at the end, the vibe check fails and everything goes sideways 💀

and then free_form is the cleanup queen 👑 she disconnects form from its field array and frees the storage that was allocated for the form. so it's giving ✨closure✨

---

💅 RETURN VALUE 💅

so new_form returns NULL on error 😭 and it sets errno based on how the whole thing went:

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

and free_form returns one of these cuties:

• E_OK — the routine succeeded. periodt 💖
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument 🫠
• E_POSTED — the form has already been posted. so you can't just free it like that, it's busy being iconic 🔥

---

🌈 PORTABILITY 🌈

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

---

🍓 AUTHORS 🍓

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. absolute legends, we love them 💜

---

👑 SEE ALSO 👑

• curses(3X)
• form(3X)

---

okay that's the whole page bestie, ily, go build some forms 🫶💖

ncurses 6.6 · 2024-12-28 — and that's the sign-off, dated and versioned like the icon it is. mwah 💅✨🌸