---
name: "form_new_page"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/form_new_page"
---

# form\_new\_page(3)

form pagination functions

## 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.**

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

## 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.**

- **E\_CONNECTED**

  **The given field is already connected to a form.**

## PORTABILITY

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

## AUTHORS

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

## SEE ALSO

**curses(3X) and related pages whose names begin “form\_”** **for detailed descriptions of the entry points.**