cursor(3FORM)

💖 cursor(3FORM) 💖

okay bestie, so this is a page from the ncurses family — cursor(3FORM) — and it's all about one tiny little function that puts the cursor back where it belongs. no cap. ✨

---

🌸 NAME 🌸

pos_form_cursor — position a form window cursor 🎀

---

✨ SYNOPSIS ✨

#include <form.h>

int pos_form_cursor(FORM *form);

---

🦋 DESCRIPTION 🦋

okay so pos_form_cursor does the thing where it restores the cursor to the position that the forms driver needs it to be in so it can keep processing requests. like, it's putting the cursor back where the driver expects to find it. 💅

and why do you care? because it's useful after you've called curses routines to do some screen-painting in response to a form operation. you painted the screen, you moved the cursor all over the place with your little curses art project, and now the forms driver is like "umm where's my cursor bestie" — so you call this and everything's chill again. 🫶

---

👑 RETURN VALUE 👑

this routine returns one of the following, and you will be checking it, periodt:

• E_OK — the routine succeeded. slay! 🎉
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument. 😭
• E_NOT_POSTED — the form has not been posted. 🙈
• E_SYSTEM_ERROR — system error occurred (see errno(3)). 💀

---

🌈 PORTABILITY 🌈

these routines emulate the System V forms library. they were not supported on Version 7 or BSD versions. so if you're kicking it on ancient V7 or BSD, this is not the vibe, iykyk. 🧚

---

🍓 AUTHORS 🍓

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. absolute icons, honestly. 👑

---

💜 SEE ALSO 💜

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

---

that's the whole page, babe — short, sweet, and it does exactly one thing really well. 💖

sign-off time: this was ncurses 6.6, dated 2024-03-16, and yes it still says cursor(3FORM) at the bottom like a little signature. mwah. 💅✨