---
name: "set_new_page"
section: "3form"
platform: "linux"
package: "ncurses-doc"
version: "6.5+20250216-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/new_page/3form"
---

# set\_new\_page(3form)

form pagination functions

Part of [new\_page(3form)](/new_page/3form.md).

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

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