diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 804 |
1 files changed, 406 insertions, 398 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 2e30ad95..1ed56125 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10078,10 +10078,18 @@ Options::), they are not special. An associative array containing the values of the environment. The array indices are the environment variable names; the elements are the values of the particular environment variables. For - example, `ENVIRON["HOME"]' might be `"/home/arnold"'. Changing - this array does not affect the environment passed on to any - programs that `awk' may spawn via redirection or the `system()' - function. (In a future version of `gawk', it may do so.) + example, `ENVIRON["HOME"]' might be `/home/arnold'. + + For POSIX `awk', changing this array does not affect the + environment passed on to any programs that `awk' may spawn via + redirection or the `system()' function. + + However, beginning with version 4.2, if not in POSIX compatibility + mode, `gawk' does update its own environment when `ENVIRON' is + changed, thus changing the environment seen by programs that it + creates. You should therefore be especially careful if you modify + `ENVIRON["PATH"]"', which is the search path for finding + executable programs. Some operating systems may not have environment variables. On such systems, the `ENVIRON' array is empty (except for @@ -31609,9 +31617,9 @@ Index * dark corner, exit statement: Exit Statement. (line 30) * dark corner, field separators: Field Splitting Summary. (line 46) -* dark corner, FILENAME variable <1>: Auto-set. (line 90) +* dark corner, FILENAME variable <1>: Auto-set. (line 98) * dark corner, FILENAME variable: Getline Notes. (line 19) -* dark corner, FNR/NR variables: Auto-set. (line 301) +* dark corner, FNR/NR variables: Auto-set. (line 309) * dark corner, format-control characters: Control Letters. (line 18) * dark corner, FS as null string: Single Character Fields. (line 20) @@ -31795,12 +31803,12 @@ Index (line 81) * differences in awk and gawk, command line directories: Command line directories. (line 6) -* differences in awk and gawk, ERRNO variable: Auto-set. (line 74) +* differences in awk and gawk, ERRNO variable: Auto-set. (line 82) * differences in awk and gawk, error messages: Special FD. (line 16) * differences in awk and gawk, FIELDWIDTHS variable: User-modified. (line 37) * differences in awk and gawk, FPAT variable: User-modified. (line 43) -* differences in awk and gawk, FUNCTAB variable: Auto-set. (line 115) +* differences in awk and gawk, FUNCTAB variable: Auto-set. (line 123) * differences in awk and gawk, function arguments (gawk): Calling Built-in. (line 16) * differences in awk and gawk, getline command: Getline. (line 19) @@ -31823,7 +31831,7 @@ Index (line 260) * differences in awk and gawk, print/printf statements: Format Modifiers. (line 13) -* differences in awk and gawk, PROCINFO array: Auto-set. (line 128) +* differences in awk and gawk, PROCINFO array: Auto-set. (line 136) * differences in awk and gawk, read timeouts: Read Timeout. (line 6) * differences in awk and gawk, record separators: awk split records. (line 124) @@ -31833,7 +31841,7 @@ Index (line 26) * differences in awk and gawk, RS/RT variables: gawk split records. (line 58) -* differences in awk and gawk, RT variable: Auto-set. (line 257) +* differences in awk and gawk, RT variable: Auto-set. (line 265) * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. @@ -31841,7 +31849,7 @@ Index * differences in awk and gawk, strings: Scalar Constants. (line 20) * differences in awk and gawk, strings, storing: gawk split records. (line 77) -* differences in awk and gawk, SYMTAB variable: Auto-set. (line 261) +* differences in awk and gawk, SYMTAB variable: Auto-set. (line 269) * differences in awk and gawk, TEXTDOMAIN variable: User-modified. (line 152) * differences in awk and gawk, trunc-mod operation: Arithmetic Ops. @@ -31882,8 +31890,8 @@ Index * dynamically loaded extensions: Dynamic Extensions. (line 6) * e debugger command (alias for enable): Breakpoint Control. (line 73) * EBCDIC: Ordinal Functions. (line 45) -* effective group ID of gawk user: Auto-set. (line 133) -* effective user ID of gawk user: Auto-set. (line 137) +* effective group ID of gawk user: Auto-set. (line 141) +* effective user ID of gawk user: Auto-set. (line 145) * egrep utility <1>: Egrep Program. (line 6) * egrep utility: Bracket Expressions. (line 24) * egrep.awk program: Egrep Program. (line 54) @@ -31939,13 +31947,13 @@ Index (line 11) * EREs (Extended Regular Expressions): Bracket Expressions. (line 24) * ERRNO variable <1>: TCP/IP Networking. (line 54) -* ERRNO variable: Auto-set. (line 74) +* ERRNO variable: Auto-set. (line 82) * ERRNO variable, with BEGINFILE pattern: BEGINFILE/ENDFILE. (line 26) * ERRNO variable, with close() function: Close Files And Pipes. (line 139) * ERRNO variable, with getline command: Getline. (line 19) * error handling: Special FD. (line 16) -* error handling, ERRNO variable and: Auto-set. (line 74) +* error handling, ERRNO variable and: Auto-set. (line 82) * error output: Special FD. (line 6) * escape processing, gsub()/gensub()/sub() functions: Gory Details. (line 6) @@ -31999,7 +32007,7 @@ Index (line 6) * extension API version: Extension Versioning. (line 6) -* extension API, version number: Auto-set. (line 224) +* extension API, version number: Auto-set. (line 232) * extension example: Extension Example. (line 6) * extension registration: Registration Functions. (line 6) @@ -32078,7 +32086,7 @@ Index * file names, distinguishing: Auto-set. (line 56) * file names, in compatibility mode: Special Caveats. (line 9) * file names, standard streams in gawk: Special FD. (line 46) -* FILENAME variable <1>: Auto-set. (line 90) +* FILENAME variable <1>: Auto-set. (line 98) * FILENAME variable: Reading Files. (line 6) * FILENAME variable, getline, setting with: Getline Notes. (line 19) * filenames, assignments as: Ignoring Assigns. (line 6) @@ -32148,9 +32156,9 @@ Index * flush buffered output: I/O Functions. (line 28) * fnmatch() extension function: Extension Sample Fnmatch. (line 12) -* FNR variable <1>: Auto-set. (line 99) +* FNR variable <1>: Auto-set. (line 107) * FNR variable: Records. (line 6) -* FNR variable, changing: Auto-set. (line 301) +* FNR variable, changing: Auto-set. (line 309) * for statement: For Statement. (line 6) * for statement, looping over arrays: Scanning an Array. (line 20) * fork() extension function: Extension Sample Fork. @@ -32200,7 +32208,7 @@ Index * FSF (Free Software Foundation): Manual History. (line 6) * fts() extension function: Extension Sample File Functions. (line 61) -* FUNCTAB array: Auto-set. (line 115) +* FUNCTAB array: Auto-set. (line 123) * function calls: Function Calls. (line 6) * function calls, indirect: Indirect Calls. (line 6) * function definition example: Function Example. (line 6) @@ -32250,7 +32258,7 @@ Index * G-d: Acknowledgments. (line 78) * Garfinkle, Scott: Contributors. (line 34) * gawk program, dynamic profiling: Profiling. (line 179) -* gawk version: Auto-set. (line 199) +* gawk version: Auto-set. (line 207) * gawk, ARGIND variable in: Other Arguments. (line 12) * gawk, awk and <1>: This Manual. (line 14) * gawk, awk and: Preface. (line 23) @@ -32271,7 +32279,7 @@ Index * gawk, distribution: Distribution contents. (line 6) * gawk, ERRNO variable in <1>: TCP/IP Networking. (line 54) -* gawk, ERRNO variable in <2>: Auto-set. (line 74) +* gawk, ERRNO variable in <2>: Auto-set. (line 82) * gawk, ERRNO variable in <3>: BEGINFILE/ENDFILE. (line 26) * gawk, ERRNO variable in <4>: Close Files And Pipes. (line 139) @@ -32288,7 +32296,7 @@ Index * gawk, FPAT variable in <1>: User-modified. (line 43) * gawk, FPAT variable in: Splitting By Content. (line 27) -* gawk, FUNCTAB array in: Auto-set. (line 115) +* gawk, FUNCTAB array in: Auto-set. (line 123) * gawk, function arguments and: Calling Built-in. (line 16) * gawk, hexadecimal numbers and: Nondecimal-numbers. (line 42) * gawk, IGNORECASE variable in <1>: Array Sorting Functions. @@ -32319,7 +32327,7 @@ Index * gawk, OS/2 version of: PC Using. (line 16) * gawk, PROCINFO array in <1>: Two-way I/O. (line 117) * gawk, PROCINFO array in <2>: Time Functions. (line 47) -* gawk, PROCINFO array in: Auto-set. (line 128) +* gawk, PROCINFO array in: Auto-set. (line 136) * gawk, regexp constants and: Using Constant Regexps. (line 28) * gawk, regular expressions, case sensitivity: Case-sensitivity. @@ -32327,14 +32335,14 @@ Index * gawk, regular expressions, operators: GNU Regexp Operators. (line 6) * gawk, regular expressions, precedence: Regexp Operators. (line 162) -* gawk, RT variable in <1>: Auto-set. (line 257) +* gawk, RT variable in <1>: Auto-set. (line 265) * gawk, RT variable in <2>: Multiple Line. (line 129) * gawk, RT variable in: awk split records. (line 124) * gawk, See Also awk: Preface. (line 36) * gawk, source code, obtaining: Getting. (line 6) * gawk, splitting fields and: Constant Size. (line 88) * gawk, string-translation functions: I18N Functions. (line 6) -* gawk, SYMTAB array in: Auto-set. (line 261) +* gawk, SYMTAB array in: Auto-set. (line 269) * gawk, TEXTDOMAIN variable in: User-modified. (line 152) * gawk, timestamps: Time Functions. (line 6) * gawk, uses for: Preface. (line 36) @@ -32421,7 +32429,7 @@ Index * Grigera, Juan: Contributors. (line 57) * group database, reading: Group Functions. (line 6) * group file: Group Functions. (line 6) -* group ID of gawk user: Auto-set. (line 172) +* group ID of gawk user: Auto-set. (line 180) * groups, information about: Group Functions. (line 6) * gsub <1>: String Functions. (line 139) * gsub: Using Constant Regexps. @@ -32718,7 +32726,7 @@ Index * mawk utility <3>: Concatenation. (line 36) * mawk utility <4>: Getline/Pipe. (line 62) * mawk utility: Escape Sequences. (line 124) -* maximum precision supported by MPFR library: Auto-set. (line 213) +* maximum precision supported by MPFR library: Auto-set. (line 221) * McIlroy, Doug: Glossary. (line 149) * McPhee, Patrick: Contributors. (line 100) * message object files: Explaining gettext. (line 42) @@ -32731,7 +32739,7 @@ Index * messages from extensions: Printing Messages. (line 6) * metacharacters in regular expressions: Regexp Operators. (line 6) * metacharacters, escape sequences for: Escape Sequences. (line 130) -* minimum precision supported by MPFR library: Auto-set. (line 216) +* minimum precision supported by MPFR library: Auto-set. (line 224) * mktime: Time Functions. (line 25) * modifiers, in format specifiers: Format Modifiers. (line 6) * monetary information, localization: Explaining gettext. (line 104) @@ -32785,7 +32793,7 @@ Index (line 47) * nexti debugger command: Debugger Execution Control. (line 49) -* NF variable <1>: Auto-set. (line 104) +* NF variable <1>: Auto-set. (line 112) * NF variable: Fields. (line 33) * NF variable, decrementing: Changing Fields. (line 107) * ni debugger command (alias for nexti): Debugger Execution Control. @@ -32794,9 +32802,9 @@ Index * non-existent array elements: Reference to Elements. (line 23) * not Boolean-logic operator: Boolean Ops. (line 6) -* NR variable <1>: Auto-set. (line 123) +* NR variable <1>: Auto-set. (line 131) * NR variable: Records. (line 6) -* NR variable, changing: Auto-set. (line 301) +* NR variable, changing: Auto-set. (line 309) * null strings <1>: Basic Data Typing. (line 26) * null strings <2>: Truth Values. (line 6) * null strings <3>: Regexp Field Splitting. @@ -32911,7 +32919,7 @@ Index * p debugger command (alias for print): Viewing And Changing Data. (line 36) * Papadopoulos, Panos: Contributors. (line 129) -* parent process ID of gawk process: Auto-set. (line 181) +* parent process ID of gawk process: Auto-set. (line 189) * parentheses (), in a profile: Profiling. (line 146) * parentheses (), regexp operator: Regexp Operators. (line 80) * password file: Passwd Functions. (line 16) @@ -33076,24 +33084,24 @@ Index * printing, unduplicated lines of text: Uniq Program. (line 6) * printing, user information: Id Program. (line 6) * private variables: Library Names. (line 11) -* process group idIDof gawk process: Auto-set. (line 175) -* process ID of gawk process: Auto-set. (line 178) +* process group idIDof gawk process: Auto-set. (line 183) +* process ID of gawk process: Auto-set. (line 186) * processes, two-way communications with: Two-way I/O. (line 23) * processing data: Basic High Level. (line 6) * PROCINFO array <1>: Passwd Functions. (line 6) * PROCINFO array <2>: Time Functions. (line 47) -* PROCINFO array: Auto-set. (line 128) +* PROCINFO array: Auto-set. (line 136) * PROCINFO array, and communications via ptys: Two-way I/O. (line 117) * PROCINFO array, and group membership: Group Functions. (line 6) * PROCINFO array, and user and group ID numbers: Id Program. (line 15) * PROCINFO array, testing the field splitting: Passwd Functions. (line 161) -* PROCINFO array, uses: Auto-set. (line 234) +* PROCINFO array, uses: Auto-set. (line 242) * PROCINFO, values of sorted_in: Controlling Scanning. (line 26) * profiling awk programs: Profiling. (line 6) * profiling awk programs, dynamically: Profiling. (line 179) -* program identifiers: Auto-set. (line 146) +* program identifiers: Auto-set. (line 154) * program, definition of: Getting Started. (line 21) * programmers, attractiveness of: Two-way I/O. (line 6) * programming conventions, --non-decimal-data option: Nondecimal Data. @@ -33253,7 +33261,7 @@ Index * right shift: Bitwise Functions. (line 52) * right shift, bitwise: Bitwise Functions. (line 32) * Ritchie, Dennis: Basic Data Typing. (line 54) -* RLENGTH variable: Auto-set. (line 244) +* RLENGTH variable: Auto-set. (line 252) * RLENGTH variable, match() function and: String Functions. (line 224) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) @@ -33282,9 +33290,9 @@ Index * RS variable: awk split records. (line 12) * RS variable, multiline records and: Multiple Line. (line 17) * rshift: Bitwise Functions. (line 52) -* RSTART variable: Auto-set. (line 250) +* RSTART variable: Auto-set. (line 258) * RSTART variable, match() function and: String Functions. (line 224) -* RT variable <1>: Auto-set. (line 257) +* RT variable <1>: Auto-set. (line 265) * RT variable <2>: Multiple Line. (line 129) * RT variable: awk split records. (line 124) * Rubin, Paul <1>: Contributors. (line 15) @@ -33304,7 +33312,7 @@ Index * scanning arrays: Scanning an Array. (line 6) * scanning multidimensional arrays: Multiscanning. (line 11) * Schorr, Andrew <1>: Contributors. (line 134) -* Schorr, Andrew <2>: Auto-set. (line 284) +* Schorr, Andrew <2>: Auto-set. (line 292) * Schorr, Andrew: Acknowledgments. (line 60) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) @@ -33392,7 +33400,7 @@ Index (line 110) * sidebar, Changing FS Does Not Affect the Fields: Field Splitting Summary. (line 38) -* sidebar, Changing NR and FNR: Auto-set. (line 299) +* sidebar, Changing NR and FNR: Auto-set. (line 307) * sidebar, Controlling Output Buffering with system(): I/O Functions. (line 138) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. @@ -33554,9 +33562,9 @@ Index * substr: String Functions. (line 479) * substring: String Functions. (line 479) * Sumner, Andrew: Other Versions. (line 64) -* supplementary groups of gawk process: Auto-set. (line 229) +* supplementary groups of gawk process: Auto-set. (line 237) * switch statement: Switch Statement. (line 6) -* SYMTAB array: Auto-set. (line 261) +* SYMTAB array: Auto-set. (line 269) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. (line 148) * system: I/O Functions. (line 75) @@ -33734,10 +33742,10 @@ Index * variables, uninitialized, as array subscripts: Uninitialized Subscripts. (line 6) * variables, user-defined: Variables. (line 6) -* version of gawk: Auto-set. (line 199) -* version of gawk extension API: Auto-set. (line 224) -* version of GNU MP library: Auto-set. (line 210) -* version of GNU MPFR library: Auto-set. (line 206) +* version of gawk: Auto-set. (line 207) +* version of gawk extension API: Auto-set. (line 232) +* version of GNU MP library: Auto-set. (line 218) +* version of GNU MPFR library: Auto-set. (line 214) * vertical bar (|): Regexp Operators. (line 70) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 65) * vertical bar (|), | operator (I/O): Getline/Pipe. (line 9) @@ -34022,354 +34030,354 @@ Node: Built-in Variables420634 Node: User-modified421761 Ref: User-modified-Footnote-1429446 Node: Auto-set429508 -Ref: Auto-set-Footnote-1442073 -Ref: Auto-set-Footnote-2442278 -Node: ARGC and ARGV442334 -Node: Pattern Action Summary446188 -Node: Arrays448411 -Node: Array Basics449960 -Node: Array Intro450786 -Ref: figure-array-elements452759 -Node: Reference to Elements455166 -Node: Assigning Elements457439 -Node: Array Example457930 -Node: Scanning an Array459662 -Node: Controlling Scanning462677 -Ref: Controlling Scanning-Footnote-1467850 -Node: Delete468166 -Ref: Delete-Footnote-1470931 -Node: Numeric Array Subscripts470988 -Node: Uninitialized Subscripts473171 -Node: Multidimensional474796 -Node: Multiscanning477889 -Node: Arrays of Arrays479478 -Node: Arrays Summary484141 -Node: Functions486246 -Node: Built-in487119 -Node: Calling Built-in488197 -Node: Numeric Functions490185 -Ref: Numeric Functions-Footnote-1494019 -Ref: Numeric Functions-Footnote-2494376 -Ref: Numeric Functions-Footnote-3494424 -Node: String Functions494693 -Ref: String Functions-Footnote-1517704 -Ref: String Functions-Footnote-2517833 -Ref: String Functions-Footnote-3518081 -Node: Gory Details518168 -Ref: table-sub-escapes519837 -Ref: table-sub-posix-92521191 -Ref: table-sub-proposed522542 -Ref: table-posix-sub523896 -Ref: table-gensub-escapes525441 -Ref: Gory Details-Footnote-1526617 -Ref: Gory Details-Footnote-2526668 -Node: I/O Functions526819 -Ref: I/O Functions-Footnote-1533942 -Node: Time Functions534089 -Ref: Time Functions-Footnote-1544553 -Ref: Time Functions-Footnote-2544621 -Ref: Time Functions-Footnote-3544779 -Ref: Time Functions-Footnote-4544890 -Ref: Time Functions-Footnote-5545002 -Ref: Time Functions-Footnote-6545229 -Node: Bitwise Functions545495 -Ref: table-bitwise-ops546057 -Ref: Bitwise Functions-Footnote-1550302 -Node: Type Functions550486 -Node: I18N Functions551628 -Node: User-defined553273 -Node: Definition Syntax554077 -Ref: Definition Syntax-Footnote-1559002 -Node: Function Example559071 -Ref: Function Example-Footnote-1561715 -Node: Function Caveats561737 -Node: Calling A Function562255 -Node: Variable Scope563210 -Node: Pass By Value/Reference566198 -Node: Return Statement569706 -Node: Dynamic Typing572690 -Node: Indirect Calls573619 -Node: Functions Summary583332 -Node: Library Functions585871 -Ref: Library Functions-Footnote-1589446 -Ref: Library Functions-Footnote-2589589 -Node: Library Names589760 -Ref: Library Names-Footnote-1593233 -Ref: Library Names-Footnote-2593453 -Node: General Functions593539 -Node: Strtonum Function594567 -Node: Assert Function597497 -Node: Round Function600823 -Node: Cliff Random Function602364 -Node: Ordinal Functions603380 -Ref: Ordinal Functions-Footnote-1606457 -Ref: Ordinal Functions-Footnote-2606709 -Node: Join Function606920 -Ref: Join Function-Footnote-1608691 -Node: Getlocaltime Function608891 -Node: Readfile Function612627 -Node: Data File Management614466 -Node: Filetrans Function615098 -Node: Rewind Function619167 -Node: File Checking620554 -Ref: File Checking-Footnote-1621686 -Node: Empty Files621887 -Node: Ignoring Assigns624117 -Node: Getopt Function625671 -Ref: Getopt Function-Footnote-1636974 -Node: Passwd Functions637177 -Ref: Passwd Functions-Footnote-1646156 -Node: Group Functions646244 -Ref: Group Functions-Footnote-1654186 -Node: Walking Arrays654399 -Node: Library Functions Summary656569 -Node: Sample Programs657931 -Node: Running Examples658658 -Node: Clones659386 -Node: Cut Program660610 -Node: Egrep Program670478 -Ref: Egrep Program-Footnote-1678449 -Node: Id Program678559 -Node: Split Program682223 -Ref: Split Program-Footnote-1685761 -Node: Tee Program685889 -Node: Uniq Program688696 -Node: Wc Program696126 -Ref: Wc Program-Footnote-1700394 -Ref: Wc Program-Footnote-2700594 -Node: Miscellaneous Programs700686 -Node: Dupword Program701899 -Node: Alarm Program703930 -Node: Translate Program708744 -Ref: Translate Program-Footnote-1713135 -Ref: Translate Program-Footnote-2713405 -Node: Labels Program713539 -Ref: Labels Program-Footnote-1716910 -Node: Word Sorting716994 -Node: History Sorting721037 -Node: Extract Program722873 -Ref: Extract Program-Footnote-1730448 -Node: Simple Sed730577 -Node: Igawk Program733639 -Ref: Igawk Program-Footnote-1748815 -Ref: Igawk Program-Footnote-2749016 -Node: Anagram Program749154 -Node: Signature Program752222 -Node: Programs Summary753469 -Node: Advanced Features754657 -Node: Nondecimal Data756605 -Node: Array Sorting758182 -Node: Controlling Array Traversal758879 -Node: Array Sorting Functions767159 -Ref: Array Sorting Functions-Footnote-1771066 -Node: Two-way I/O771260 -Ref: Two-way I/O-Footnote-1776776 -Node: TCP/IP Networking776858 -Node: Profiling779702 -Node: Advanced Features Summary787244 -Node: Internationalization789108 -Node: I18N and L10N790588 -Node: Explaining gettext791274 -Ref: Explaining gettext-Footnote-1796414 -Ref: Explaining gettext-Footnote-2796598 -Node: Programmer i18n796763 -Node: Translator i18n800988 -Node: String Extraction801782 -Ref: String Extraction-Footnote-1802743 -Node: Printf Ordering802829 -Ref: Printf Ordering-Footnote-1805611 -Node: I18N Portability805675 -Ref: I18N Portability-Footnote-1808124 -Node: I18N Example808187 -Ref: I18N Example-Footnote-1810909 -Node: Gawk I18N810981 -Node: I18N Summary811619 -Node: Debugger812958 -Node: Debugging813980 -Node: Debugging Concepts814421 -Node: Debugging Terms816277 -Node: Awk Debugging818874 -Node: Sample Debugging Session819766 -Node: Debugger Invocation820286 -Node: Finding The Bug821619 -Node: List of Debugger Commands828101 -Node: Breakpoint Control829433 -Node: Debugger Execution Control833097 -Node: Viewing And Changing Data836457 -Node: Execution Stack839815 -Node: Debugger Info841328 -Node: Miscellaneous Debugger Commands845322 -Node: Readline Support850506 -Node: Limitations851398 -Node: Debugging Summary853672 -Node: Arbitrary Precision Arithmetic854836 -Ref: Arbitrary Precision Arithmetic-Footnote-1856485 -Node: General Arithmetic856633 -Node: Floating Point Issues858353 -Node: String Conversion Precision859234 -Ref: String Conversion Precision-Footnote-1860939 -Node: Unexpected Results861048 -Node: POSIX Floating Point Problems863201 -Ref: POSIX Floating Point Problems-Footnote-1867022 -Node: Integer Programming867060 -Node: Floating-point Programming868871 -Ref: Floating-point Programming-Footnote-1875199 -Ref: Floating-point Programming-Footnote-2875469 -Node: Floating-point Representation875733 -Node: Floating-point Context876898 -Ref: table-ieee-formats877737 -Node: Rounding Mode879121 -Ref: table-rounding-modes879600 -Ref: Rounding Mode-Footnote-1882615 -Node: Gawk and MPFR882794 -Node: Arbitrary Precision Floats884203 -Ref: Arbitrary Precision Floats-Footnote-1886646 -Node: Setting Precision886967 -Ref: table-predefined-precision-strings887651 -Node: Setting Rounding Mode889796 -Ref: table-gawk-rounding-modes890200 -Node: Floating-point Constants891387 -Node: Changing Precision892839 -Ref: Changing Precision-Footnote-1894231 -Node: Exact Arithmetic894405 -Node: Arbitrary Precision Integers897539 -Ref: Arbitrary Precision Integers-Footnote-1900554 -Node: Dynamic Extensions900701 -Node: Extension Intro902159 -Node: Plugin License903424 -Node: Extension Mechanism Outline904109 -Ref: figure-load-extension904533 -Ref: figure-load-new-function906018 -Ref: figure-call-new-function907020 -Node: Extension API Description909004 -Node: Extension API Functions Introduction910454 -Node: General Data Types915320 -Ref: General Data Types-Footnote-1921013 -Node: Requesting Values921312 -Ref: table-value-types-returned922049 -Node: Memory Allocation Functions923007 -Ref: Memory Allocation Functions-Footnote-1925754 -Node: Constructor Functions925850 -Node: Registration Functions927608 -Node: Extension Functions928293 -Node: Exit Callback Functions930595 -Node: Extension Version String931844 -Node: Input Parsers932494 -Node: Output Wrappers942297 -Node: Two-way processors946813 -Node: Printing Messages949017 -Ref: Printing Messages-Footnote-1950094 -Node: Updating `ERRNO'950246 -Node: Accessing Parameters950985 -Node: Symbol Table Access952215 -Node: Symbol table by name952729 -Node: Symbol table by cookie954705 -Ref: Symbol table by cookie-Footnote-1958838 -Node: Cached values958901 -Ref: Cached values-Footnote-1962405 -Node: Array Manipulation962496 -Ref: Array Manipulation-Footnote-1963594 -Node: Array Data Types963633 -Ref: Array Data Types-Footnote-1966336 -Node: Array Functions966428 -Node: Flattening Arrays970302 -Node: Creating Arrays977154 -Node: Extension API Variables981885 -Node: Extension Versioning982521 -Node: Extension API Informational Variables984422 -Node: Extension API Boilerplate985508 -Node: Finding Extensions989312 -Node: Extension Example989872 -Node: Internal File Description990602 -Node: Internal File Ops994693 -Ref: Internal File Ops-Footnote-11006239 -Node: Using Internal File Ops1006379 -Ref: Using Internal File Ops-Footnote-11008726 -Node: Extension Samples1008994 -Node: Extension Sample File Functions1010518 -Node: Extension Sample Fnmatch1018086 -Node: Extension Sample Fork1019567 -Node: Extension Sample Inplace1020780 -Node: Extension Sample Ord1022560 -Node: Extension Sample Readdir1023396 -Ref: table-readdir-file-types1024252 -Node: Extension Sample Revout1025051 -Node: Extension Sample Rev2way1025642 -Node: Extension Sample Read write array1026383 -Node: Extension Sample Readfile1028262 -Node: Extension Sample API Tests1029362 -Node: Extension Sample Time1029887 -Node: gawkextlib1031202 -Node: Language History1033989 -Node: V7/SVR3.11035583 -Node: SVR41037903 -Node: POSIX1039345 -Node: BTL1040731 -Node: POSIX/GNU1041465 -Node: Feature History1047064 -Node: Common Extensions1060176 -Node: Ranges and Locales1061488 -Ref: Ranges and Locales-Footnote-11066105 -Ref: Ranges and Locales-Footnote-21066132 -Ref: Ranges and Locales-Footnote-31066366 -Node: Contributors1066587 -Node: Installation1072025 -Node: Gawk Distribution1072919 -Node: Getting1073403 -Node: Extracting1074229 -Node: Distribution contents1075871 -Node: Unix Installation1081588 -Node: Quick Installation1082205 -Node: Additional Configuration Options1084647 -Node: Configuration Philosophy1086385 -Node: Non-Unix Installation1088736 -Node: PC Installation1089194 -Node: PC Binary Installation1090505 -Node: PC Compiling1092353 -Ref: PC Compiling-Footnote-11095352 -Node: PC Testing1095457 -Node: PC Using1096633 -Node: Cygwin1100791 -Node: MSYS1101600 -Node: VMS Installation1102114 -Node: VMS Compilation1102910 -Ref: VMS Compilation-Footnote-11104132 -Node: VMS Dynamic Extensions1104190 -Node: VMS Installation Details1105563 -Node: VMS Running1107815 -Node: VMS GNV1110649 -Node: VMS Old Gawk1111372 -Node: Bugs1111842 -Node: Other Versions1115846 -Node: Notes1122071 -Node: Compatibility Mode1122871 -Node: Additions1123653 -Node: Accessing The Source1124578 -Node: Adding Code1126014 -Node: New Ports1132192 -Node: Derived Files1136673 -Ref: Derived Files-Footnote-11141754 -Ref: Derived Files-Footnote-21141788 -Ref: Derived Files-Footnote-31142384 -Node: Future Extensions1142498 -Node: Implementation Limitations1143104 -Node: Extension Design1144352 -Node: Old Extension Problems1145506 -Ref: Old Extension Problems-Footnote-11147023 -Node: Extension New Mechanism Goals1147080 -Ref: Extension New Mechanism Goals-Footnote-11150440 -Node: Extension Other Design Decisions1150629 -Node: Extension Future Growth1152735 -Node: Old Extension Mechanism1153571 -Node: Basic Concepts1155311 -Node: Basic High Level1155992 -Ref: figure-general-flow1156264 -Ref: figure-process-flow1156863 -Ref: Basic High Level-Footnote-11160092 -Node: Basic Data Typing1160277 -Node: Glossary1163604 -Node: Copying1188756 -Node: GNU Free Documentation License1226312 -Node: Index1251448 +Ref: Auto-set-Footnote-1442410 +Ref: Auto-set-Footnote-2442615 +Node: ARGC and ARGV442671 +Node: Pattern Action Summary446525 +Node: Arrays448748 +Node: Array Basics450297 +Node: Array Intro451123 +Ref: figure-array-elements453096 +Node: Reference to Elements455503 +Node: Assigning Elements457776 +Node: Array Example458267 +Node: Scanning an Array459999 +Node: Controlling Scanning463014 +Ref: Controlling Scanning-Footnote-1468187 +Node: Delete468503 +Ref: Delete-Footnote-1471268 +Node: Numeric Array Subscripts471325 +Node: Uninitialized Subscripts473508 +Node: Multidimensional475133 +Node: Multiscanning478226 +Node: Arrays of Arrays479815 +Node: Arrays Summary484478 +Node: Functions486583 +Node: Built-in487456 +Node: Calling Built-in488534 +Node: Numeric Functions490522 +Ref: Numeric Functions-Footnote-1494356 +Ref: Numeric Functions-Footnote-2494713 +Ref: Numeric Functions-Footnote-3494761 +Node: String Functions495030 +Ref: String Functions-Footnote-1518041 +Ref: String Functions-Footnote-2518170 +Ref: String Functions-Footnote-3518418 +Node: Gory Details518505 +Ref: table-sub-escapes520174 +Ref: table-sub-posix-92521528 +Ref: table-sub-proposed522879 +Ref: table-posix-sub524233 +Ref: table-gensub-escapes525778 +Ref: Gory Details-Footnote-1526954 +Ref: Gory Details-Footnote-2527005 +Node: I/O Functions527156 +Ref: I/O Functions-Footnote-1534279 +Node: Time Functions534426 +Ref: Time Functions-Footnote-1544890 +Ref: Time Functions-Footnote-2544958 +Ref: Time Functions-Footnote-3545116 +Ref: Time Functions-Footnote-4545227 +Ref: Time Functions-Footnote-5545339 +Ref: Time Functions-Footnote-6545566 +Node: Bitwise Functions545832 +Ref: table-bitwise-ops546394 +Ref: Bitwise Functions-Footnote-1550639 +Node: Type Functions550823 +Node: I18N Functions551965 +Node: User-defined553610 +Node: Definition Syntax554414 +Ref: Definition Syntax-Footnote-1559339 +Node: Function Example559408 +Ref: Function Example-Footnote-1562052 +Node: Function Caveats562074 +Node: Calling A Function562592 +Node: Variable Scope563547 +Node: Pass By Value/Reference566535 +Node: Return Statement570043 +Node: Dynamic Typing573027 +Node: Indirect Calls573956 +Node: Functions Summary583669 +Node: Library Functions586208 +Ref: Library Functions-Footnote-1589783 +Ref: Library Functions-Footnote-2589926 +Node: Library Names590097 +Ref: Library Names-Footnote-1593570 +Ref: Library Names-Footnote-2593790 +Node: General Functions593876 +Node: Strtonum Function594904 +Node: Assert Function597834 +Node: Round Function601160 +Node: Cliff Random Function602701 +Node: Ordinal Functions603717 +Ref: Ordinal Functions-Footnote-1606794 +Ref: Ordinal Functions-Footnote-2607046 +Node: Join Function607257 +Ref: Join Function-Footnote-1609028 +Node: Getlocaltime Function609228 +Node: Readfile Function612964 +Node: Data File Management614803 +Node: Filetrans Function615435 +Node: Rewind Function619504 +Node: File Checking620891 +Ref: File Checking-Footnote-1622023 +Node: Empty Files622224 +Node: Ignoring Assigns624454 +Node: Getopt Function626008 +Ref: Getopt Function-Footnote-1637311 +Node: Passwd Functions637514 +Ref: Passwd Functions-Footnote-1646493 +Node: Group Functions646581 +Ref: Group Functions-Footnote-1654523 +Node: Walking Arrays654736 +Node: Library Functions Summary656906 +Node: Sample Programs658268 +Node: Running Examples658995 +Node: Clones659723 +Node: Cut Program660947 +Node: Egrep Program670815 +Ref: Egrep Program-Footnote-1678786 +Node: Id Program678896 +Node: Split Program682560 +Ref: Split Program-Footnote-1686098 +Node: Tee Program686226 +Node: Uniq Program689033 +Node: Wc Program696463 +Ref: Wc Program-Footnote-1700731 +Ref: Wc Program-Footnote-2700931 +Node: Miscellaneous Programs701023 +Node: Dupword Program702236 +Node: Alarm Program704267 +Node: Translate Program709081 +Ref: Translate Program-Footnote-1713472 +Ref: Translate Program-Footnote-2713742 +Node: Labels Program713876 +Ref: Labels Program-Footnote-1717247 +Node: Word Sorting717331 +Node: History Sorting721374 +Node: Extract Program723210 +Ref: Extract Program-Footnote-1730785 +Node: Simple Sed730914 +Node: Igawk Program733976 +Ref: Igawk Program-Footnote-1749152 +Ref: Igawk Program-Footnote-2749353 +Node: Anagram Program749491 +Node: Signature Program752559 +Node: Programs Summary753806 +Node: Advanced Features754994 +Node: Nondecimal Data756942 +Node: Array Sorting758519 +Node: Controlling Array Traversal759216 +Node: Array Sorting Functions767496 +Ref: Array Sorting Functions-Footnote-1771403 +Node: Two-way I/O771597 +Ref: Two-way I/O-Footnote-1777113 +Node: TCP/IP Networking777195 +Node: Profiling780039 +Node: Advanced Features Summary787581 +Node: Internationalization789445 +Node: I18N and L10N790925 +Node: Explaining gettext791611 +Ref: Explaining gettext-Footnote-1796751 +Ref: Explaining gettext-Footnote-2796935 +Node: Programmer i18n797100 +Node: Translator i18n801325 +Node: String Extraction802119 +Ref: String Extraction-Footnote-1803080 +Node: Printf Ordering803166 +Ref: Printf Ordering-Footnote-1805948 +Node: I18N Portability806012 +Ref: I18N Portability-Footnote-1808461 +Node: I18N Example808524 +Ref: I18N Example-Footnote-1811246 +Node: Gawk I18N811318 +Node: I18N Summary811956 +Node: Debugger813295 +Node: Debugging814317 +Node: Debugging Concepts814758 +Node: Debugging Terms816614 +Node: Awk Debugging819211 +Node: Sample Debugging Session820103 +Node: Debugger Invocation820623 +Node: Finding The Bug821956 +Node: List of Debugger Commands828438 +Node: Breakpoint Control829770 +Node: Debugger Execution Control833434 +Node: Viewing And Changing Data836794 +Node: Execution Stack840152 +Node: Debugger Info841665 +Node: Miscellaneous Debugger Commands845659 +Node: Readline Support850843 +Node: Limitations851735 +Node: Debugging Summary854009 +Node: Arbitrary Precision Arithmetic855173 +Ref: Arbitrary Precision Arithmetic-Footnote-1856822 +Node: General Arithmetic856970 +Node: Floating Point Issues858690 +Node: String Conversion Precision859571 +Ref: String Conversion Precision-Footnote-1861276 +Node: Unexpected Results861385 +Node: POSIX Floating Point Problems863538 +Ref: POSIX Floating Point Problems-Footnote-1867359 +Node: Integer Programming867397 +Node: Floating-point Programming869208 +Ref: Floating-point Programming-Footnote-1875536 +Ref: Floating-point Programming-Footnote-2875806 +Node: Floating-point Representation876070 +Node: Floating-point Context877235 +Ref: table-ieee-formats878074 +Node: Rounding Mode879458 +Ref: table-rounding-modes879937 +Ref: Rounding Mode-Footnote-1882952 +Node: Gawk and MPFR883131 +Node: Arbitrary Precision Floats884540 +Ref: Arbitrary Precision Floats-Footnote-1886983 +Node: Setting Precision887304 +Ref: table-predefined-precision-strings887988 +Node: Setting Rounding Mode890133 +Ref: table-gawk-rounding-modes890537 +Node: Floating-point Constants891724 +Node: Changing Precision893176 +Ref: Changing Precision-Footnote-1894568 +Node: Exact Arithmetic894742 +Node: Arbitrary Precision Integers897876 +Ref: Arbitrary Precision Integers-Footnote-1900891 +Node: Dynamic Extensions901038 +Node: Extension Intro902496 +Node: Plugin License903761 +Node: Extension Mechanism Outline904446 +Ref: figure-load-extension904870 +Ref: figure-load-new-function906355 +Ref: figure-call-new-function907357 +Node: Extension API Description909341 +Node: Extension API Functions Introduction910791 +Node: General Data Types915657 +Ref: General Data Types-Footnote-1921350 +Node: Requesting Values921649 +Ref: table-value-types-returned922386 +Node: Memory Allocation Functions923344 +Ref: Memory Allocation Functions-Footnote-1926091 +Node: Constructor Functions926187 +Node: Registration Functions927945 +Node: Extension Functions928630 +Node: Exit Callback Functions930932 +Node: Extension Version String932181 +Node: Input Parsers932831 +Node: Output Wrappers942634 +Node: Two-way processors947150 +Node: Printing Messages949354 +Ref: Printing Messages-Footnote-1950431 +Node: Updating `ERRNO'950583 +Node: Accessing Parameters951322 +Node: Symbol Table Access952552 +Node: Symbol table by name953066 +Node: Symbol table by cookie955042 +Ref: Symbol table by cookie-Footnote-1959175 +Node: Cached values959238 +Ref: Cached values-Footnote-1962742 +Node: Array Manipulation962833 +Ref: Array Manipulation-Footnote-1963931 +Node: Array Data Types963970 +Ref: Array Data Types-Footnote-1966673 +Node: Array Functions966765 +Node: Flattening Arrays970639 +Node: Creating Arrays977491 +Node: Extension API Variables982222 +Node: Extension Versioning982858 +Node: Extension API Informational Variables984759 +Node: Extension API Boilerplate985845 +Node: Finding Extensions989649 +Node: Extension Example990209 +Node: Internal File Description990939 +Node: Internal File Ops995030 +Ref: Internal File Ops-Footnote-11006576 +Node: Using Internal File Ops1006716 +Ref: Using Internal File Ops-Footnote-11009063 +Node: Extension Samples1009331 +Node: Extension Sample File Functions1010855 +Node: Extension Sample Fnmatch1018423 +Node: Extension Sample Fork1019904 +Node: Extension Sample Inplace1021117 +Node: Extension Sample Ord1022897 +Node: Extension Sample Readdir1023733 +Ref: table-readdir-file-types1024589 +Node: Extension Sample Revout1025388 +Node: Extension Sample Rev2way1025979 +Node: Extension Sample Read write array1026720 +Node: Extension Sample Readfile1028599 +Node: Extension Sample API Tests1029699 +Node: Extension Sample Time1030224 +Node: gawkextlib1031539 +Node: Language History1034326 +Node: V7/SVR3.11035920 +Node: SVR41038240 +Node: POSIX1039682 +Node: BTL1041068 +Node: POSIX/GNU1041802 +Node: Feature History1047401 +Node: Common Extensions1060513 +Node: Ranges and Locales1061825 +Ref: Ranges and Locales-Footnote-11066442 +Ref: Ranges and Locales-Footnote-21066469 +Ref: Ranges and Locales-Footnote-31066703 +Node: Contributors1066924 +Node: Installation1072362 +Node: Gawk Distribution1073256 +Node: Getting1073740 +Node: Extracting1074566 +Node: Distribution contents1076208 +Node: Unix Installation1081925 +Node: Quick Installation1082542 +Node: Additional Configuration Options1084984 +Node: Configuration Philosophy1086722 +Node: Non-Unix Installation1089073 +Node: PC Installation1089531 +Node: PC Binary Installation1090842 +Node: PC Compiling1092690 +Ref: PC Compiling-Footnote-11095689 +Node: PC Testing1095794 +Node: PC Using1096970 +Node: Cygwin1101128 +Node: MSYS1101937 +Node: VMS Installation1102451 +Node: VMS Compilation1103247 +Ref: VMS Compilation-Footnote-11104469 +Node: VMS Dynamic Extensions1104527 +Node: VMS Installation Details1105900 +Node: VMS Running1108152 +Node: VMS GNV1110986 +Node: VMS Old Gawk1111709 +Node: Bugs1112179 +Node: Other Versions1116183 +Node: Notes1122408 +Node: Compatibility Mode1123208 +Node: Additions1123990 +Node: Accessing The Source1124915 +Node: Adding Code1126351 +Node: New Ports1132529 +Node: Derived Files1137010 +Ref: Derived Files-Footnote-11142091 +Ref: Derived Files-Footnote-21142125 +Ref: Derived Files-Footnote-31142721 +Node: Future Extensions1142835 +Node: Implementation Limitations1143441 +Node: Extension Design1144689 +Node: Old Extension Problems1145843 +Ref: Old Extension Problems-Footnote-11147360 +Node: Extension New Mechanism Goals1147417 +Ref: Extension New Mechanism Goals-Footnote-11150777 +Node: Extension Other Design Decisions1150966 +Node: Extension Future Growth1153072 +Node: Old Extension Mechanism1153908 +Node: Basic Concepts1155648 +Node: Basic High Level1156329 +Ref: figure-general-flow1156601 +Ref: figure-process-flow1157200 +Ref: Basic High Level-Footnote-11160429 +Node: Basic Data Typing1160614 +Node: Glossary1163941 +Node: Copying1189093 +Node: GNU Free Documentation License1226649 +Node: Index1251785 End Tag Table |