Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
form_new(3X)			  Library calls 		    form_new(3X)

NAME
     new_form, free_form - create and destroy forms

SYNOPSIS
     #include <form.h>

     FORM *new_form(FIELD **fields);
     int free_form(FORM *form);

DESCRIPTION
     The  function  new_form  creates  a new form connected to a specified field
     pointer array (which must be NULL-terminated).

     The function free_form disconnects form from its field array and frees  the
     storage allocated for the form.

RETURN VALUE
     The  function  new_form  returns NULL on error.  It sets errno according to
     the function's success:

     E_OK
	  The 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 function free_form returns one of the following:

     E_OK
	  The routine succeeded.

     E_BAD_ARGUMENT
	  Routine detected an incorrect or out-of-range argument.

     E_POSTED
	  The form has already been posted.

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), form(3X)

ncurses 6.5			   2024-12-28			    form_new(3X)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=form_new&sektion=3&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help