Movatterモバイル変換

form_new(3x) — Linux manual page

form_new(3X)form_new(3X)

NAME        top

new_form,free_form- create and destroy forms

SYNOPSIS        top

#include <form.h>FORM *new_form(FIELD **fields);int free_form(FORM *form);

DESCRIPTION        top

       The functionnew_formcreates a new form connected to a specified       field pointer array (which must beNULL-terminated).       The functionfree_formdisconnectsform from its field array and       frees the storage allocated for the form.

RETURN VALUE        top

       The functionnew_formreturnsNULLon error.  It setserrno       according to the function's success:E_OKThe routine succeeded.E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_CONNECTED            The field is already connected to a form.E_SYSTEM_ERROR            System error occurred, e.g., malloc failure.       The functionfree_formreturns one of the following:E_OKThe routine succeeded.E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_POSTED            The form has already been posted.

SEE ALSO        top

curses(3X),form(3X).

NOTES        top

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

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 thencurses (new curses) project.       Information about the project can be found at        ⟨https://www.gnu.org/software/ncurses/ncurses.html⟩.  If you have a       bug report for this manual page, send it to       bug-ncurses-request@gnu.org.  This page was obtained from the       project's upstream Git mirror of the CVS repository       ⟨https://github.com/mirror/ncurses.git⟩ on 2025-08-11.  (At that       time, the date of the most recent commit that was found in the       repository was 2023-03-12.)  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 isnot part of the original manual page), send a mail to       man-pages@man7.orgform_new(3X)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.