form_cursor(3X)

💅 form_cursor — like, the cursor-putting-back girlie of the forms world ✨

okay so this is a page from the ncurses manual, section 3X — yes bestie, the library calls girlies. it's called form_cursor(3X) and it's short, it's sweet, it's lowkey iconic. let's get into it 🎀

---

✨ NAME ✨

pos_form_cursor — puts the form window cursor back where it belongs 👑

🌸 SYNOPSIS 🌸

#include <form.h>

int pos_form_cursor(FORM *form);

that's it. one include, one function, one FORM * argument. no cap, she's a minimalist 🦋

🫶 DESCRIPTION 🫶

so pos_form_cursor restores the cursor to the position required for the forms driver to continue processing requests. periodt. it literally puts the cursor back where the forms driver needs it so it can keep doing its thing 🙈

and when do you need this? bestie, it's useful after curses routines have been called to do screen-painting in response to a form operation — like, the moment you go off and paint the screen yourself, the cursor gets all up in the wrong place, and this function is the one that fixes the vibe check and repositions it 💅

💖 RETURN VALUE 💖

this routine returns one of the following, and every single one of them matters, so don't skip:

• E_OK — the routine succeeded. slay. we love a win ✨
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument 😭 something you passed in was just... not it
• E_NOT_POSTED — the form has not been posted. girl where is the form. it's not even posted yet 💀
• E_SYSTEM_ERROR — system error occurred (see errno(3)). the system said no and you should go peek at errno(3) for the receipts 🔥

🌈 PORTABILITY 🌈

these routines emulate the System V forms library. and just so we're clear — they were not supported on Version 7 or BSD versions 🫠 so if you're on some ancient Version 7 or BSD situation, this is not the function for you, sorry bestie 🎀

👑 AUTHORS 👑

Juergen Pfeifer. 🫶 and the manual pages and adaptation for new curses by Eric S. Raymond. absolute icons, both of them, we stan ⭐

🦋 SEE ALSO 🦋

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

go read those too, iykyk 💜

---

and that's the whole page, bestie — ncurses 6.5, dated 2024-03-16, form_cursor(3X) out. mwah 💋🧚‍♀️