form\_post(3X) Library calls form\_post(3X)

# [NAME](#NAME)

**post\_form**, **unpost\_form** - write or erase forms from associated subwindows

# [SYNOPSIS](#SYNOPSIS)

```
#include <form.h>
```

```
int post_form(FORM *form);
int unpost_form(FORM *form);
```

# [DESCRIPTION](#DESCRIPTION)

The function **post\_form** displays a form to its associated subwindow. To trigger physical display of the subwindow, use [**refresh**(3X)](/man/os/ncurses/refresh.3X) or some equivalent **curses** routine (the implicit **doupdate** triggered by an **curses** input request will do).

The function **unpost\_form** erases form from its associated subwindow.

# [RETURN VALUE](#RETURN_VALUE)

These routines return one of the following:

[**E\_OK**](#E_OK)

The routine succeeded.

[**E\_BAD\_ARGUMENT**](#E_BAD_ARGUMENT)

Routine detected an incorrect or out-of-range argument.

[**E\_BAD\_STATE**](#E_BAD_STATE)

Routine was called from an initialization or termination function.

[**E\_NOT\_POSTED**](#E_NOT_POSTED)

The form has not been posted.

[**E\_NOT\_CONNECTED**](#E_NOT_CONNECTED)

No items are connected to the form.

[**E\_NO\_ROOM**](#E_NO_ROOM)

Form is too large for its window.

[**E\_POSTED**](#E_POSTED)

The form has already been posted.

[**E\_SYSTEM\_ERROR**](#E_SYSTEM_ERROR)

System error occurred (see [**errno**(3)](/man/os/ncurses/errno.3)).

# [PORTABILITY](#PORTABILITY)

These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions.

# [AUTHORS](#AUTHORS)

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

# [SEE ALSO](#SEE_ALSO)

[**curses**(3X)](/man/os/ncurses/curses.3X), [**form**(3X)](/man/os/ncurses/form.3X)

2024-03-16 ncurses 6.6

---

Document: form_post(3x) from ncurses 6.6.20261024-r0 (Chainguard OS)
Source: https://github.com/ThomasDickey/ncurses-snapshots