diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 872 |
1 files changed, 442 insertions, 430 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index c9bf229a..999ee49f 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -11969,6 +11969,12 @@ available: string values, which in turn come before all subarrays. (Subarrays have not been described yet; *note Arrays of Arrays::.) + If you choose to use this feature in traversing 'FUNCTAB' (*note + Auto-set::), then the order is built-in functions first (*note + Built-in::), then user-defined functions (*note User-defined::) + next, and finally functions loaded from an extension (*note Dynamic + Extensions::). + '"@val_str_asc"' Order by element values in ascending order (rather than by indices). Scalar values are compared as strings. Subarrays, if @@ -12849,6 +12855,12 @@ Options::): a[2] = "last" a[3] = "middle" + NOTE: Due to implementation limitations, you may not use + either 'SYMTAB' or 'FUNCTAB' as arguments to these functions, + even if providing a second array to use for the actual + sorting. Attempting to do so produces a fatal error. This + restriction may be lifted in the future. + 'gensub(REGEXP, REPLACEMENT, HOW' [', TARGET']') #' Search the target string TARGET for matches of the regular expression REGEXP. If HOW is a string beginning with 'g' or 'G' @@ -33729,7 +33741,7 @@ Index * * (asterisk), *= operator <1>: Precedence. (line 94) * * (asterisk), **= operator <1>: Precedence. (line 94) * * (asterisk), * operator, null strings, matching: String Functions. - (line 542) + (line 548) * + (plus sign), regexp operator: Regexp Operator Details. (line 107) * + (plus sign), += operator: Assignment Ops. (line 81) @@ -34107,7 +34119,7 @@ Index * arrays, multidimensional, scanning: Multiscanning. (line 11) * arrays, arrays of arrays: Arrays of Arrays. (line 6) * arrays, elements, retrieving number of: String Functions. (line 42) -* arrays, number of elements: String Functions. (line 201) +* arrays, number of elements: String Functions. (line 207) * arrays, as parameters to functions: Pass By Value/Reference. (line 44) * arrays, associative, library functions and: Library Names. (line 58) @@ -34166,7 +34178,7 @@ Index * asterisk (*), *= operator <1>: Precedence. (line 94) * asterisk (*), **= operator <1>: Precedence. (line 94) * asterisk (*), * operator, null strings, matching: String Functions. - (line 542) + (line 548) * at-sign (@), @include directive: Include Files. (line 8) * at-sign (@), @load directive: Loading Shared Libraries. (line 8) @@ -34411,7 +34423,7 @@ Index * Brian Kernighan's awk <9>: Continue Statement. (line 44) * Brian Kernighan's awk <10>: Nextfile Statement. (line 47) * Brian Kernighan's awk <11>: Delete. (line 51) -* Brian Kernighan's awk <12>: String Functions. (line 498) +* Brian Kernighan's awk <12>: String Functions. (line 504) * Brian Kernighan's awk <13>: Gory Details. (line 19) * Brian Kernighan's awk <14>: I/O Functions. (line 43) * Brian Kernighan's awk, extensions: BTL. (line 6) @@ -34474,7 +34486,7 @@ Index * case sensitivity, string comparisons and: User-modified. (line 79) * case sensitivity, regexps and <1>: User-modified. (line 79) * case sensitivity, array indices and: Array Intro. (line 100) -* case sensitivity, converting case: String Functions. (line 528) +* case sensitivity, converting case: String Functions. (line 534) * case sensitivity, example programs: Library Functions. (line 53) * CGI, awk scripts for: Options. (line 147) * character sets (machine character encodings): Ordinal Functions. @@ -34552,7 +34564,7 @@ Index * common extensions, **= operator: Assignment Ops. (line 138) * common extensions, delete to delete entire arrays: Delete. (line 39) * common extensions, length() applied to an array: String Functions. - (line 201) + (line 207) * common extensions, func keyword: Definition Syntax. (line 99) * common extensions, BINMODE variable: PC Using. (line 20) * comp.lang.awk newsgroup: Usenet. (line 11) @@ -34610,9 +34622,9 @@ Index * converting, numbers to strings: Strings And Numbers. (line 6) * converting, integer array subscripts to strings: Numeric Array Subscripts. (line 31) -* converting, string to numbers <1>: String Functions. (line 396) -* converting, string to lower case: String Functions. (line 529) -* converting, string to upper case: String Functions. (line 535) +* converting, string to numbers <1>: String Functions. (line 402) +* converting, string to lower case: String Functions. (line 535) +* converting, string to upper case: String Functions. (line 541) * converting, dates to timestamps: Time Functions. (line 78) * converting, string to numbers <2>: Bitwise Functions. (line 109) * converting, numbers to strings <1>: Bitwise Functions. (line 109) @@ -34695,9 +34707,9 @@ Index * dark corner, array subscripts: Uninitialized Subscripts. (line 43) * dark corner, regexp as second argument to index(): String Functions. - (line 165) -* dark corner, length() function: String Functions. (line 187) -* dark corner, split() function: String Functions. (line 366) + (line 171) +* dark corner, length() function: String Functions. (line 193) +* dark corner, split() function: String Functions. (line 372) * dark corner <1>: Glossary. (line 266) * data, fixed-width: Constant Size. (line 6) * data-driven languages: Basic High Level. (line 74) @@ -34945,11 +34957,11 @@ Index * differences in awk and gawk, function arguments: Calling Built-in. (line 16) * differences in awk and gawk, length() function: String Functions. - (line 201) + (line 207) * differences in awk and gawk, match() function: String Functions. - (line 263) + (line 269) * differences in awk and gawk, split() function: String Functions. - (line 351) + (line 357) * differences in awk and gawk, indirect function calls: Indirect Calls. (line 6) * differences in awk and gawk, BINMODE variable <1>: PC Using. @@ -35146,7 +35158,7 @@ Index * extensions, common, **= operator: Assignment Ops. (line 138) * extensions, common, delete to delete entire arrays: Delete. (line 39) * extensions, common, length() applied to an array: String Functions. - (line 201) + (line 207) * extensions, common, fflush() function: I/O Functions. (line 43) * extensions, common, func keyword: Definition Syntax. (line 99) * extensions, loadable, allocating memory: Memory Allocation Functions. @@ -35278,7 +35290,7 @@ Index (line 80) * files, message object, converting from portable object files: I18N Example. (line 80) -* find substring in string: String Functions. (line 156) +* find substring in string: String Functions. (line 162) * finding extensions: Finding Extensions. (line 6) * finish debugger command: Debugger Execution Control. (line 39) @@ -35315,7 +35327,7 @@ Index * format time string: Time Functions. (line 50) * formats, numeric output: OFMT. (line 6) * formatting, output: Printf. (line 6) -* formatting, strings: String Functions. (line 389) +* formatting, strings: String Functions. (line 395) * forward slash (/), to enclose regular expressions: Regexp. (line 10) * forward slash (/), /= operator: Assignment Ops. (line 129) * forward slash (/), /= operator, vs. /=.../ regexp constant: Assignment Ops. @@ -35515,7 +35527,7 @@ Index * generate time values: Time Functions. (line 25) * gensub: Standard Regexp Constants. (line 43) -* gensub <1>: String Functions. (line 89) +* gensub <1>: String Functions. (line 95) * gensub() function (gawk), escape processing: Gory Details. (line 6) * getaddrinfo() function (C library): TCP/IP Networking. (line 39) * getgrent() function (C library): Group Functions. (line 6) @@ -35597,8 +35609,8 @@ Index * groups, information about: Group Functions. (line 6) * gsub: Standard Regexp Constants. (line 43) -* gsub <1>: String Functions. (line 140) -* gsub() function, arguments of: String Functions. (line 468) +* gsub <1>: String Functions. (line 146) +* gsub() function, arguments of: String Functions. (line 474) * gsub() function, escape processing: Gory Details. (line 6) * Guerrero, Juan Manuel: Acknowledgments. (line 60) * Guerrero, Juan Manuel <1>: Contributors. (line 150) @@ -35665,7 +35677,7 @@ Index * @include directive: Include Files. (line 8) * including files, @include directive: Include Files. (line 8) * increment operators: Increment Ops. (line 6) -* index: String Functions. (line 156) +* index: String Functions. (line 162) * indexing arrays: Array Intro. (line 48) * indirect function calls: Indirect Calls. (line 6) * indirect function calls, @-notation: Indirect Calls. (line 47) @@ -35691,7 +35703,7 @@ Index (line 6) * input files, counting elements in: Wc Program. (line 6) * input pipeline: Getline/Pipe. (line 10) -* input record, length of: String Functions. (line 178) +* input record, length of: String Functions. (line 184) * input redirection: Getline/File. (line 6) * input/output, from BEGIN and END: I/O And BEGIN/END. (line 6) * input/output, binary: User-modified. (line 15) @@ -35799,9 +35811,9 @@ Index * left angle bracket (<), <= operator <1>: Precedence. (line 64) * left shift, bitwise: Bitwise Functions. (line 32) * leftmost longest match: Multiple Line. (line 26) -* length: String Functions. (line 171) -* length of input record: String Functions. (line 178) -* length of string: String Functions. (line 171) +* length: String Functions. (line 177) +* length of input record: String Functions. (line 184) +* length of string: String Functions. (line 177) * Lesser General Public License (LGPL): Glossary. (line 489) * LGPL (Lesser General Public License): Glossary. (line 489) * libmawk: Other Versions. (line 129) @@ -35890,15 +35902,15 @@ Index * marked string extraction (internationalization): String Extraction. (line 6) * Marx, Groucho: Increment Ops. (line 60) -* match: String Functions. (line 211) -* match regexp in string: String Functions. (line 211) +* match: String Functions. (line 217) +* match regexp in string: String Functions. (line 217) * match() function, RSTART/RLENGTH variables: String Functions. - (line 228) -* match() function, side effects: String Functions. (line 228) + (line 234) +* match() function, side effects: String Functions. (line 234) * matching, leftmost longest: Multiple Line. (line 26) * matching, expressions: Typing and Comparison. (line 9) -* matching, null strings: String Functions. (line 542) +* matching, null strings: String Functions. (line 548) * mawk utility: Escape Sequences. (line 121) * mawk utility <1>: Getline/Pipe. (line 62) * mawk utility <2>: Concatenation. (line 36) @@ -36020,9 +36032,9 @@ Index * null strings, as array subscripts: Uninitialized Subscripts. (line 43) * null strings, deleting array elements and: Delete. (line 27) -* null strings, matching: String Functions. (line 542) +* null strings, matching: String Functions. (line 548) * null strings <3>: Basic Data Typing. (line 26) -* number of array elements: String Functions. (line 201) +* number of array elements: String Functions. (line 207) * number sign (#), #! (executable scripts): Executable Scripts. (line 6) * number sign (#), commenting: Comments. (line 6) @@ -36130,7 +36142,7 @@ Index (line 77) * parentheses (), in a profile: Profiling. (line 146) * password file: Passwd Functions. (line 16) -* patsplit: String Functions. (line 297) +* patsplit: String Functions. (line 303) * patterns, default: Very Simple. (line 35) * patterns, regexp constants as: Regexp Usage. (line 6) * patterns: Patterns and Actions. @@ -36194,8 +36206,8 @@ Index * portability, operators: Increment Ops. (line 60) * portability, operators, not in POSIX awk: Precedence. (line 97) * portability, deleting array elements: Delete. (line 56) -* portability, length() function: String Functions. (line 180) -* portability, substr() function: String Functions. (line 518) +* portability, length() function: String Functions. (line 186) +* portability, substr() function: String Functions. (line 524) * portability, functions, defining: Definition Syntax. (line 114) * portability, next statement in user-defined functions: Function Caveats. (line 26) @@ -36249,7 +36261,7 @@ Index * POSIX awk, continue statement and: Continue Statement. (line 44) * POSIX awk, next/nextfile statements and: Next Statement. (line 44) * POSIX awk, CONVFMT variable and: User-modified. (line 30) -* POSIX awk, functions and, length(): String Functions. (line 180) +* POSIX awk, functions and, length(): String Functions. (line 186) * POSIX awk, functions and, gsub()/sub(): Gory Details. (line 90) * POSIX awk, timestamps and: Time Functions. (line 6) * POSIX awk, date utility and: Time Functions. (line 255) @@ -36270,7 +36282,7 @@ Index (line 12) * POSIX mode <9>: POSIX String Comparison. (line 34) -* POSIX mode <10>: String Functions. (line 385) +* POSIX mode <10>: String Functions. (line 391) * POSIX mode <11>: Controlling Array Traversal. (line 226) * POSIX mode <12>: POSIX Floating Point Problems. @@ -36484,7 +36496,7 @@ Index * regular expressions, as patterns <1>: Regexp Patterns. (line 6) * regular expressions, case sensitivity <1>: User-modified. (line 79) * regular expressions, searching for: Egrep Program. (line 6) -* replace in string: String Functions. (line 414) +* replace in string: String Functions. (line 420) * retrying input: Retrying Input. (line 6) * return debugger command: Debugger Execution Control. (line 54) @@ -36509,7 +36521,7 @@ Index * right shift, bitwise: Bitwise Functions. (line 32) * Ritchie, Dennis: Basic Data Typing. (line 54) * RLENGTH variable: Auto-set. (line 335) -* RLENGTH variable, match() function and: String Functions. (line 228) +* RLENGTH variable, match() function and: String Functions. (line 234) * Robbins, Miriam: Acknowledgments. (line 94) * Robbins, Jean: Acknowledgments. (line 94) * Robbins, Harry: Acknowledgments. (line 94) @@ -36537,7 +36549,7 @@ Index * RS variable <1>: User-modified. (line 136) * rshift: Bitwise Functions. (line 54) * RSTART variable: Auto-set. (line 341) -* RSTART variable, match() function and: String Functions. (line 228) +* RSTART variable, match() function and: String Functions. (line 234) * RT variable: awk split records. (line 131) * RT variable <1>: gawk split records. (line 58) * RT variable <2>: Multiple Line. (line 139) @@ -36563,8 +36575,8 @@ Index * Schorr, Andrew <2>: Contributors. (line 136) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) -* search and replace in strings: String Functions. (line 89) -* search for substring: String Functions. (line 156) +* search and replace in strings: String Functions. (line 95) +* search for substring: String Functions. (line 162) * search paths, for source files: AWKPATH Variable. (line 6) * search paths, for loadable extensions: AWKLIBPATH Variable. (line 6) * search paths: Programs Exercises. (line 70) @@ -36645,9 +36657,9 @@ Index * side effects, statements: Action Overview. (line 32) * side effects, array indexing: Reference to Elements. (line 43) -* side effects, match() function: String Functions. (line 228) -* side effects, sub() function: String Functions. (line 468) -* side effects, gsub() function: String Functions. (line 468) +* side effects, match() function: String Functions. (line 234) +* side effects, sub() function: String Functions. (line 474) +* side effects, gsub() function: String Functions. (line 474) * side effects, asort() function: Array Sorting Functions. (line 24) * side effects, asorti() function: Array Sorting Functions. @@ -36677,7 +36689,7 @@ Index (line 147) * sidebar, Operator Evaluation Order: Increment Ops. (line 58) * sidebar, Changing NR and FNR: Auto-set. (line 407) -* sidebar, Matching the Null String: String Functions. (line 540) +* sidebar, Matching the Null String: String Functions. (line 546) * sidebar, Interactive Versus Noninteractive Buffering: I/O Functions. (line 74) * sidebar, Controlling Output Buffering with system(): I/O Functions. @@ -36745,13 +36757,13 @@ Index * source files, search path for: Programs Exercises. (line 70) * sparse arrays: Array Intro. (line 76) * Spencer, Henry: Glossary. (line 16) -* split: String Functions. (line 318) -* split string into array: String Functions. (line 297) +* split: String Functions. (line 324) +* split string into array: String Functions. (line 303) * split utility: Split Program. (line 6) * split() function, array elements, deleting: Delete. (line 61) * split.awk program: Split Program. (line 30) * sprintf: OFMT. (line 15) -* sprintf <1>: String Functions. (line 389) +* sprintf <1>: String Functions. (line 395) * sprintf() function, print/printf statements and: Round Function. (line 6) * sqrt: Numeric Functions. (line 78) @@ -36786,8 +36798,8 @@ Index * string, constants, vs. regexp constants: Computed Regexps. (line 40) * string, constants: Scalar Constants. (line 15) * string, operators: Concatenation. (line 9) -* string, length: String Functions. (line 171) -* string, regular expression match of: String Functions. (line 211) +* string, length: String Functions. (line 177) +* string, regular expression match of: String Functions. (line 217) * string, extraction (internationalization): String Extraction. (line 6) * string-manipulation functions: String Functions. (line 6) @@ -36802,19 +36814,19 @@ Index * strings, numeric: Variable Typing. (line 67) * strings, converting, numbers to: User-modified. (line 30) * strings, converting, numbers to <1>: User-modified. (line 107) -* strings, splitting, example: String Functions. (line 337) -* strings, converting letter case: String Functions. (line 528) +* strings, splitting, example: String Functions. (line 343) +* strings, converting letter case: String Functions. (line 534) * strings, converting <1>: Bitwise Functions. (line 109) * strings, merging arrays into: Join Function. (line 6) * strings, for localization: Programmer i18n. (line 13) * strings, extracting: String Extraction. (line 6) -* strtonum: String Functions. (line 396) +* strtonum: String Functions. (line 402) * strtonum() function (gawk), --non-decimal-data option and: Nondecimal Data. (line 35) * sub: Standard Regexp Constants. (line 43) -* sub <1>: String Functions. (line 414) -* sub() function, arguments of: String Functions. (line 468) +* sub <1>: String Functions. (line 420) +* sub() function, arguments of: String Functions. (line 474) * sub() function, escape processing: Gory Details. (line 6) * subscript separators: User-modified. (line 149) * subscripts in arrays, numbers as: Numeric Array Subscripts. @@ -36827,9 +36839,9 @@ Index * SUBSEP variable: User-modified. (line 149) * SUBSEP variable, multidimensional arrays and: Multidimensional. (line 16) -* substitute in string: String Functions. (line 89) -* substr: String Functions. (line 487) -* substring: String Functions. (line 487) +* substitute in string: String Functions. (line 95) +* substr: String Functions. (line 493) +* substring: String Functions. (line 493) * Sumner, Andrew: Other Versions. (line 64) * supplementary groups of gawk process: Auto-set. (line 292) * switch statement: Switch Statement. (line 6) @@ -36890,8 +36902,8 @@ Index * timestamps, converting dates to: Time Functions. (line 78) * timestamps, formatted: Getlocaltime Function. (line 6) -* tolower: String Functions. (line 529) -* toupper: String Functions. (line 535) +* tolower: String Functions. (line 535) +* toupper: String Functions. (line 541) * tr utility: Translate Program. (line 6) * trace debugger command: Miscellaneous Debugger Commands. (line 108) @@ -36922,9 +36934,9 @@ Index * troubleshooting, function call syntax: Function Calls. (line 30) * troubleshooting, gawk, fatal errors, function arguments: Calling Built-in. (line 16) -* troubleshooting, match() function: String Functions. (line 292) -* troubleshooting, gsub()/sub() functions: String Functions. (line 478) -* troubleshooting, substr() function: String Functions. (line 505) +* troubleshooting, match() function: String Functions. (line 298) +* troubleshooting, gsub()/sub() functions: String Functions. (line 484) +* troubleshooting, substr() function: String Functions. (line 511) * troubleshooting, fflush() function: I/O Functions. (line 63) * troubleshooting, system() function: I/O Functions. (line 128) * troubleshooting, readable data files: File Checking. (line 6) @@ -37348,371 +37360,371 @@ Node: Assigning Elements503938 Node: Array Example504429 Node: Scanning an Array506188 Node: Controlling Scanning509210 -Ref: Controlling Scanning-Footnote-1514609 -Node: Numeric Array Subscripts514925 -Node: Uninitialized Subscripts517109 -Node: Delete518728 -Ref: Delete-Footnote-1521480 -Node: Multidimensional521537 -Node: Multiscanning524632 -Node: Arrays of Arrays526223 -Node: Arrays Summary530991 -Node: Functions533084 -Node: Built-in534122 -Node: Calling Built-in535203 -Node: Numeric Functions537199 -Ref: Numeric Functions-Footnote-1541227 -Ref: Numeric Functions-Footnote-2541875 -Ref: Numeric Functions-Footnote-3541923 -Node: String Functions542195 -Ref: String Functions-Footnote-1566053 -Ref: String Functions-Footnote-2566181 -Ref: String Functions-Footnote-3566429 -Node: Gory Details566516 -Ref: table-sub-escapes568307 -Ref: table-sub-proposed569826 -Ref: table-posix-sub571189 -Ref: table-gensub-escapes572730 -Ref: Gory Details-Footnote-1573553 -Node: I/O Functions573707 -Ref: table-system-return-values580175 -Ref: I/O Functions-Footnote-1582255 -Ref: I/O Functions-Footnote-2582403 -Node: Time Functions582523 -Ref: Time Functions-Footnote-1593194 -Ref: Time Functions-Footnote-2593262 -Ref: Time Functions-Footnote-3593420 -Ref: Time Functions-Footnote-4593531 -Ref: Time Functions-Footnote-5593643 -Ref: Time Functions-Footnote-6593870 -Node: Bitwise Functions594136 -Ref: table-bitwise-ops594730 -Ref: Bitwise Functions-Footnote-1600793 -Ref: Bitwise Functions-Footnote-2600966 -Node: Type Functions601157 -Node: I18N Functions604020 -Node: User-defined605671 -Node: Definition Syntax606483 -Ref: Definition Syntax-Footnote-1612170 -Node: Function Example612241 -Ref: Function Example-Footnote-1615163 -Node: Function Calling615185 -Node: Calling A Function615773 -Node: Variable Scope616731 -Node: Pass By Value/Reference619725 -Node: Function Caveats622369 -Ref: Function Caveats-Footnote-1624416 -Node: Return Statement624536 -Node: Dynamic Typing627515 -Node: Indirect Calls628445 -Ref: Indirect Calls-Footnote-1638697 -Node: Functions Summary638825 -Node: Library Functions641530 -Ref: Library Functions-Footnote-1645137 -Ref: Library Functions-Footnote-2645280 -Node: Library Names645451 -Ref: Library Names-Footnote-1649118 -Ref: Library Names-Footnote-2649341 -Node: General Functions649427 -Node: Strtonum Function650530 -Node: Assert Function653552 -Node: Round Function656878 -Node: Cliff Random Function658418 -Node: Ordinal Functions659434 -Ref: Ordinal Functions-Footnote-1662497 -Ref: Ordinal Functions-Footnote-2662749 -Node: Join Function662959 -Ref: Join Function-Footnote-1664729 -Node: Getlocaltime Function664929 -Node: Readfile Function668671 -Node: Shell Quoting670648 -Node: Data File Management672049 -Node: Filetrans Function672681 -Node: Rewind Function676777 -Node: File Checking678686 -Ref: File Checking-Footnote-1680020 -Node: Empty Files680221 -Node: Ignoring Assigns682200 -Node: Getopt Function683750 -Ref: Getopt Function-Footnote-1695219 -Node: Passwd Functions695419 -Ref: Passwd Functions-Footnote-1704258 -Node: Group Functions704346 -Ref: Group Functions-Footnote-1712244 -Node: Walking Arrays712451 -Node: Library Functions Summary715459 -Node: Library Exercises716865 -Node: Sample Programs717330 -Node: Running Examples718100 -Node: Clones718828 -Node: Cut Program720052 -Node: Egrep Program729981 -Ref: Egrep Program-Footnote-1737493 -Node: Id Program737603 -Node: Split Program741283 -Ref: Split Program-Footnote-1744741 -Node: Tee Program744870 -Node: Uniq Program747660 -Node: Wc Program755281 -Ref: Wc Program-Footnote-1759536 -Node: Miscellaneous Programs759630 -Node: Dupword Program760843 -Node: Alarm Program762873 -Node: Translate Program767728 -Ref: Translate Program-Footnote-1772293 -Node: Labels Program772563 -Ref: Labels Program-Footnote-1775914 -Node: Word Sorting775998 -Node: History Sorting780070 -Node: Extract Program782295 -Node: Simple Sed790349 -Node: Igawk Program793423 -Ref: Igawk Program-Footnote-1807754 -Ref: Igawk Program-Footnote-2807956 -Ref: Igawk Program-Footnote-3808078 -Node: Anagram Program808193 -Node: Signature Program811255 -Node: Programs Summary812502 -Node: Programs Exercises813716 -Ref: Programs Exercises-Footnote-1817845 -Node: Advanced Features817936 -Node: Nondecimal Data819926 -Node: Array Sorting821517 -Node: Controlling Array Traversal822217 -Ref: Controlling Array Traversal-Footnote-1830585 -Node: Array Sorting Functions830703 -Ref: Array Sorting Functions-Footnote-1835794 -Node: Two-way I/O835990 -Ref: Two-way I/O-Footnote-1843711 -Ref: Two-way I/O-Footnote-2843898 -Node: TCP/IP Networking843980 -Node: Profiling847098 -Node: Advanced Features Summary856113 -Node: Internationalization857957 -Node: I18N and L10N859437 -Node: Explaining gettext860124 -Ref: Explaining gettext-Footnote-1866016 -Ref: Explaining gettext-Footnote-2866201 -Node: Programmer i18n866366 -Ref: Programmer i18n-Footnote-1871315 -Node: Translator i18n871364 -Node: String Extraction872158 -Ref: String Extraction-Footnote-1873290 -Node: Printf Ordering873376 -Ref: Printf Ordering-Footnote-1876162 -Node: I18N Portability876226 -Ref: I18N Portability-Footnote-1878682 -Node: I18N Example878745 -Ref: I18N Example-Footnote-1882020 -Ref: I18N Example-Footnote-2882093 -Node: Gawk I18N882202 -Node: I18N Summary882851 -Node: Debugger884192 -Node: Debugging885192 -Node: Debugging Concepts885633 -Node: Debugging Terms887442 -Node: Awk Debugging890017 -Ref: Awk Debugging-Footnote-1890962 -Node: Sample Debugging Session891094 -Node: Debugger Invocation891628 -Node: Finding The Bug893014 -Node: List of Debugger Commands899488 -Node: Breakpoint Control900821 -Node: Debugger Execution Control904515 -Node: Viewing And Changing Data907877 -Node: Execution Stack911418 -Node: Debugger Info913055 -Node: Miscellaneous Debugger Commands917126 -Node: Readline Support922188 -Node: Limitations923084 -Node: Debugging Summary925638 -Node: Namespaces926917 -Node: Global Namespace928028 -Node: Qualified Names929426 -Node: Default Namespace930425 -Node: Changing The Namespace931166 -Node: Naming Rules932780 -Node: Internal Name Management934628 -Node: Namespace Example935670 -Node: Namespace And Features938232 -Node: Namespace Summary939667 -Node: Arbitrary Precision Arithmetic941144 -Node: Computer Arithmetic942631 -Ref: table-numeric-ranges946397 -Ref: table-floating-point-ranges946890 -Ref: Computer Arithmetic-Footnote-1947548 -Node: Math Definitions947605 -Ref: table-ieee-formats950921 -Ref: Math Definitions-Footnote-1951524 -Node: MPFR features951629 -Node: FP Math Caution953347 -Ref: FP Math Caution-Footnote-1954419 -Node: Inexactness of computations954788 -Node: Inexact representation955748 -Node: Comparing FP Values957108 -Node: Errors accumulate958349 -Node: Getting Accuracy959782 -Node: Try To Round962492 -Node: Setting precision963391 -Ref: table-predefined-precision-strings964088 -Node: Setting the rounding mode965918 -Ref: table-gawk-rounding-modes966292 -Ref: Setting the rounding mode-Footnote-1970223 -Node: Arbitrary Precision Integers970402 -Ref: Arbitrary Precision Integers-Footnote-1973577 -Node: Checking for MPFR973726 -Node: POSIX Floating Point Problems975200 -Ref: POSIX Floating Point Problems-Footnote-1979485 -Node: Floating point summary979523 -Node: Dynamic Extensions981713 -Node: Extension Intro983266 -Node: Plugin License984532 -Node: Extension Mechanism Outline985329 -Ref: figure-load-extension985768 -Ref: figure-register-new-function987333 -Ref: figure-call-new-function988425 -Node: Extension API Description990487 -Node: Extension API Functions Introduction992129 -Ref: table-api-std-headers993965 -Node: General Data Types997830 -Ref: General Data Types-Footnote-11006191 -Node: Memory Allocation Functions1006490 -Ref: Memory Allocation Functions-Footnote-11010700 -Node: Constructor Functions1010799 -Node: Registration Functions1014385 -Node: Extension Functions1015070 -Node: Exit Callback Functions1020392 -Node: Extension Version String1021642 -Node: Input Parsers1022305 -Node: Output Wrappers1035026 -Node: Two-way processors1039538 -Node: Printing Messages1041803 -Ref: Printing Messages-Footnote-11042974 -Node: Updating ERRNO1043127 -Node: Requesting Values1043866 -Ref: table-value-types-returned1044603 -Node: Accessing Parameters1045539 -Node: Symbol Table Access1046774 -Node: Symbol table by name1047286 -Ref: Symbol table by name-Footnote-11050310 -Node: Symbol table by cookie1050438 -Ref: Symbol table by cookie-Footnote-11054623 -Node: Cached values1054687 -Ref: Cached values-Footnote-11058223 -Node: Array Manipulation1058376 -Ref: Array Manipulation-Footnote-11059467 -Node: Array Data Types1059504 -Ref: Array Data Types-Footnote-11062162 -Node: Array Functions1062254 -Node: Flattening Arrays1066752 -Node: Creating Arrays1073728 -Node: Redirection API1078495 -Node: Extension API Variables1081328 -Node: Extension Versioning1082039 -Ref: gawk-api-version1082468 -Node: Extension GMP/MPFR Versioning1084199 -Node: Extension API Informational Variables1085827 -Node: Extension API Boilerplate1086900 -Node: Changes from API V11090874 -Node: Finding Extensions1092446 -Node: Extension Example1093005 -Node: Internal File Description1093803 -Node: Internal File Ops1097883 -Ref: Internal File Ops-Footnote-11109233 -Node: Using Internal File Ops1109373 -Ref: Using Internal File Ops-Footnote-11111756 -Node: Extension Samples1112030 -Node: Extension Sample File Functions1113559 -Node: Extension Sample Fnmatch1121208 -Node: Extension Sample Fork1122695 -Node: Extension Sample Inplace1123913 -Node: Extension Sample Ord1127538 -Node: Extension Sample Readdir1128374 -Ref: table-readdir-file-types1129263 -Node: Extension Sample Revout1130330 -Node: Extension Sample Rev2way1130919 -Node: Extension Sample Read write array1131659 -Node: Extension Sample Readfile1133601 -Node: Extension Sample Time1134696 -Node: Extension Sample API Tests1136448 -Node: gawkextlib1136940 -Node: Extension summary1139858 -Node: Extension Exercises1143560 -Node: Language History1144802 -Node: V7/SVR3.11146458 -Node: SVR41148610 -Node: POSIX1150044 -Node: BTL1151424 -Node: POSIX/GNU1152153 -Node: Feature History1157931 -Node: Common Extensions1174124 -Node: Ranges and Locales1175407 -Ref: Ranges and Locales-Footnote-11180023 -Ref: Ranges and Locales-Footnote-21180050 -Ref: Ranges and Locales-Footnote-31180285 -Node: Contributors1180506 -Node: History summary1186459 -Node: Installation1187839 -Node: Gawk Distribution1188783 -Node: Getting1189267 -Node: Extracting1190230 -Node: Distribution contents1191868 -Node: Unix Installation1198348 -Node: Quick Installation1199030 -Node: Shell Startup Files1201444 -Node: Additional Configuration Options1202533 -Node: Configuration Philosophy1204848 -Node: Non-Unix Installation1207217 -Node: PC Installation1207677 -Node: PC Binary Installation1208515 -Node: PC Compiling1208950 -Node: PC Using1210067 -Node: Cygwin1213620 -Node: MSYS1214844 -Node: VMS Installation1215345 -Node: VMS Compilation1216136 -Ref: VMS Compilation-Footnote-11217365 -Node: VMS Dynamic Extensions1217423 -Node: VMS Installation Details1219108 -Node: VMS Running1221361 -Node: VMS GNV1225640 -Node: VMS Old Gawk1226375 -Node: Bugs1226846 -Node: Bug address1227509 -Node: Usenet1230491 -Node: Maintainers1231495 -Node: Other Versions1232756 -Node: Installation summary1239844 -Node: Notes1241046 -Node: Compatibility Mode1241840 -Node: Additions1242622 -Node: Accessing The Source1243547 -Node: Adding Code1244984 -Node: New Ports1251203 -Node: Derived Files1255578 -Ref: Derived Files-Footnote-11261238 -Ref: Derived Files-Footnote-21261273 -Ref: Derived Files-Footnote-31261871 -Node: Future Extensions1261985 -Node: Implementation Limitations1262643 -Node: Extension Design1263826 -Node: Old Extension Problems1264970 -Ref: Old Extension Problems-Footnote-11266488 -Node: Extension New Mechanism Goals1266545 -Ref: Extension New Mechanism Goals-Footnote-11269909 -Node: Extension Other Design Decisions1270098 -Node: Extension Future Growth1272211 -Node: Notes summary1273047 -Node: Basic Concepts1274205 -Node: Basic High Level1274886 -Ref: figure-general-flow1275168 -Ref: figure-process-flow1275853 -Ref: Basic High Level-Footnote-11279154 -Node: Basic Data Typing1279339 -Node: Glossary1282667 -Node: Copying1314505 -Node: GNU Free Documentation License1352048 -Node: Index1377168 +Ref: Controlling Scanning-Footnote-1514910 +Node: Numeric Array Subscripts515226 +Node: Uninitialized Subscripts517410 +Node: Delete519029 +Ref: Delete-Footnote-1521781 +Node: Multidimensional521838 +Node: Multiscanning524933 +Node: Arrays of Arrays526524 +Node: Arrays Summary531292 +Node: Functions533385 +Node: Built-in534423 +Node: Calling Built-in535504 +Node: Numeric Functions537500 +Ref: Numeric Functions-Footnote-1541528 +Ref: Numeric Functions-Footnote-2542176 +Ref: Numeric Functions-Footnote-3542224 +Node: String Functions542496 +Ref: String Functions-Footnote-1566680 +Ref: String Functions-Footnote-2566808 +Ref: String Functions-Footnote-3567056 +Node: Gory Details567143 +Ref: table-sub-escapes568934 +Ref: table-sub-proposed570453 +Ref: table-posix-sub571816 +Ref: table-gensub-escapes573357 +Ref: Gory Details-Footnote-1574180 +Node: I/O Functions574334 +Ref: table-system-return-values580802 +Ref: I/O Functions-Footnote-1582882 +Ref: I/O Functions-Footnote-2583030 +Node: Time Functions583150 +Ref: Time Functions-Footnote-1593821 +Ref: Time Functions-Footnote-2593889 +Ref: Time Functions-Footnote-3594047 +Ref: Time Functions-Footnote-4594158 +Ref: Time Functions-Footnote-5594270 +Ref: Time Functions-Footnote-6594497 +Node: Bitwise Functions594763 +Ref: table-bitwise-ops595357 +Ref: Bitwise Functions-Footnote-1601420 +Ref: Bitwise Functions-Footnote-2601593 +Node: Type Functions601784 +Node: I18N Functions604647 +Node: User-defined606298 +Node: Definition Syntax607110 +Ref: Definition Syntax-Footnote-1612797 +Node: Function Example612868 +Ref: Function Example-Footnote-1615790 +Node: Function Calling615812 +Node: Calling A Function616400 +Node: Variable Scope617358 +Node: Pass By Value/Reference620352 +Node: Function Caveats622996 +Ref: Function Caveats-Footnote-1625043 +Node: Return Statement625163 +Node: Dynamic Typing628142 +Node: Indirect Calls629072 +Ref: Indirect Calls-Footnote-1639324 +Node: Functions Summary639452 +Node: Library Functions642157 +Ref: Library Functions-Footnote-1645764 +Ref: Library Functions-Footnote-2645907 +Node: Library Names646078 +Ref: Library Names-Footnote-1649745 +Ref: Library Names-Footnote-2649968 +Node: General Functions650054 +Node: Strtonum Function651157 +Node: Assert Function654179 +Node: Round Function657505 +Node: Cliff Random Function659045 +Node: Ordinal Functions660061 +Ref: Ordinal Functions-Footnote-1663124 +Ref: Ordinal Functions-Footnote-2663376 +Node: Join Function663586 +Ref: Join Function-Footnote-1665356 +Node: Getlocaltime Function665556 +Node: Readfile Function669298 +Node: Shell Quoting671275 +Node: Data File Management672676 +Node: Filetrans Function673308 +Node: Rewind Function677404 +Node: File Checking679313 +Ref: File Checking-Footnote-1680647 +Node: Empty Files680848 +Node: Ignoring Assigns682827 +Node: Getopt Function684377 +Ref: Getopt Function-Footnote-1695846 +Node: Passwd Functions696046 +Ref: Passwd Functions-Footnote-1704885 +Node: Group Functions704973 +Ref: Group Functions-Footnote-1712871 +Node: Walking Arrays713078 +Node: Library Functions Summary716086 +Node: Library Exercises717492 +Node: Sample Programs717957 +Node: Running Examples718727 +Node: Clones719455 +Node: Cut Program720679 +Node: Egrep Program730608 +Ref: Egrep Program-Footnote-1738120 +Node: Id Program738230 +Node: Split Program741910 +Ref: Split Program-Footnote-1745368 +Node: Tee Program745497 +Node: Uniq Program748287 +Node: Wc Program755908 +Ref: Wc Program-Footnote-1760163 +Node: Miscellaneous Programs760257 +Node: Dupword Program761470 +Node: Alarm Program763500 +Node: Translate Program768355 +Ref: Translate Program-Footnote-1772920 +Node: Labels Program773190 +Ref: Labels Program-Footnote-1776541 +Node: Word Sorting776625 +Node: History Sorting780697 +Node: Extract Program782922 +Node: Simple Sed790976 +Node: Igawk Program794050 +Ref: Igawk Program-Footnote-1808381 +Ref: Igawk Program-Footnote-2808583 +Ref: Igawk Program-Footnote-3808705 +Node: Anagram Program808820 +Node: Signature Program811882 +Node: Programs Summary813129 +Node: Programs Exercises814343 +Ref: Programs Exercises-Footnote-1818472 +Node: Advanced Features818563 +Node: Nondecimal Data820553 +Node: Array Sorting822144 +Node: Controlling Array Traversal822844 +Ref: Controlling Array Traversal-Footnote-1831212 +Node: Array Sorting Functions831330 +Ref: Array Sorting Functions-Footnote-1836421 +Node: Two-way I/O836617 +Ref: Two-way I/O-Footnote-1844338 +Ref: Two-way I/O-Footnote-2844525 +Node: TCP/IP Networking844607 +Node: Profiling847725 +Node: Advanced Features Summary856740 +Node: Internationalization858584 +Node: I18N and L10N860064 +Node: Explaining gettext860751 +Ref: Explaining gettext-Footnote-1866643 +Ref: Explaining gettext-Footnote-2866828 +Node: Programmer i18n866993 +Ref: Programmer i18n-Footnote-1871942 +Node: Translator i18n871991 +Node: String Extraction872785 +Ref: String Extraction-Footnote-1873917 +Node: Printf Ordering874003 +Ref: Printf Ordering-Footnote-1876789 +Node: I18N Portability876853 +Ref: I18N Portability-Footnote-1879309 +Node: I18N Example879372 +Ref: I18N Example-Footnote-1882647 +Ref: I18N Example-Footnote-2882720 +Node: Gawk I18N882829 +Node: I18N Summary883478 +Node: Debugger884819 +Node: Debugging885819 +Node: Debugging Concepts886260 +Node: Debugging Terms888069 +Node: Awk Debugging890644 +Ref: Awk Debugging-Footnote-1891589 +Node: Sample Debugging Session891721 +Node: Debugger Invocation892255 +Node: Finding The Bug893641 +Node: List of Debugger Commands900115 +Node: Breakpoint Control901448 +Node: Debugger Execution Control905142 +Node: Viewing And Changing Data908504 +Node: Execution Stack912045 +Node: Debugger Info913682 +Node: Miscellaneous Debugger Commands917753 +Node: Readline Support922815 +Node: Limitations923711 +Node: Debugging Summary926265 +Node: Namespaces927544 +Node: Global Namespace928655 +Node: Qualified Names930053 +Node: Default Namespace931052 +Node: Changing The Namespace931793 +Node: Naming Rules933407 +Node: Internal Name Management935255 +Node: Namespace Example936297 +Node: Namespace And Features938859 +Node: Namespace Summary940294 +Node: Arbitrary Precision Arithmetic941771 +Node: Computer Arithmetic943258 +Ref: table-numeric-ranges947024 +Ref: table-floating-point-ranges947517 +Ref: Computer Arithmetic-Footnote-1948175 +Node: Math Definitions948232 +Ref: table-ieee-formats951548 +Ref: Math Definitions-Footnote-1952151 +Node: MPFR features952256 +Node: FP Math Caution953974 +Ref: FP Math Caution-Footnote-1955046 +Node: Inexactness of computations955415 +Node: Inexact representation956375 +Node: Comparing FP Values957735 +Node: Errors accumulate958976 +Node: Getting Accuracy960409 +Node: Try To Round963119 +Node: Setting precision964018 +Ref: table-predefined-precision-strings964715 +Node: Setting the rounding mode966545 +Ref: table-gawk-rounding-modes966919 +Ref: Setting the rounding mode-Footnote-1970850 +Node: Arbitrary Precision Integers971029 +Ref: Arbitrary Precision Integers-Footnote-1974204 +Node: Checking for MPFR974353 +Node: POSIX Floating Point Problems975827 +Ref: POSIX Floating Point Problems-Footnote-1980112 +Node: Floating point summary980150 +Node: Dynamic Extensions982340 +Node: Extension Intro983893 +Node: Plugin License985159 +Node: Extension Mechanism Outline985956 +Ref: figure-load-extension986395 +Ref: figure-register-new-function987960 +Ref: figure-call-new-function989052 +Node: Extension API Description991114 +Node: Extension API Functions Introduction992756 +Ref: table-api-std-headers994592 +Node: General Data Types998457 +Ref: General Data Types-Footnote-11006818 +Node: Memory Allocation Functions1007117 +Ref: Memory Allocation Functions-Footnote-11011327 +Node: Constructor Functions1011426 +Node: Registration Functions1015012 +Node: Extension Functions1015697 +Node: Exit Callback Functions1021019 +Node: Extension Version String1022269 +Node: Input Parsers1022932 +Node: Output Wrappers1035653 +Node: Two-way processors1040165 +Node: Printing Messages1042430 +Ref: Printing Messages-Footnote-11043601 +Node: Updating ERRNO1043754 +Node: Requesting Values1044493 +Ref: table-value-types-returned1045230 +Node: Accessing Parameters1046166 +Node: Symbol Table Access1047401 +Node: Symbol table by name1047913 +Ref: Symbol table by name-Footnote-11050937 +Node: Symbol table by cookie1051065 +Ref: Symbol table by cookie-Footnote-11055250 +Node: Cached values1055314 +Ref: Cached values-Footnote-11058850 +Node: Array Manipulation1059003 +Ref: Array Manipulation-Footnote-11060094 +Node: Array Data Types1060131 +Ref: Array Data Types-Footnote-11062789 +Node: Array Functions1062881 +Node: Flattening Arrays1067379 +Node: Creating Arrays1074355 +Node: Redirection API1079122 +Node: Extension API Variables1081955 +Node: Extension Versioning1082666 +Ref: gawk-api-version1083095 +Node: Extension GMP/MPFR Versioning1084826 +Node: Extension API Informational Variables1086454 +Node: Extension API Boilerplate1087527 +Node: Changes from API V11091501 +Node: Finding Extensions1093073 +Node: Extension Example1093632 +Node: Internal File Description1094430 +Node: Internal File Ops1098510 +Ref: Internal File Ops-Footnote-11109860 +Node: Using Internal File Ops1110000 +Ref: Using Internal File Ops-Footnote-11112383 +Node: Extension Samples1112657 +Node: Extension Sample File Functions1114186 +Node: Extension Sample Fnmatch1121835 +Node: Extension Sample Fork1123322 +Node: Extension Sample Inplace1124540 +Node: Extension Sample Ord1128165 +Node: Extension Sample Readdir1129001 +Ref: table-readdir-file-types1129890 +Node: Extension Sample Revout1130957 +Node: Extension Sample Rev2way1131546 +Node: Extension Sample Read write array1132286 +Node: Extension Sample Readfile1134228 +Node: Extension Sample Time1135323 +Node: Extension Sample API Tests1137075 +Node: gawkextlib1137567 +Node: Extension summary1140485 +Node: Extension Exercises1144187 +Node: Language History1145429 +Node: V7/SVR3.11147085 +Node: SVR41149237 +Node: POSIX1150671 +Node: BTL1152051 +Node: POSIX/GNU1152780 +Node: Feature History1158558 +Node: Common Extensions1174751 +Node: Ranges and Locales1176034 +Ref: Ranges and Locales-Footnote-11180650 +Ref: Ranges and Locales-Footnote-21180677 +Ref: Ranges and Locales-Footnote-31180912 +Node: Contributors1181133 +Node: History summary1187086 +Node: Installation1188466 +Node: Gawk Distribution1189410 +Node: Getting1189894 +Node: Extracting1190857 +Node: Distribution contents1192495 +Node: Unix Installation1198975 +Node: Quick Installation1199657 +Node: Shell Startup Files1202071 +Node: Additional Configuration Options1203160 +Node: Configuration Philosophy1205475 +Node: Non-Unix Installation1207844 +Node: PC Installation1208304 +Node: PC Binary Installation1209142 +Node: PC Compiling1209577 +Node: PC Using1210694 +Node: Cygwin1214247 +Node: MSYS1215471 +Node: VMS Installation1215972 +Node: VMS Compilation1216763 +Ref: VMS Compilation-Footnote-11217992 +Node: VMS Dynamic Extensions1218050 +Node: VMS Installation Details1219735 +Node: VMS Running1221988 +Node: VMS GNV1226267 +Node: VMS Old Gawk1227002 +Node: Bugs1227473 +Node: Bug address1228136 +Node: Usenet1231118 +Node: Maintainers1232122 +Node: Other Versions1233383 +Node: Installation summary1240471 +Node: Notes1241673 +Node: Compatibility Mode1242467 +Node: Additions1243249 +Node: Accessing The Source1244174 +Node: Adding Code1245611 +Node: New Ports1251830 +Node: Derived Files1256205 +Ref: Derived Files-Footnote-11261865 +Ref: Derived Files-Footnote-21261900 +Ref: Derived Files-Footnote-31262498 +Node: Future Extensions1262612 +Node: Implementation Limitations1263270 +Node: Extension Design1264453 +Node: Old Extension Problems1265597 +Ref: Old Extension Problems-Footnote-11267115 +Node: Extension New Mechanism Goals1267172 +Ref: Extension New Mechanism Goals-Footnote-11270536 +Node: Extension Other Design Decisions1270725 +Node: Extension Future Growth1272838 +Node: Notes summary1273674 +Node: Basic Concepts1274832 +Node: Basic High Level1275513 +Ref: figure-general-flow1275795 +Ref: figure-process-flow1276480 +Ref: Basic High Level-Footnote-11279781 +Node: Basic Data Typing1279966 +Node: Glossary1283294 +Node: Copying1315132 +Node: GNU Free Documentation License1352675 +Node: Index1377795 End Tag Table |