form_new_page(3X)

💖 form_new_page(3X) — form pagination functions 💖

okay bestie, this one’s from the Library calls manual, section 3X, and it’s all about pagination in curses forms. The functions are set_new_page and new_page, and they’re lowkey giving main-character energy for page breaks. 🦋

🌸 NAME 🌸

set_new_page, new_page — form pagination functions

✨ SYNOPSIS ✨

#include <form.h>

int set_new_page(FIELD *field, bool new_page_flag);
bool new_page(const FIELD *field);

💅 DESCRIPTION 💅

The function set_new_page sets or resets a flag marking the given field as the beginning of a new page on its form. Slay, that’s literally the whole vibe: you’re flagging a field as a page-start. 🎀

The function new_page is a predicate which tests if a given field marks a page beginning on its form. So it’s the little vibe check that tells you “yep, this field starts a new page.” ✨

🫶 RETURN VALUE 🫶

The function new_page returns TRUE or FALSE.

The function set_new_page returns one of the following:

• E_OK — the routine succeeded. iconic behavior, no notes. 👑
• E_CONNECTED — the given field is already connected to a form. oop, it’s taken. 💀

🌈 PORTABILITY 🌈

These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions. fr fr, that’s the compatibility tea. 🍓

🧚 AUTHORS 🧚

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. absolute legends. 💜

🌟 SEE ALSO 🌟

curses(3X) and related pages whose names begin form_ — for detailed descriptions of the entry points. iykyk, go read those next bestie. 🦋

---

this page is from ncurses 6.5, dated 2024-03-16 — bye bestie, go paginate something cute 💖