formfield(3X) formfield(3X)

NAME
       ffoorrmmffiieelldd - make and break connections between fields and forms

SYNOPSIS
       ##iinncclluuddee <>
       int setformfields(FORM *form, FIELD **fields);
       FIELD **formfields(const FORM *form);
       int fieldcount(const FORM *form);
       int movefield(FIELD *field, int frow, int fcol);

DESCRIPTION
       The  function  sseettffoorrmmffiieellddss  changes  the field pointer array of the
       given form.  The array must be terminated by a NNUULLLL.

       The function ffoorrmmffiieellddss returns the field array of the given form.

       The function ffiieellddccoouunntt returns the count of fields in form.

       The function mmoovveeffiieelldd moves the given field (which  must  be  discon-
       nected) to a specified location on the screen.

RETURN VALUES
       The function ffoorrmmffiieellddss returns NNUULLLL on error.

       The  function  ffiieellddccoouunntt returns EERRRR (the general ccuurrsseess error return
       value) on error.

       The functions sseettffoorrmmffiieellddss and mmoovveeffiieelldd return one of the  follow-
       ing codes on error:

       EEOOKK The routine succeeded.

       EESSYYSSTTEEMMEERRRROORR
            System error occurred (see eerrrrnnoo).

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

       EEPPOOSSTTEEDD
            The form is already posted.

       EECCOONNNNEECCTTEEDD
            The field is already connected to a form.

SEE ALSO
       ccuurrsseess(3X), ffoorrmm(3X).

NNOOTTEESS
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PPOORRTTAABBIILLIITTYY
       These routines emulate the System V forms library.  They were not  sup-
       ported on Version 7 or BSD versions.

       The  SVr4  forms  library documentation specifies the ffiieellddccoouunntt error
       value as -1 (which is the value of EERRRR).

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



                                                                formfield(3X)