From 7d02088c7c8731ae5c5b2810d1c30d7f77b29687 Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Fri, 23 Dec 2016 06:54:05 +0200 Subject: Update API table of values requested / returned. --- doc/gawk.texi | 113 +++++++++++++++++++++++++++++++++++++++------------------- 1 file changed, 76 insertions(+), 37 deletions(-) (limited to 'doc/gawk.texi') diff --git a/doc/gawk.texi b/doc/gawk.texi index 2a7f1c58..25468301 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -32581,7 +32581,7 @@ The @code{val_type} member indicates what kind of value the @code{union} holds, and each member is of the appropriate type. @item #define str_value@ @ @ @ @ @ u.s -@itemx #define strnum_value@ @ @ @ str_value +@itemx #define strnum_value@ @ @ str_value @itemx #define regex_value@ @ @ @ str_value @itemx #define num_value@ @ @ @ @ @ u.d @itemx #define array_cookie@ @ @ u.a @@ -33501,22 +33501,27 @@ value type, as appropriate. This behavior is summarized in @caption{API value types returned} @c FIXME: This needs doing. @docbook + - - - - - - - - + + + + + + + + + + Type of Actual Value String + Strnum Number + Regex Array Undefined @@ -33527,55 +33532,86 @@ value type, as appropriate. This behavior is summarized in String String String - False - False + String + String + false + false + + + + Strnum + false + Strnum + Strnum + false + false + false Number - Number if can be converted, else false Number - False - False + Number + Number + false + false + false Type + Regex + false + false + Regex + false + false + false + + + Requested Array - False - False + false + false + false + false Array - False + false - Requested + Scalar Scalar Scalar - False - False + Scalar + Scalar + false + false Undefined String + Strnum Number + Regex Array Undefined Value cookie - False - False - False - False + false + false + false + false + false + false @end docbook -@c FIXME: This needs doing. @ifnotplaintext @ifnotdocbook @multitable @columnfractions .50 .50 @@ -33585,19 +33621,22 @@ value type, as appropriate. This behavior is summarized in @tex \vglue-1.1\baselineskip @end tex -@multitable @columnfractions .166 .166 .198 .15 .15 .166 -@headitem @tab @tab String @tab Number @tab Array @tab Undefined -@item @tab @b{String} @tab String @tab String @tab False @tab False -@item @tab @b{Number} @tab Number if can be converted, else false @tab Number @tab False @tab False -@item @b{Type} @tab @b{Array} @tab False @tab False @tab Array @tab False -@item @b{Requested} @tab @b{Scalar} @tab Scalar @tab Scalar @tab False @tab False -@item @tab @b{Undefined} @tab String @tab Number @tab Array @tab Undefined -@item @tab @b{Value cookie} @tab False @tab False @tab False @tab False +@c @multitable @columnfractions .166 .166 .198 .15 .15 .166 +@multitable {Requested} {Undefined} {Number} {Number} {Scalar} {Regex} {Array} {Undefined} +@headitem @tab @tab String @tab Strnum @tab Number @tab Regex @tab Array @tab Undefined +@item @tab @b{String} @tab String @tab String @tab String @tab String @tab false @tab false +@item @tab @b{Strnum} @tab false @tab Strnum @tab Strnum @tab false @tab false @tab false +@item @tab @b{Number} @tab Number @tab Number @tab Number @tab false @tab false @tab false +@item @b{Type} @tab @b{Regex} @tab false @tab false @tab false @tab Regex @tab false @tab false +@item @b{Requested} @tab @b{Array} @tab false @tab false @tab false @tab false @tab Array @tab false +@item @tab @b{Scalar} @tab Scalar @tab Scalar @tab Scalar @tab Scalar @tab false @tab false +@item @tab @b{Undefined} @tab String @tab Strnum @tab Number @tab Regex @tab Array @tab Undefined +@item @tab @b{Value cookie} @tab false @tab false @tab false @tab false @tab false @tab false @end multitable @end ifnotdocbook @end ifnotplaintext @ifplaintext -@example +@verbatim +-------------------------------------------------------+ | Type of Actual Value: | +--------+--------+--------+--------+-------+-----------+ @@ -33610,9 +33649,9 @@ value type, as appropriate. This behavior is summarized in | | Number | Number | Number | Number | false | false | false | | +-----------+--------+--------+--------+--------+-------+-----------+ | | Regex | false | false | false | Regex | false | false | +| Type +-----------+--------+--------+--------+--------+-------+-----------+ +| Requested | Array | false | false | false | false | Array | false | | +-----------+--------+--------+--------+--------+-------+-----------+ -| Type | Array | false | false | false | false | Array | false | -| Requested +-----------+--------+--------+--------+--------+-------+-----------+ | | Scalar | Scalar | Scalar | Scalar | Scalar | false | false | | +-----------+--------+--------+--------+--------+-------+-----------+ | | Undefined | String | Strnum | Number | Regex | Array | Undefined | @@ -33620,7 +33659,7 @@ value type, as appropriate. This behavior is summarized in | | Value | false | false | false | false | false | false | | | Cookie | | | | | | | +-----------+-----------+--------+--------+--------+--------+-------+-----------+ -@end example +@end verbatim @end ifplaintext @end float -- cgit v1.2.3