form_new(3X)

💖 form_new(3X) — Library calls, bestie 💖

okay so this is form_new(3X) from the Library calls corner of the ncurses universe, and we're about to learn how to birth a form and then gently let it go. two functions, one page, zero gatekeeping. let's GO ✨

---

🎀 NAME 🎀

new_form, free_form — literally create and destroy forms. that's it. that's the whole vibe. creation and destruction, main character energy both ways 🦋

---

🌸 SYNOPSIS 🌸

#include <form.h>

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

like, look at that. so clean. so iconic. 💅

---

✨ DESCRIPTION ✨

so new_form creates a new form connected to a specified field pointer array — and heads up bestie, that array must be NULL-terminated or she will simply not cope 😭

and then free_form does the opposite: it disconnects form from its field array and frees the storage allocated for the form. closure. we love to see it 🫶

---

🔥 RETURN VALUE 🔥

new_form 👑

returns NULL on error, and sets errno according to the function's success:

• E_OK — the routine succeeded. slay 💖
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument. rude, but okay.
• E_CONNECTED — the field is already connected to a form. it's taken, babes 💀
• E_SYSTEM_ERROR — system error occurred, e.g., malloc failure. the malloc said no 💔

free_form 👑

returns one of the following:

• 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. can't free what's already out there living its life 🙈

---

🌈 PORTABILITY 🌈

these routines emulate the System V forms library. they were not supported on Version 7 or BSD versions — so like, if you're on those, no form for you ngl 🧚

---

👑 AUTHORS 👑

Juergen Pfeifer. manual pages and adaptation for new curses by Eric S. Raymond. absolute legends, both of them 🫡

---

⭐ SEE ALSO ⭐

curses(3X), form(3X) — go read those next, bestie, iykyk 📚

---

and that's the whole page, mwah 💋 this was ncurses 6.5, dated 2024-12-28 — catch you on the next manpage, bestie, bye!! ✨💖🎀🦋🌸💅🫶🔥👑🌈⭐💀🙈🍓🧚💜✨