X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_field_validation.3x.html;h=4dbed031ee7c745a7de8f425d9bceb05257ca6b6;hb=refs%2Ftags%2Fv5.6;hp=93cae7f4c5d745cd462256407f99b6cdd73045f3;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01;p=ncurses.git diff --git a/doc/html/man/form_field_validation.3x.html b/doc/html/man/form_field_validation.3x.html index 93cae7f4..4dbed031 100644 --- a/doc/html/man/form_field_validation.3x.html +++ b/doc/html/man/form_field_validation.3x.html @@ -1,7 +1,7 @@
@@ -40,6 +40,10 @@+form_field_validation(3x) form_field_validation(3x) + + +
@@ -53,12 +57,20 @@ FIELDTYPE *field_type(const FIELD *field); void *field_arg(const FIELD *field); + FIELDTYPE *TYPE_ALNUM; + FIELDTYPE *TYPE_ALPHA; + FIELDTYPE *TYPE_ENUM; + FIELDTYPE *TYPE_INTEGER; + FIELDTYPE *TYPE_NUMERIC; + FIELDTYPE *TYPE_REGEXP; + FIELDTYPE *TYPE_IPV4; +
The function set_field_type declares a data type for a given form field. This is the type checked by validation - functions. The types are as follows: + functions. The predefined types are as follows: TYPE_ALNUM Alphanumeric data. Requires a third int argument, a @@ -78,7 +90,7 @@ than one list elements with that prefix). Please notice that the string list is not copied, only a reference to it is stored in the field. So you should - avoid to use a list that lives in automatic variables + avoid using a list that lives in automatic variables on the stack. TYPE_INTEGER @@ -86,9 +98,9 @@ Requires a third int argument controlling the preci- sion, a fourth long argument constraining minimum value, and a fifth long constraining maximum value. - If the maximum value is less or equal the minimum - value, the range is simply ignored. On return the - field buffer is formatted according to the printf + If the maximum value is less than or equal to the + minimum value, the range is simply ignored. On return + the field buffer is formatted according to the printf format specification ".*ld", where the '*' is replaced by the precision argument. For details of the precision handling see printf's man-page. @@ -98,47 +110,48 @@ Requires a third int argument controlling the preci- sion, a fourth double argument constraining minimum value, and a fifth double constraining maximum value. - If your system supports locale's, the decimal point + If your system supports locales, the decimal point character to be used must be the one specified by - your locale. If the maximum value is less or equal - the minimum value, the range is simply ignored. On - return the field buffer is formatted according to the - printf format specification ".*f", where the '*' is - replaced by the precision argument. For details of - the precision handling see printf's man-page. + your locale. If the maximum value is less than or + equal to the minimum value, the range is simply + ignored. On return the field buffer is formatted + according to the printf format specification ".*f", + where the '*' is replaced by the precision argument. + For details of the precision handling see printf's + man-page. TYPE_REGEXP - Regular expression data. Requires a regular expres- - sion (char *) third argument; the data is valid if - the regular expression matches it. Regular expres- - sions are in the format of regcomp(3x) and - regexec(3x). Please notice that the regular expres- - sion must match the whole field. If you have for - example an eight character wide field, a regular - expression "^[0-9]*$" always means that you have to - fill all eight positions with digits. If you want to - allow fewer digits, you may use for example "^[0-9]* + Regular expression data. Requires a regular expres- + sion (char *) third argument; the data is valid if + the regular expression matches it. Regular expres- + sions are in the format of regcomp(3x) and + regexec(3x). Please notice that the regular expres- + sion must match the whole field. If you have for + example an eight character wide field, a regular + expression "^[0-9]*$" always means that you have to + fill all eight positions with digits. If you want to + allow fewer digits, you may use for example "^[0-9]* *$" which is good for trailing spaces (up to an empty - field), or "^ *[0-9]* *$" which is good for leading + field), or "^ *[0-9]* *$" which is good for leading and trailing spaces around the digits. TYPE_IPV4 An Internet Protocol Version 4 address. This requires - no additional argument. It is checked whether or not - the buffer has the form a.b.c.d, where a,b,c and d + no additional argument. It is checked whether or not + the buffer has the form a.b.c.d, where a,b,c and d are numbers between 0 and 255. Trailing blanks in the - buffer are ignored. The address itself is not vali- + buffer are ignored. The address itself is not vali- dated. Please note that this is an ncurses extension. - This field type may not be available in other curses + This field type may not be available in other curses implementations. - It is possible to set up new programmer-defined field - types. See the form_fieldtype(3x) manual page. + It is possible to set up new programmer-defined field + types. See the form_fieldtype(3x) manual page.
- The functions field_type and field_arg return NULL on + The functions field_type and field_arg return NULL on error. The function set_field_type returns one of the fol- lowing: @@ -161,63 +174,18 @@
- These routines emulate the System V forms library. They + These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions.
- Juergen Pfeifer. Manual pages and adaptation for new + Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + form_field_validation(3x)