diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 489 |
1 files changed, 249 insertions, 240 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index f0450b45..037df3d0 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -21551,6 +21551,15 @@ both values to lowercase in order to compare them ignoring case. -| A a B b c C D d e E F f g G H h i I J j k K l L M m -| n N O o p P Q q r R S s t T u U V v w W X x y Y z Z + NOTE: 'Under the hood," 'gawk' uses the C library 'qsort()' + function to manage the sorting. 'qsort()' can call itself + recursively. This means that when you write a comparison function, + you should be careful to avoid the use of global variables and + arrays; use only local variables and arrays that you declare as + additional parameters to the comparison function. Otherwise, you + are likely to cause unintentional memory corruption in your global + arrays and possibly cause 'gawk' itself to fail. + ---------- Footnotes ---------- (1) This is true because locale-based comparison occurs only when in @@ -39138,246 +39147,246 @@ Node: Array Sorting859863 Node: Controlling Array Traversal860568 Ref: Controlling Array Traversal-Footnote-1868936 Node: Array Sorting Functions869054 -Ref: Array Sorting Functions-Footnote-1874428 -Node: Two-way I/O874624 -Ref: Two-way I/O-Footnote-1882350 -Ref: Two-way I/O-Footnote-2882537 -Node: TCP/IP Networking882619 -Node: Profiling885695 -Node: Extension Philosophy895004 -Node: Advanced Features Summary896483 -Node: Internationalization898498 -Node: I18N and L10N900172 -Node: Explaining gettext900859 -Ref: Explaining gettext-Footnote-1906751 -Ref: Explaining gettext-Footnote-2906936 -Node: Programmer i18n907101 -Ref: Programmer i18n-Footnote-1912050 -Node: Translator i18n912099 -Node: String Extraction912893 -Ref: String Extraction-Footnote-1914025 -Node: Printf Ordering914111 -Ref: Printf Ordering-Footnote-1916897 -Node: I18N Portability916961 -Ref: I18N Portability-Footnote-1919417 -Node: I18N Example919480 -Ref: I18N Example-Footnote-1922755 -Ref: I18N Example-Footnote-2922828 -Node: Gawk I18N922937 -Node: I18N Summary923559 -Node: Debugger924900 -Node: Debugging925900 -Node: Debugging Concepts926341 -Node: Debugging Terms928150 -Node: Awk Debugging930725 -Ref: Awk Debugging-Footnote-1931670 -Node: Sample Debugging Session931802 -Node: Debugger Invocation932336 -Node: Finding The Bug933722 -Node: List of Debugger Commands940196 -Node: Breakpoint Control941529 -Node: Debugger Execution Control945223 -Node: Viewing And Changing Data948585 -Node: Execution Stack952126 -Node: Debugger Info953763 -Node: Miscellaneous Debugger Commands957834 -Node: Readline Support962896 -Node: Limitations963792 -Node: Debugging Summary966346 -Node: Namespaces967625 -Node: Global Namespace968736 -Node: Qualified Names970134 -Node: Default Namespace971133 -Node: Changing The Namespace971874 -Node: Naming Rules973488 -Node: Internal Name Management975336 -Node: Namespace Example976378 -Node: Namespace And Features978940 -Node: Namespace Summary980375 -Node: Arbitrary Precision Arithmetic981852 -Node: Computer Arithmetic983339 -Ref: table-numeric-ranges987105 -Ref: table-floating-point-ranges987599 -Ref: Computer Arithmetic-Footnote-1988258 -Node: Math Definitions988315 -Ref: table-ieee-formats991291 -Node: MPFR features991859 -Node: FP Math Caution993577 -Ref: FP Math Caution-Footnote-1994649 -Node: Inexactness of computations995018 -Node: Inexact representation996049 -Node: Comparing FP Values997409 -Node: Errors accumulate998650 -Node: Strange values1000106 -Ref: Strange values-Footnote-11002694 -Node: Getting Accuracy1002799 -Node: Try To Round1005509 -Node: Setting precision1006408 -Ref: table-predefined-precision-strings1007105 -Node: Setting the rounding mode1008936 -Ref: table-gawk-rounding-modes1009310 -Ref: Setting the rounding mode-Footnote-11013242 -Node: Arbitrary Precision Integers1013421 -Ref: Arbitrary Precision Integers-Footnote-11016596 -Node: Checking for MPFR1016745 -Node: POSIX Floating Point Problems1018219 -Ref: POSIX Floating Point Problems-Footnote-11022872 -Node: Floating point summary1022910 -Node: Dynamic Extensions1025100 -Node: Extension Intro1026653 -Node: Plugin License1027919 -Node: Extension Mechanism Outline1028716 -Ref: figure-load-extension1029155 -Ref: figure-register-new-function1030721 -Ref: figure-call-new-function1031814 -Node: Extension API Description1033877 -Node: Extension API Functions Introduction1035590 -Ref: table-api-std-headers1037426 -Node: General Data Types1041676 -Ref: General Data Types-Footnote-11050382 -Node: Memory Allocation Functions1050681 -Ref: Memory Allocation Functions-Footnote-11055182 -Node: Constructor Functions1055281 -Node: API Ownership of MPFR and GMP Values1058934 -Node: Registration Functions1060467 -Node: Extension Functions1061167 -Node: Exit Callback Functions1066489 -Node: Extension Version String1067739 -Node: Input Parsers1068402 -Node: Output Wrappers1081123 -Node: Two-way processors1085635 -Node: Printing Messages1087900 -Ref: Printing Messages-Footnote-11089071 -Node: Updating ERRNO1089224 -Node: Requesting Values1089963 -Ref: table-value-types-returned1090700 -Node: Accessing Parameters1091809 -Node: Symbol Table Access1093046 -Node: Symbol table by name1093558 -Ref: Symbol table by name-Footnote-11096583 -Node: Symbol table by cookie1096711 -Ref: Symbol table by cookie-Footnote-11100896 -Node: Cached values1100960 -Ref: Cached values-Footnote-11104496 -Node: Array Manipulation1104649 -Ref: Array Manipulation-Footnote-11105740 -Node: Array Data Types1105777 -Ref: Array Data Types-Footnote-11108435 -Node: Array Functions1108527 -Node: Flattening Arrays1113025 -Node: Creating Arrays1120001 -Node: Redirection API1124768 -Node: Extension API Variables1127601 -Node: Extension Versioning1128312 -Ref: gawk-api-version1128741 -Node: Extension GMP/MPFR Versioning1130473 -Node: Extension API Informational Variables1132101 -Node: Extension API Boilerplate1133174 -Node: Changes from API V11137148 -Node: Finding Extensions1138720 -Node: Extension Example1139279 -Node: Internal File Description1140077 -Node: Internal File Ops1144157 -Ref: Internal File Ops-Footnote-11155507 -Node: Using Internal File Ops1155647 -Ref: Using Internal File Ops-Footnote-11158030 -Node: Extension Samples1158304 -Node: Extension Sample File Functions1159833 -Node: Extension Sample Fnmatch1167482 -Node: Extension Sample Fork1168969 -Node: Extension Sample Inplace1170187 -Node: Extension Sample Ord1173813 -Node: Extension Sample Readdir1174649 -Ref: table-readdir-file-types1175538 -Node: Extension Sample Revout1176606 -Node: Extension Sample Rev2way1177195 -Node: Extension Sample Read write array1177935 -Node: Extension Sample Readfile1181100 -Node: Extension Sample Time1182195 -Node: Extension Sample API Tests1183947 -Node: gawkextlib1184439 -Node: Extension summary1187357 -Node: Extension Exercises1191059 -Node: Language History1192301 -Node: V7/SVR3.11193957 -Node: SVR41196109 -Node: POSIX1197543 -Node: BTL1198924 -Node: POSIX/GNU1199653 -Node: Feature History1205431 -Node: Common Extensions1222606 -Node: Ranges and Locales1223889 -Ref: Ranges and Locales-Footnote-11228505 -Ref: Ranges and Locales-Footnote-21228532 -Ref: Ranges and Locales-Footnote-31228767 -Node: Contributors1228990 -Node: History summary1234987 -Node: Installation1236367 -Node: Gawk Distribution1237311 -Node: Getting1237795 -Node: Extracting1238758 -Node: Distribution contents1240396 -Node: Unix Installation1247457 -Node: Quick Installation1248261 -Node: Compiling with MPFR1250681 -Node: Shell Startup Files1251371 -Node: Additional Configuration Options1252460 -Node: Configuration Philosophy1254775 -Node: Compiling from Git1257171 -Node: Building the Documentation1257726 -Node: Non-Unix Installation1259110 -Node: PC Installation1259570 -Node: PC Binary Installation1260408 -Node: PC Compiling1261281 -Node: PC Using1262398 -Node: Cygwin1265951 -Node: MSYS1267175 -Node: VMS Installation1267777 -Node: VMS Compilation1268496 -Ref: VMS Compilation-Footnote-11269725 -Node: VMS Dynamic Extensions1269783 -Node: VMS Installation Details1271468 -Node: VMS Running1273730 -Node: VMS GNV1278009 -Node: Bugs1278723 -Node: Bug definition1279635 -Node: Bug address1282571 -Node: Usenet1285959 -Node: Performance bugs1287148 -Node: Asking for help1290069 -Node: Maintainers1292036 -Node: Other Versions1293230 -Node: Installation summary1301394 -Node: Notes1302758 -Node: Compatibility Mode1303552 -Node: Additions1304334 -Node: Accessing The Source1305259 -Node: Adding Code1306696 -Node: New Ports1312888 -Node: Derived Files1317263 -Ref: Derived Files-Footnote-11322923 -Ref: Derived Files-Footnote-21322958 -Ref: Derived Files-Footnote-31323556 -Node: Future Extensions1323670 -Node: Implementation Limitations1324328 -Node: Extension Design1325538 -Node: Old Extension Problems1326682 -Ref: Old Extension Problems-Footnote-11328200 -Node: Extension New Mechanism Goals1328257 -Ref: Extension New Mechanism Goals-Footnote-11331621 -Node: Extension Other Design Decisions1331810 -Node: Extension Future Growth1333923 -Node: Notes summary1334529 -Node: Basic Concepts1335687 -Node: Basic High Level1336368 -Ref: figure-general-flow1336650 -Ref: figure-process-flow1337336 -Ref: Basic High Level-Footnote-11340638 -Node: Basic Data Typing1340823 -Node: Glossary1344151 -Node: Copying1376038 -Node: GNU Free Documentation License1413581 -Node: Index1438701 +Ref: Array Sorting Functions-Footnote-1874965 +Node: Two-way I/O875161 +Ref: Two-way I/O-Footnote-1882887 +Ref: Two-way I/O-Footnote-2883074 +Node: TCP/IP Networking883156 +Node: Profiling886232 +Node: Extension Philosophy895541 +Node: Advanced Features Summary897020 +Node: Internationalization899035 +Node: I18N and L10N900709 +Node: Explaining gettext901396 +Ref: Explaining gettext-Footnote-1907288 +Ref: Explaining gettext-Footnote-2907473 +Node: Programmer i18n907638 +Ref: Programmer i18n-Footnote-1912587 +Node: Translator i18n912636 +Node: String Extraction913430 +Ref: String Extraction-Footnote-1914562 +Node: Printf Ordering914648 +Ref: Printf Ordering-Footnote-1917434 +Node: I18N Portability917498 +Ref: I18N Portability-Footnote-1919954 +Node: I18N Example920017 +Ref: I18N Example-Footnote-1923292 +Ref: I18N Example-Footnote-2923365 +Node: Gawk I18N923474 +Node: I18N Summary924096 +Node: Debugger925437 +Node: Debugging926437 +Node: Debugging Concepts926878 +Node: Debugging Terms928687 +Node: Awk Debugging931262 +Ref: Awk Debugging-Footnote-1932207 +Node: Sample Debugging Session932339 +Node: Debugger Invocation932873 +Node: Finding The Bug934259 +Node: List of Debugger Commands940733 +Node: Breakpoint Control942066 +Node: Debugger Execution Control945760 +Node: Viewing And Changing Data949122 +Node: Execution Stack952663 +Node: Debugger Info954300 +Node: Miscellaneous Debugger Commands958371 +Node: Readline Support963433 +Node: Limitations964329 +Node: Debugging Summary966883 +Node: Namespaces968162 +Node: Global Namespace969273 +Node: Qualified Names970671 +Node: Default Namespace971670 +Node: Changing The Namespace972411 +Node: Naming Rules974025 +Node: Internal Name Management975873 +Node: Namespace Example976915 +Node: Namespace And Features979477 +Node: Namespace Summary980912 +Node: Arbitrary Precision Arithmetic982389 +Node: Computer Arithmetic983876 +Ref: table-numeric-ranges987642 +Ref: table-floating-point-ranges988136 +Ref: Computer Arithmetic-Footnote-1988795 +Node: Math Definitions988852 +Ref: table-ieee-formats991828 +Node: MPFR features992396 +Node: FP Math Caution994114 +Ref: FP Math Caution-Footnote-1995186 +Node: Inexactness of computations995555 +Node: Inexact representation996586 +Node: Comparing FP Values997946 +Node: Errors accumulate999187 +Node: Strange values1000643 +Ref: Strange values-Footnote-11003231 +Node: Getting Accuracy1003336 +Node: Try To Round1006046 +Node: Setting precision1006945 +Ref: table-predefined-precision-strings1007642 +Node: Setting the rounding mode1009473 +Ref: table-gawk-rounding-modes1009847 +Ref: Setting the rounding mode-Footnote-11013779 +Node: Arbitrary Precision Integers1013958 +Ref: Arbitrary Precision Integers-Footnote-11017133 +Node: Checking for MPFR1017282 +Node: POSIX Floating Point Problems1018756 +Ref: POSIX Floating Point Problems-Footnote-11023409 +Node: Floating point summary1023447 +Node: Dynamic Extensions1025637 +Node: Extension Intro1027190 +Node: Plugin License1028456 +Node: Extension Mechanism Outline1029253 +Ref: figure-load-extension1029692 +Ref: figure-register-new-function1031258 +Ref: figure-call-new-function1032351 +Node: Extension API Description1034414 +Node: Extension API Functions Introduction1036127 +Ref: table-api-std-headers1037963 +Node: General Data Types1042213 +Ref: General Data Types-Footnote-11050919 +Node: Memory Allocation Functions1051218 +Ref: Memory Allocation Functions-Footnote-11055719 +Node: Constructor Functions1055818 +Node: API Ownership of MPFR and GMP Values1059471 +Node: Registration Functions1061004 +Node: Extension Functions1061704 +Node: Exit Callback Functions1067026 +Node: Extension Version String1068276 +Node: Input Parsers1068939 +Node: Output Wrappers1081660 +Node: Two-way processors1086172 +Node: Printing Messages1088437 +Ref: Printing Messages-Footnote-11089608 +Node: Updating ERRNO1089761 +Node: Requesting Values1090500 +Ref: table-value-types-returned1091237 +Node: Accessing Parameters1092346 +Node: Symbol Table Access1093583 +Node: Symbol table by name1094095 +Ref: Symbol table by name-Footnote-11097120 +Node: Symbol table by cookie1097248 +Ref: Symbol table by cookie-Footnote-11101433 +Node: Cached values1101497 +Ref: Cached values-Footnote-11105033 +Node: Array Manipulation1105186 +Ref: Array Manipulation-Footnote-11106277 +Node: Array Data Types1106314 +Ref: Array Data Types-Footnote-11108972 +Node: Array Functions1109064 +Node: Flattening Arrays1113562 +Node: Creating Arrays1120538 +Node: Redirection API1125305 +Node: Extension API Variables1128138 +Node: Extension Versioning1128849 +Ref: gawk-api-version1129278 +Node: Extension GMP/MPFR Versioning1131010 +Node: Extension API Informational Variables1132638 +Node: Extension API Boilerplate1133711 +Node: Changes from API V11137685 +Node: Finding Extensions1139257 +Node: Extension Example1139816 +Node: Internal File Description1140614 +Node: Internal File Ops1144694 +Ref: Internal File Ops-Footnote-11156044 +Node: Using Internal File Ops1156184 +Ref: Using Internal File Ops-Footnote-11158567 +Node: Extension Samples1158841 +Node: Extension Sample File Functions1160370 +Node: Extension Sample Fnmatch1168019 +Node: Extension Sample Fork1169506 +Node: Extension Sample Inplace1170724 +Node: Extension Sample Ord1174350 +Node: Extension Sample Readdir1175186 +Ref: table-readdir-file-types1176075 +Node: Extension Sample Revout1177143 +Node: Extension Sample Rev2way1177732 +Node: Extension Sample Read write array1178472 +Node: Extension Sample Readfile1181637 +Node: Extension Sample Time1182732 +Node: Extension Sample API Tests1184484 +Node: gawkextlib1184976 +Node: Extension summary1187894 +Node: Extension Exercises1191596 +Node: Language History1192838 +Node: V7/SVR3.11194494 +Node: SVR41196646 +Node: POSIX1198080 +Node: BTL1199461 +Node: POSIX/GNU1200190 +Node: Feature History1205968 +Node: Common Extensions1223143 +Node: Ranges and Locales1224426 +Ref: Ranges and Locales-Footnote-11229042 +Ref: Ranges and Locales-Footnote-21229069 +Ref: Ranges and Locales-Footnote-31229304 +Node: Contributors1229527 +Node: History summary1235524 +Node: Installation1236904 +Node: Gawk Distribution1237848 +Node: Getting1238332 +Node: Extracting1239295 +Node: Distribution contents1240933 +Node: Unix Installation1247994 +Node: Quick Installation1248798 +Node: Compiling with MPFR1251218 +Node: Shell Startup Files1251908 +Node: Additional Configuration Options1252997 +Node: Configuration Philosophy1255312 +Node: Compiling from Git1257708 +Node: Building the Documentation1258263 +Node: Non-Unix Installation1259647 +Node: PC Installation1260107 +Node: PC Binary Installation1260945 +Node: PC Compiling1261818 +Node: PC Using1262935 +Node: Cygwin1266488 +Node: MSYS1267712 +Node: VMS Installation1268314 +Node: VMS Compilation1269033 +Ref: VMS Compilation-Footnote-11270262 +Node: VMS Dynamic Extensions1270320 +Node: VMS Installation Details1272005 +Node: VMS Running1274267 +Node: VMS GNV1278546 +Node: Bugs1279260 +Node: Bug definition1280172 +Node: Bug address1283108 +Node: Usenet1286496 +Node: Performance bugs1287685 +Node: Asking for help1290606 +Node: Maintainers1292573 +Node: Other Versions1293767 +Node: Installation summary1301931 +Node: Notes1303295 +Node: Compatibility Mode1304089 +Node: Additions1304871 +Node: Accessing The Source1305796 +Node: Adding Code1307233 +Node: New Ports1313425 +Node: Derived Files1317800 +Ref: Derived Files-Footnote-11323460 +Ref: Derived Files-Footnote-21323495 +Ref: Derived Files-Footnote-31324093 +Node: Future Extensions1324207 +Node: Implementation Limitations1324865 +Node: Extension Design1326075 +Node: Old Extension Problems1327219 +Ref: Old Extension Problems-Footnote-11328737 +Node: Extension New Mechanism Goals1328794 +Ref: Extension New Mechanism Goals-Footnote-11332158 +Node: Extension Other Design Decisions1332347 +Node: Extension Future Growth1334460 +Node: Notes summary1335066 +Node: Basic Concepts1336224 +Node: Basic High Level1336905 +Ref: figure-general-flow1337187 +Ref: figure-process-flow1337873 +Ref: Basic High Level-Footnote-11341175 +Node: Basic Data Typing1341360 +Node: Glossary1344688 +Node: Copying1376575 +Node: GNU Free Documentation License1414118 +Node: Index1439238 End Tag Table |