form\_new\_page(3X) Library calls form\_new\_page(3X)

# [NAME](#NAME)

**set\_new\_page**, **new\_page** - form pagination functions

# [SYNOPSIS](#SYNOPSIS)

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

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

# [DESCRIPTION](#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.

The function **new\_page** is a predicate which tests if a given field marks a page beginning on its form.

# [RETURN VALUE](#RETURN_VALUE)

The function **new\_page** returns **TRUE** or **FALSE**.

The function **set\_new\_page** returns one of the following:

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

The routine succeeded.

[**E\_CONNECTED**](#E_CONNECTED)

The given field is already connected to a form.

# [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) and related pages whose names begin “form\_” for detailed descriptions of the entry points.

2024-03-16 ncurses 6.6

---

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