menu_cursor(3X)

📦
version 6.6_p20260516 · 6 versions
, in alpine 3.24, arch rolling, fedora 44

Okay so you found your way into the menu_cursor(3X) page and I'm so proud of you 💖 this is the one that tells you how to put the cursor back where it belongs. Let's go, no cap.

🌸 NAME 🌸

pos_menu_cursor — position a menu's cursor 🎯

🎀 SYNOPSIS 🎀

#include <menu.h>

int pos_menu_cursor(const MENU *menu);

💅 DESCRIPTION 💅

So pos_menu_cursor restores the cursor right back to the current position that's associated with the menu's selected item. Iconic behaviour, honestly. 🫶

And like, why would you even want that? Because it's genuinely useful after some curses routines have been called to do screen-painting in response to a menu select. You painted all over the screen, the cursor got lost in the sauce, and now you're dragging it home. Main character move. ✨

👑 RETURN VALUE 👑

This routine hands you back one of the following, and you will check it:

  • E_OK — the routine succeeded. Slay. 🎉
  • E_SYSTEM_ERROR — a system error occurred (go peek at errno(3)). 😭
  • E_BAD_ARGUMENT — the routine detected an incorrect or out-of-range argument. Not the vibe. 💀
  • E_NOT_POSTED — the menu has not been posted. Girl, you gotta post it first. 🙈

🌈 PORTABILITY 🌈

These routines emulate the System V menu library. They were not supported on Version 7 or BSD versions. That's just the lore, iykyk. 🦋

💜 AUTHORS 💜

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. Legends, fr fr. 👑

⭐ SEE ALSO ⭐

  • curses(3X)
  • menu(3X)

And that's the whole page, bestie 🍓 this was ncurses 6.6, dated 2024-03-16 — mwah, take care of that cursor of yours 💖🧚

📦 where this page comes from