diff options
Diffstat (limited to 'doc/gawk.info')
-rw-r--r-- | doc/gawk.info | 309 |
1 files changed, 159 insertions, 150 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 445d06dd..1337e0e2 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -25483,7 +25483,8 @@ use them. ' AWK_STRNUM,' ' AWK_ARRAY,' ' AWK_SCALAR, /* opaque access to a variable */' -' AWK_VALUE_COOKIE /* for updating a previously created value */' +' AWK_VALUE_COOKIE, /* for updating a previously created value */' +' AWK_BOOL' '} awk_valtype_t;' This 'enum' indicates the type of a value. It is used in the following 'struct'. @@ -25496,6 +25497,7 @@ use them. ' awk_array_t a;' ' awk_scalar_t scl;' ' awk_value_cookie_t vc;' +' awk_bool_t b;' ' } u;' '} awk_value_t;' An "'awk' value." The 'val_type' member indicates what kind of @@ -25511,6 +25513,7 @@ use them. '#define array_cookie u.a' '#define scalar_cookie u.scl' '#define value_cookie u.vc' +'#define bool_value u.b' Using these macros makes accessing the fields of the 'awk_value_t' more readable. @@ -25821,6 +25824,11 @@ code would use them: a 'char *' value pointing to data previously obtained from 'gawk_malloc()', 'gawk_calloc()', or 'gawk_realloc()'. +'static inline awk_value_t *' +'make_bool(awk_bool_t boolval, awk_value_t *result);' + This function creates a boolean value in the 'awk_value_t' variable + pointed to by 'result'. + File: gawk.info, Node: API Ownership of MPFR and GMP Values, Next: Registration Functions, Prev: Constructor Functions, Up: Extension API Description @@ -26546,16 +26554,17 @@ summarized in *note Table 17.2: table-value-types-returned. Type of Actual Value -------------------------------------------------------------------------- - String Strnum Number Regex Array Undefined -------------------------------------------------------------------------------- - String String String String String false false - Strnum false Strnum Strnum false false false - Number Number Number Number false false false -Type Regex false false false Regex false false -Requested Array false false false false Array false - Scalar Scalar Scalar Scalar Scalar false false - Undefined String Strnum Number Regex Array Undefined - Value false false false false false false + String Strnum Number Regex Bool Array Undefined +---------------------------------------------------------------------------------------- + String String String String String String false false + Strnum false Strnum Strnum false false false false + Number Number Number Number false Number false false +Type Regex false false false Regex false false false +Requested Bool false false false false Bool false false + Array false false false false false Array false + Scalar Scalar Scalar Scalar Scalar Scalar false false + Undefined String Strnum Number Regex Bool Array Undefined + Value false false false false false false false cookie Table 17.2: API value types returned @@ -38532,145 +38541,145 @@ Node: Extension API Description1022630 Node: Extension API Functions Introduction1024343 Ref: table-api-std-headers1026179 Node: General Data Types1030428 -Ref: General Data Types-Footnote-11039058 -Node: Memory Allocation Functions1039357 -Ref: Memory Allocation Functions-Footnote-11043858 -Node: Constructor Functions1043957 -Node: API Ownership of MPFR and GMP Values1047423 -Node: Registration Functions1048736 -Node: Extension Functions1049436 -Node: Exit Callback Functions1054758 -Node: Extension Version String1056008 -Node: Input Parsers1056671 -Node: Output Wrappers1069392 -Node: Two-way processors1073904 -Node: Printing Messages1076169 -Ref: Printing Messages-Footnote-11077340 -Node: Updating ERRNO1077493 -Node: Requesting Values1078232 -Ref: table-value-types-returned1078969 -Node: Accessing Parameters1079905 -Node: Symbol Table Access1081142 -Node: Symbol table by name1081654 -Ref: Symbol table by name-Footnote-11084678 -Node: Symbol table by cookie1084806 -Ref: Symbol table by cookie-Footnote-11088991 -Node: Cached values1089055 -Ref: Cached values-Footnote-11092591 -Node: Array Manipulation1092744 -Ref: Array Manipulation-Footnote-11093835 -Node: Array Data Types1093872 -Ref: Array Data Types-Footnote-11096530 -Node: Array Functions1096622 -Node: Flattening Arrays1101120 -Node: Creating Arrays1108096 -Node: Redirection API1112863 -Node: Extension API Variables1115696 -Node: Extension Versioning1116407 -Ref: gawk-api-version1116836 -Node: Extension GMP/MPFR Versioning1118567 -Node: Extension API Informational Variables1120195 -Node: Extension API Boilerplate1121268 -Node: Changes from API V11125242 -Node: Finding Extensions1126814 -Node: Extension Example1127373 -Node: Internal File Description1128171 -Node: Internal File Ops1132251 -Ref: Internal File Ops-Footnote-11143601 -Node: Using Internal File Ops1143741 -Ref: Using Internal File Ops-Footnote-11146124 -Node: Extension Samples1146398 -Node: Extension Sample File Functions1147927 -Node: Extension Sample Fnmatch1155576 -Node: Extension Sample Fork1157063 -Node: Extension Sample Inplace1158281 -Node: Extension Sample Ord1161907 -Node: Extension Sample Readdir1162743 -Ref: table-readdir-file-types1163632 -Node: Extension Sample Revout1164699 -Node: Extension Sample Rev2way1165288 -Node: Extension Sample Read write array1166028 -Node: Extension Sample Readfile1167970 -Node: Extension Sample Time1169065 -Node: Extension Sample API Tests1170817 -Node: gawkextlib1171309 -Node: Extension summary1174227 -Node: Extension Exercises1177929 -Node: Language History1179171 -Node: V7/SVR3.11180827 -Node: SVR41182979 -Node: POSIX1184413 -Node: BTL1185794 -Node: POSIX/GNU1186523 -Node: Feature History1192301 -Node: Common Extensions1208620 -Node: Ranges and Locales1209903 -Ref: Ranges and Locales-Footnote-11214519 -Ref: Ranges and Locales-Footnote-21214546 -Ref: Ranges and Locales-Footnote-31214781 -Node: Contributors1215004 -Node: History summary1221001 -Node: Installation1222381 -Node: Gawk Distribution1223325 -Node: Getting1223809 -Node: Extracting1224772 -Node: Distribution contents1226410 -Node: Unix Installation1232890 -Node: Quick Installation1233572 -Node: Shell Startup Files1235986 -Node: Additional Configuration Options1237075 -Node: Configuration Philosophy1239390 -Node: Non-Unix Installation1241759 -Node: PC Installation1242219 -Node: PC Binary Installation1243057 -Node: PC Compiling1243492 -Node: PC Using1244609 -Node: Cygwin1248162 -Node: MSYS1249386 -Node: VMS Installation1249988 -Node: VMS Compilation1250779 -Ref: VMS Compilation-Footnote-11252008 -Node: VMS Dynamic Extensions1252066 -Node: VMS Installation Details1253751 -Node: VMS Running1256004 -Node: VMS GNV1260283 -Node: VMS Old Gawk1261018 -Node: Bugs1261489 -Node: Bug address1262152 -Node: Usenet1265134 -Node: Maintainers1266138 -Node: Other Versions1267323 -Node: Installation summary1275188 -Node: Notes1276397 -Node: Compatibility Mode1277191 -Node: Additions1277973 -Node: Accessing The Source1278898 -Node: Adding Code1280335 -Node: New Ports1286554 -Node: Derived Files1290929 -Ref: Derived Files-Footnote-11296589 -Ref: Derived Files-Footnote-21296624 -Ref: Derived Files-Footnote-31297222 -Node: Future Extensions1297336 -Node: Implementation Limitations1297994 -Node: Extension Design1299204 -Node: Old Extension Problems1300348 -Ref: Old Extension Problems-Footnote-11301866 -Node: Extension New Mechanism Goals1301923 -Ref: Extension New Mechanism Goals-Footnote-11305287 -Node: Extension Other Design Decisions1305476 -Node: Extension Future Growth1307589 -Node: Notes summary1308195 -Node: Basic Concepts1309353 -Node: Basic High Level1310034 -Ref: figure-general-flow1310316 -Ref: figure-process-flow1311001 -Ref: Basic High Level-Footnote-11314302 -Node: Basic Data Typing1314487 -Node: Glossary1317815 -Node: Copying1349700 -Node: GNU Free Documentation License1387243 -Node: Index1412363 +Ref: General Data Types-Footnote-11039134 +Node: Memory Allocation Functions1039433 +Ref: Memory Allocation Functions-Footnote-11043934 +Node: Constructor Functions1044033 +Node: API Ownership of MPFR and GMP Values1047686 +Node: Registration Functions1048999 +Node: Extension Functions1049699 +Node: Exit Callback Functions1055021 +Node: Extension Version String1056271 +Node: Input Parsers1056934 +Node: Output Wrappers1069655 +Node: Two-way processors1074167 +Node: Printing Messages1076432 +Ref: Printing Messages-Footnote-11077603 +Node: Updating ERRNO1077756 +Node: Requesting Values1078495 +Ref: table-value-types-returned1079232 +Node: Accessing Parameters1080340 +Node: Symbol Table Access1081577 +Node: Symbol table by name1082089 +Ref: Symbol table by name-Footnote-11085113 +Node: Symbol table by cookie1085241 +Ref: Symbol table by cookie-Footnote-11089426 +Node: Cached values1089490 +Ref: Cached values-Footnote-11093026 +Node: Array Manipulation1093179 +Ref: Array Manipulation-Footnote-11094270 +Node: Array Data Types1094307 +Ref: Array Data Types-Footnote-11096965 +Node: Array Functions1097057 +Node: Flattening Arrays1101555 +Node: Creating Arrays1108531 +Node: Redirection API1113298 +Node: Extension API Variables1116131 +Node: Extension Versioning1116842 +Ref: gawk-api-version1117271 +Node: Extension GMP/MPFR Versioning1119002 +Node: Extension API Informational Variables1120630 +Node: Extension API Boilerplate1121703 +Node: Changes from API V11125677 +Node: Finding Extensions1127249 +Node: Extension Example1127808 +Node: Internal File Description1128606 +Node: Internal File Ops1132686 +Ref: Internal File Ops-Footnote-11144036 +Node: Using Internal File Ops1144176 +Ref: Using Internal File Ops-Footnote-11146559 +Node: Extension Samples1146833 +Node: Extension Sample File Functions1148362 +Node: Extension Sample Fnmatch1156011 +Node: Extension Sample Fork1157498 +Node: Extension Sample Inplace1158716 +Node: Extension Sample Ord1162342 +Node: Extension Sample Readdir1163178 +Ref: table-readdir-file-types1164067 +Node: Extension Sample Revout1165134 +Node: Extension Sample Rev2way1165723 +Node: Extension Sample Read write array1166463 +Node: Extension Sample Readfile1168405 +Node: Extension Sample Time1169500 +Node: Extension Sample API Tests1171252 +Node: gawkextlib1171744 +Node: Extension summary1174662 +Node: Extension Exercises1178364 +Node: Language History1179606 +Node: V7/SVR3.11181262 +Node: SVR41183414 +Node: POSIX1184848 +Node: BTL1186229 +Node: POSIX/GNU1186958 +Node: Feature History1192736 +Node: Common Extensions1209055 +Node: Ranges and Locales1210338 +Ref: Ranges and Locales-Footnote-11214954 +Ref: Ranges and Locales-Footnote-21214981 +Ref: Ranges and Locales-Footnote-31215216 +Node: Contributors1215439 +Node: History summary1221436 +Node: Installation1222816 +Node: Gawk Distribution1223760 +Node: Getting1224244 +Node: Extracting1225207 +Node: Distribution contents1226845 +Node: Unix Installation1233325 +Node: Quick Installation1234007 +Node: Shell Startup Files1236421 +Node: Additional Configuration Options1237510 +Node: Configuration Philosophy1239825 +Node: Non-Unix Installation1242194 +Node: PC Installation1242654 +Node: PC Binary Installation1243492 +Node: PC Compiling1243927 +Node: PC Using1245044 +Node: Cygwin1248597 +Node: MSYS1249821 +Node: VMS Installation1250423 +Node: VMS Compilation1251214 +Ref: VMS Compilation-Footnote-11252443 +Node: VMS Dynamic Extensions1252501 +Node: VMS Installation Details1254186 +Node: VMS Running1256439 +Node: VMS GNV1260718 +Node: VMS Old Gawk1261453 +Node: Bugs1261924 +Node: Bug address1262587 +Node: Usenet1265569 +Node: Maintainers1266573 +Node: Other Versions1267758 +Node: Installation summary1275623 +Node: Notes1276832 +Node: Compatibility Mode1277626 +Node: Additions1278408 +Node: Accessing The Source1279333 +Node: Adding Code1280770 +Node: New Ports1286989 +Node: Derived Files1291364 +Ref: Derived Files-Footnote-11297024 +Ref: Derived Files-Footnote-21297059 +Ref: Derived Files-Footnote-31297657 +Node: Future Extensions1297771 +Node: Implementation Limitations1298429 +Node: Extension Design1299639 +Node: Old Extension Problems1300783 +Ref: Old Extension Problems-Footnote-11302301 +Node: Extension New Mechanism Goals1302358 +Ref: Extension New Mechanism Goals-Footnote-11305722 +Node: Extension Other Design Decisions1305911 +Node: Extension Future Growth1308024 +Node: Notes summary1308630 +Node: Basic Concepts1309788 +Node: Basic High Level1310469 +Ref: figure-general-flow1310751 +Ref: figure-process-flow1311436 +Ref: Basic High Level-Footnote-11314737 +Node: Basic Data Typing1314922 +Node: Glossary1318250 +Node: Copying1350135 +Node: GNU Free Documentation License1387678 +Node: Index1412798 End Tag Table |