diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 285 |
1 files changed, 146 insertions, 139 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 996e3669..6fc7fd91 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -23939,10 +23939,11 @@ library than was used for the 'gawk' executable.(1) If 'gawk' were to use its version of 'free()' when the memory came from an unrelated version of 'malloc()', unexpected behavior would likely result. - Two convenience macros may be used for allocating storage from -'gawk_malloc()' and 'gawk_realloc()'. If the allocation fails, they -cause 'gawk' to exit with a fatal error message. They should be used as -if they were procedure calls that do not return a value: + Three convenience macros may be used for allocating storage from +'gawk_malloc()', 'gawk_calloc', and 'gawk_realloc()'. If the allocation +fails, they cause 'gawk' to exit with a fatal error message. They +should be used as if they were procedure calls that do not return a +value: '#define emalloc(pointer, type, size, message) ...' The arguments to this macro are as follows: @@ -23971,6 +23972,12 @@ if they were procedure calls that do not return a value: strcpy(message, greet); make_malloced_string(message, strlen(message), & result); +'#define ezalloc(pointer, type, size, message) ...' + This is like 'emalloc()', but it calls 'gawk_calloc()' instead of + 'gawk_malloc()'. The arguments are the same as for the 'emalloc()' + macro, but this macro guarantees that the memory returned is + initialized to zero. + '#define erealloc(pointer, type, size, message) ...' This is like 'emalloc()', but it calls 'gawk_realloc()' instead of 'gawk_malloc()'. The arguments are the same as for the 'emalloc()' @@ -36106,140 +36113,140 @@ Node: Extension API Functions Introduction958934 Node: General Data Types964268 Ref: General Data Types-Footnote-1971473 Node: Memory Allocation Functions971772 -Ref: Memory Allocation Functions-Footnote-1974617 -Node: Constructor Functions974716 -Node: Registration Functions977715 -Node: Extension Functions978400 -Node: Exit Callback Functions983613 -Node: Extension Version String984863 -Node: Input Parsers985526 -Node: Output Wrappers998233 -Node: Two-way processors1002745 -Node: Printing Messages1005010 -Ref: Printing Messages-Footnote-11006181 -Node: Updating ERRNO1006334 -Node: Requesting Values1007073 -Ref: table-value-types-returned1007810 -Node: Accessing Parameters1008746 -Node: Symbol Table Access1009981 -Node: Symbol table by name1010493 -Node: Symbol table by cookie1012282 -Ref: Symbol table by cookie-Footnote-11016467 -Node: Cached values1016531 -Ref: Cached values-Footnote-11020067 -Node: Array Manipulation1020158 -Ref: Array Manipulation-Footnote-11021249 -Node: Array Data Types1021286 -Ref: Array Data Types-Footnote-11023944 -Node: Array Functions1024036 -Node: Flattening Arrays1028435 -Node: Creating Arrays1035376 -Node: Redirection API1040145 -Node: Extension API Variables1042987 -Node: Extension Versioning1043620 -Ref: gawk-api-version1044057 -Node: Extension API Informational Variables1045785 -Node: Extension API Boilerplate1046849 -Node: Changes from API V11050711 -Node: Finding Extensions1051371 -Node: Extension Example1051930 -Node: Internal File Description1052728 -Node: Internal File Ops1056808 -Ref: Internal File Ops-Footnote-11068208 -Node: Using Internal File Ops1068348 -Ref: Using Internal File Ops-Footnote-11070731 -Node: Extension Samples1071005 -Node: Extension Sample File Functions1072534 -Node: Extension Sample Fnmatch1080183 -Node: Extension Sample Fork1081670 -Node: Extension Sample Inplace1082888 -Node: Extension Sample Ord1086105 -Node: Extension Sample Readdir1086941 -Ref: table-readdir-file-types1087830 -Node: Extension Sample Revout1088635 -Node: Extension Sample Rev2way1089224 -Node: Extension Sample Read write array1089964 -Node: Extension Sample Readfile1091906 -Node: Extension Sample Time1093001 -Node: Extension Sample API Tests1094349 -Node: gawkextlib1094841 -Node: Extension summary1097288 -Node: Extension Exercises1100990 -Node: Language History1102488 -Node: V7/SVR3.11104144 -Node: SVR41106296 -Node: POSIX1107730 -Node: BTL1109109 -Node: POSIX/GNU1109838 -Node: Feature History1115616 -Node: Common Extensions1129981 -Node: Ranges and Locales1131264 -Ref: Ranges and Locales-Footnote-11135880 -Ref: Ranges and Locales-Footnote-21135907 -Ref: Ranges and Locales-Footnote-31136142 -Node: Contributors1136363 -Node: History summary1141923 -Node: Installation1143303 -Node: Gawk Distribution1144247 -Node: Getting1144731 -Node: Extracting1145692 -Node: Distribution contents1147330 -Node: Unix Installation1153672 -Node: Quick Installation1154354 -Node: Shell Startup Files1156768 -Node: Additional Configuration Options1157857 -Node: Configuration Philosophy1159846 -Node: Non-Unix Installation1162215 -Node: PC Installation1162675 -Node: PC Binary Installation1163513 -Node: PC Compiling1163948 -Node: PC Using1165065 -Node: Cygwin1168110 -Node: MSYS1168880 -Node: VMS Installation1169381 -Node: VMS Compilation1170172 -Ref: VMS Compilation-Footnote-11171401 -Node: VMS Dynamic Extensions1171459 -Node: VMS Installation Details1173144 -Node: VMS Running1175397 -Node: VMS GNV1179676 -Node: VMS Old Gawk1180411 -Node: Bugs1180882 -Node: Bug address1181545 -Node: Usenet1183942 -Node: Maintainers1184719 -Node: Other Versions1186095 -Node: Installation summary1192679 -Node: Notes1193714 -Node: Compatibility Mode1194579 -Node: Additions1195361 -Node: Accessing The Source1196286 -Node: Adding Code1197721 -Node: New Ports1203939 -Node: Derived Files1208427 -Ref: Derived Files-Footnote-11213912 -Ref: Derived Files-Footnote-21213947 -Ref: Derived Files-Footnote-31214545 -Node: Future Extensions1214659 -Node: Implementation Limitations1215317 -Node: Extension Design1216500 -Node: Old Extension Problems1217654 -Ref: Old Extension Problems-Footnote-11219172 -Node: Extension New Mechanism Goals1219229 -Ref: Extension New Mechanism Goals-Footnote-11222593 -Node: Extension Other Design Decisions1222782 -Node: Extension Future Growth1224895 -Node: Old Extension Mechanism1225731 -Node: Notes summary1227494 -Node: Basic Concepts1228676 -Node: Basic High Level1229357 -Ref: figure-general-flow1229639 -Ref: figure-process-flow1230324 -Ref: Basic High Level-Footnote-11233625 -Node: Basic Data Typing1233810 -Node: Glossary1237138 -Node: Copying1269085 -Node: GNU Free Documentation License1306624 -Node: Index1331742 +Ref: Memory Allocation Functions-Footnote-1974924 +Node: Constructor Functions975023 +Node: Registration Functions978022 +Node: Extension Functions978707 +Node: Exit Callback Functions983920 +Node: Extension Version String985170 +Node: Input Parsers985833 +Node: Output Wrappers998540 +Node: Two-way processors1003052 +Node: Printing Messages1005317 +Ref: Printing Messages-Footnote-11006488 +Node: Updating ERRNO1006641 +Node: Requesting Values1007380 +Ref: table-value-types-returned1008117 +Node: Accessing Parameters1009053 +Node: Symbol Table Access1010288 +Node: Symbol table by name1010800 +Node: Symbol table by cookie1012589 +Ref: Symbol table by cookie-Footnote-11016774 +Node: Cached values1016838 +Ref: Cached values-Footnote-11020374 +Node: Array Manipulation1020465 +Ref: Array Manipulation-Footnote-11021556 +Node: Array Data Types1021593 +Ref: Array Data Types-Footnote-11024251 +Node: Array Functions1024343 +Node: Flattening Arrays1028742 +Node: Creating Arrays1035683 +Node: Redirection API1040452 +Node: Extension API Variables1043294 +Node: Extension Versioning1043927 +Ref: gawk-api-version1044364 +Node: Extension API Informational Variables1046092 +Node: Extension API Boilerplate1047156 +Node: Changes from API V11051018 +Node: Finding Extensions1051678 +Node: Extension Example1052237 +Node: Internal File Description1053035 +Node: Internal File Ops1057115 +Ref: Internal File Ops-Footnote-11068515 +Node: Using Internal File Ops1068655 +Ref: Using Internal File Ops-Footnote-11071038 +Node: Extension Samples1071312 +Node: Extension Sample File Functions1072841 +Node: Extension Sample Fnmatch1080490 +Node: Extension Sample Fork1081977 +Node: Extension Sample Inplace1083195 +Node: Extension Sample Ord1086412 +Node: Extension Sample Readdir1087248 +Ref: table-readdir-file-types1088137 +Node: Extension Sample Revout1088942 +Node: Extension Sample Rev2way1089531 +Node: Extension Sample Read write array1090271 +Node: Extension Sample Readfile1092213 +Node: Extension Sample Time1093308 +Node: Extension Sample API Tests1094656 +Node: gawkextlib1095148 +Node: Extension summary1097595 +Node: Extension Exercises1101297 +Node: Language History1102795 +Node: V7/SVR3.11104451 +Node: SVR41106603 +Node: POSIX1108037 +Node: BTL1109416 +Node: POSIX/GNU1110145 +Node: Feature History1115923 +Node: Common Extensions1130288 +Node: Ranges and Locales1131571 +Ref: Ranges and Locales-Footnote-11136187 +Ref: Ranges and Locales-Footnote-21136214 +Ref: Ranges and Locales-Footnote-31136449 +Node: Contributors1136670 +Node: History summary1142230 +Node: Installation1143610 +Node: Gawk Distribution1144554 +Node: Getting1145038 +Node: Extracting1145999 +Node: Distribution contents1147637 +Node: Unix Installation1153979 +Node: Quick Installation1154661 +Node: Shell Startup Files1157075 +Node: Additional Configuration Options1158164 +Node: Configuration Philosophy1160153 +Node: Non-Unix Installation1162522 +Node: PC Installation1162982 +Node: PC Binary Installation1163820 +Node: PC Compiling1164255 +Node: PC Using1165372 +Node: Cygwin1168417 +Node: MSYS1169187 +Node: VMS Installation1169688 +Node: VMS Compilation1170479 +Ref: VMS Compilation-Footnote-11171708 +Node: VMS Dynamic Extensions1171766 +Node: VMS Installation Details1173451 +Node: VMS Running1175704 +Node: VMS GNV1179983 +Node: VMS Old Gawk1180718 +Node: Bugs1181189 +Node: Bug address1181852 +Node: Usenet1184249 +Node: Maintainers1185026 +Node: Other Versions1186402 +Node: Installation summary1192986 +Node: Notes1194021 +Node: Compatibility Mode1194886 +Node: Additions1195668 +Node: Accessing The Source1196593 +Node: Adding Code1198028 +Node: New Ports1204246 +Node: Derived Files1208734 +Ref: Derived Files-Footnote-11214219 +Ref: Derived Files-Footnote-21214254 +Ref: Derived Files-Footnote-31214852 +Node: Future Extensions1214966 +Node: Implementation Limitations1215624 +Node: Extension Design1216807 +Node: Old Extension Problems1217961 +Ref: Old Extension Problems-Footnote-11219479 +Node: Extension New Mechanism Goals1219536 +Ref: Extension New Mechanism Goals-Footnote-11222900 +Node: Extension Other Design Decisions1223089 +Node: Extension Future Growth1225202 +Node: Old Extension Mechanism1226038 +Node: Notes summary1227801 +Node: Basic Concepts1228983 +Node: Basic High Level1229664 +Ref: figure-general-flow1229946 +Ref: figure-process-flow1230631 +Ref: Basic High Level-Footnote-11233932 +Node: Basic Data Typing1234117 +Node: Glossary1237445 +Node: Copying1269392 +Node: GNU Free Documentation License1306931 +Node: Index1332049 End Tag Table |