form_new_page(3X)                                          form_new_page(3X)

NAME         top

       set_new_page, new_page - form pagination functions

SYNOPSIS         top

       #include <form.h>
       int set_new_page(FIELD *field, bool new_page_flag);
       bool new_page(const FIELD *field);

DESCRIPTION         top

       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         top

       The function new_page returns TRUE or FALSE.

       The function set_new_page return one of the following:

       E_OK The routine succeeded.

            System error occurred (see errno).

            The given field is already connected to a form.

SEE ALSO         top

       curses(3X) and related pages whose names begin "form_" for detailed
       descriptions of the entry points.

NOTES         top

       The header file <form.h> automatically includes the header file

PORTABILITY         top

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

AUTHORS         top

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

COLOPHON         top

       This page is part of the ncurses (new curses) project.  Information
       about the project can be found at 
       ⟨⟩.  If you have a
       bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git mirror of the CVS repository 
       ⟨git://⟩ on 2017-03-13.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail