form_fieldtype man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]



form_field(3)					    form_field(3)

NAME
       form_fieldtype - define validation-field types

SYNOPSIS
       #include <form.h>
       FIELDTYPE *new_fieldtype(
	   bool (* const field_check)(FIELD *, const void *),
	   bool (* const char_check)(int, const void *));
       int free_fieldtype(FIELDTYPE *fieldtype);
       int set_fieldtype_arg(
	   FIELDTYPE *fieldtype,
	   void *(* const make_arg)(va_list *),
	   void *(* const copy_arg)(const void *),
	   void	 (* const free_arg)(void *));
       int set_fieldtype_choice(
	   FIELDTYPE *fieldtype
	   bool (* const next_choice)(FIELD *, const void *),
	   bool (* const prev_choice)(FIELD *, const void *));
       FIELDTYPE *link_fieldtype(FIELDTYPE *type1,
				 FIELDTYPE *type2);

DESCRIPTION
       The function new_fieldtype creates a new field type usable
       for data validation.  You supply it  with  field_check,	a
       predicate  to check the validity of an entered data string
       whenever the user attempt to leave a field.  The (FIELD *)
       argument	 is passed in so the validation predicate can see
       the field's buffer, sizes and other attributes; the second
       argument	 is an argument-block structure, about which more
       below.

       You also supply new_fieldtype with char_check, a	 function
       to  validate input characters as they are entered; it will
       be passed the character to be checked and a pointer to  an
       argument-block structure.

       The  function free_fieldtype frees the space allocated for
       a given validation type.

       The function set_fieldtype associates  three  storage-man-
       agement functions with a field type.  The mak_arg function
       is automatically applied to the list of arguments you give
       set_field_type  when  attaching validation to a field; its
       job is to bundle these into  an	allocated  argument-block
       object which can later be passed to validation predicated.
       The other two hook arguments should copy	 and  free  argu-
       ment-block  structures.	 They  will be used by the forms-
       driver code. You must supply  the  mak_arg  function,  the
       other  two  are optional, you may supply NULL for them. In
       this case it is assumed,	 that  mak_arg	doesn't	 allocate
       memory  but simply loads the argument into a single scalar
       value.

       The   form    driver    requests	   REQ_NEXT_CHOICE    and

								1

form_field(3)					    form_field(3)

       REQ_PREV_CHOICE assume that the possible values of a field
       form an ordered set, and provide the forms user with a way
       to  move	 through the set.  The set_fieldtype_choice func-
       tion allows forms programmers to define successor and pre-
       decessor	 functions  for	 the field type.  These functions
       take the field pointer and an argument-block structure  as
       arguments.

RETURN VALUE
       The pointer-valued routines return NULL on error.

       The  integer-valued  routines  return one of the following
       codes on error:

       E_OK The routine succeeded.

       E_SYSTEM_ERROR
	    System error occurred (see errno).

       E_BAD_ARGUMENT
	    Routine detected an incorrect or  out-of-range  argu-
	    ment.

       E_CONNECTED
	    The field is already connected to a form.

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

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

       All of the (char *) arguments of	 these	functions  should
       actually	 be (void *).  The type has been left uncorrected
       for strict compatibility with System V.

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.

								2

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net