form_field(3X)

💖 form_field — bestie, let's talk field-to-form connections 💖

okay so this is a page from the Library calls girlies, and it's literally all about making and breaking the connections between fields and forms. lowkey iconic.

---

✨ NAME ✨

form_field — make and break connections between fields and forms 🫶

---

🌸 SYNOPSIS 🌸

#include <form.h>

int set_form_fields(FORM *form, FIELD **fields);
FIELD **form_fields(const FORM *form);
int field_count(const FORM *form);
int move_field(FIELD *field, int frow, int fcol);

---

🦋 DESCRIPTION 🦋

okay so let's go one by one, no cap.

The function set_form_fields changes the field pointer array of the given form. and bestie, listen — the array must be terminated by a NULL. like, that's non-negotiable. it's giving "last one to leave turns off the lights" but the lights are a NULL pointer. 💅

The function form_fields returns the field array of the given form. that's it, that's the whole job, she's simple and she's serving. ✨

The function field_count returns the count of fields in form. slay, we love a headcount. 🔢

The function move_field moves the given field to a specified location on the screen. and the field must be disconnected — like, she has to be single before she can relocate. no messy attachments, periodt. 💀

---

👑 RETURN VALUE 👑

The function form_fields returns a pointer (which may be NULL). and no, she does not set errno. she minds her own business. 🙈

The function field_count returns ERR if the form parameter is NULL. yeah, if you hand her nothing, she's gonna give you ERR. fair. 💅

The functions set_form_fields and move_field return one of the following codes on error:

• E_OK — the routine succeeded. we love a win. 🎀
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument. something was giving wrong-number energy. 😭
• E_CONNECTED — the field is already connected to a form. she's taken, bestie, back off. 🔥
• E_POSTED — the form is already posted. it's up, it's out there, it's living its main character life. ⭐
• E_SYSTEM_ERROR — system error occurred (see errno(3)). not our fault, the system is being messy. 💀

---

🌈 PORTABILITY 🌈

These routines emulate the System V forms library. they were not supported on Version 7 or BSD versions — so if you're on those, bestie, you're on your own. 🫶

The SVr4 forms library documentation specifies the field_count error value as -1 (which is the value of ERR). so like, same energy, different font. iykyk. ✨

---

🧚 AUTHORS 🧚

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. absolute legends, we stan. 👑

---

💜 SEE ALSO 💜

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

---

and that's the whole vibe, bestie — go forth and connect those fields responsibly 🦋🌸💖

this page came to you courtesy of ncurses 6.6, dated 2024-12-28 — mwah, no notes, slay 🎀✨