cursor(3MENU)

💅 cursor(3MENU) — the library-calls girlies know 💅

ok so bestie, we're in the 3MENU section of the manual (that's the Library calls corner of the house 🏠✨), and today's main character is cursor(3MENU). she's small, she's focused, she does ONE thing and she does it gorgeously. let's get into it 🎀

---

✨ NAME ✨

pos_menu_cursor — position a menu's cursor 🖱️💖

like. that's the whole job. put the cursor where it belongs. iconic behaviour honestly.

---

🌸 SYNOPSIS 🌸

#include <menu.h>

int pos_menu_cursor(const MENU *menu);

look at her. one include, one function, one const MENU * argument. no drama, no extra params, just clean lines fr fr ✨

---

🦋 DESCRIPTION 🦋

so what does pos_menu_cursor actually DO? she restores the cursor to the current position associated with the menu's selected item. that's it. that's the assignment and she ate 💅

when is this a big deal tho? okay imagine this: some curses routines got called and did a lil screen-painting moment in response to a menu select 🎨 like you drew stuff on the screen and now your cursor is just… somewhere. lost. vibing in the wrong place 😭 that's when you call pos_menu_cursor — to bring the cursor back home to the item that's actually selected. main character restored to her rightful position 👑

---

💖 RETURN VALUE 💖

this routine returns one of the following, and bestie we're reading them ALL:

• E_OK — the routine succeeded ✨ slay, no notes.
• E_SYSTEM_ERROR — a system error occurred (see errno(3)). something went wrong at the system level, go check your errno 💀
• E_BAD_ARGUMENT — the routine detected an incorrect or out-of-range argument 🙈 you handed her something she can't work with.
• E_NOT_POSTED — the menu has not been posted 👀 no menu on screen = nothing to point at.

lowkey important: if you get anything other than E_OK, something is off. read the list, don't skip it 🫶

---

🌈 PORTABILITY 🌈

these routines emulate the System V menu library. they were not supported on Version 7 or BSD versions. so if you're on some ancient BSD situation… yeah, this one's not coming to your party 🧚 iykyk.

---

👑 AUTHORS 👑

• Juergen Pfeifer 🫶
• Manual pages and adaptation for new curses by Eric S. Raymond ✍️

---

🍓 SEE ALSO 🍓

• ncurses(3NCURSES)
• menu(3MENU)

---

and that's the whole page bestie!! cursor positioned, vibes immaculate, no cap 💅✨

this lil love letter came to you courtesy of ncurses 6.6, dated 2024-03-16 — mwah, take care of her 🎀💜