Movatterモバイル変換

form_field_new(3x) — Linux manual page

form_field_new(3X)form_field_new(3X)

NAME        top

new_field,dup_field,link_field,free_field- create and destroy       form fields

SYNOPSIS        top

#include <form.h>FIELD *new_field(intheight, intwidth,inttoprow, intleftcol,intoffscreen, intnbuffers);FIELD *dup_field(FIELD *field, inttoprow, intleftcol);FIELD *link_field(FIELD *field, inttoprow, intleftcol);int free_field(FIELD *field);

DESCRIPTION        top

       The functionnew_fieldallocates a new field and initializes it       from the parameters given: height, width, row of upper-left       corner, column of upper-left corner, number off-screen rows, and       number of additional working buffers.       The functiondup_fieldduplicates a field at a new location.  Most       attributes (including current contents, size, validation type,       buffer count, growth threshold, justification, foreground,       background, pad character, options, and user pointer) are copied.       Field status and the field page bit are not copied.       The functionlink_fieldacts likedup_field, but the new field       shares buffers with its parent.  Attribute data is separate.       The functionfree_fieldde-allocates storage associated with a       field.

RETURN VALUE        top

       The functionsnew_field,dup_field,link_fieldreturnNULLon       error.  They seterrnoaccording to their success:E_OKThe routine succeeded.E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_SYSTEM_ERROR            System error occurred, e.g., malloc failure.       The functionfree_fieldreturns one of the following:E_OKThe routine succeeded.E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_CONNECTED            field is connected.

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.       It may be unwise to count on the set of attributes copied bydup_fieldbeing portable; the System V forms library documents are       not very explicit about what gets copied and what does not.

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_field_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.