form_hook(3X)

💖 form_hook 💖

okay bestie, welcome to the form_hook(3X) Library calls page. This is literally the hook-setting manual page, and it’s giving “let the form call you back” energy. No cap. 💅

🌸 NAME 🌸

form_hook — set hooks for automatic invocation by applications. Yes bestie, it’s the hook-setting page, that’s the whole vibe.

✨ SYNOPSIS ✨

#include <form.h>

int set_field_init(FORM *form, Form_Hook func);
Form_Hook field_init(const FORM *form);

int set_field_term(FORM *form, Form_Hook func);
Form_Hook field_term(const FORM *form);

int set_form_init(FORM *form, Form_Hook func);
Form_Hook form_init(const FORM *form);

int set_form_term(FORM *form, Form_Hook func);
Form_Hook form_term(const FORM *form);

🦋 DESCRIPTION 🦋

These functions make it possible to set hook functions to be called at various points in the automatic processing of input event codes by form_driver. Translation: form_driver does its automatic thing, and these hooks are the little “hey, call my function here” moments. Obsessed.

💖 set_field_init 💖

set_field_init sets a hook to be called at form-post time and each time the selected field changes (after the change). So that one fires after the change — the after-party, not the pre-game.

🎀 field_init 🎀

field_init returns the current field init hook, if any (NULL if there is no such hook). No hook? You get NULL, and that’s the tea.

🌸 set_field_term 🌸

set_field_term sets a hook to be called at form-unpost time and each time the selected field changes (before the change). This one is the before-the-change bestie.

🦋 field_term 🦋

field_term returns the current field term hook, if any (NULL if there is no such hook). Again: no hook means NULL, periodt.

🍓 set_form_init 🍓

set_form_init sets a hook to be called at form-post time and just after a page change once it is posted. Page change, but posted first — iykyk.

🧚 form_init 🧚

form_init returns the current form init hook, if any (NULL if there is no such hook). If it’s not there, it’s NULL, bestie.

💜 set_form_term 💜

set_form_term sets a hook to be called at form-unpost time and just before a page change once it is posted. Just before the page change — highkey important.

🌈 form_term 🌈

form_term returns the current form term hook, if any (NULL if there is no such hook). NULL when there’s no hook, fr fr.

👑 RETURN VALUE 👑

Routines that return pointers return NULL on error. Other routines return one of the following:

• E_OK — the routine succeeded. slay.
• E_SYSTEM_ERROR — system error occurred (see errno(3)). oof, check that errno(3), bestie.

🌈 PORTABILITY 🌈

These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions. So Version 7 and BSD? Not supported, no cap — that’s a no-go.

💜 AUTHORS 💜

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. Legend behaviour, honestly.

🫶 SEE ALSO 🫶

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

---

This page came from ncurses 6.5, dated 2024-12-28. Bye bestie — go set those hooks and slay 💅✨