diff options
Diffstat (limited to 'doc/gawk.info')
-rw-r--r-- | doc/gawk.info | 798 |
1 files changed, 403 insertions, 395 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index cf5c6036..f81c5f36 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10156,10 +10156,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 @@ -31742,9 +31750,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) @@ -31929,12 +31937,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) @@ -31957,7 +31965,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) @@ -31967,7 +31975,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. @@ -31975,7 +31983,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. @@ -32015,8 +32023,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) @@ -32072,13 +32080,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) @@ -32132,7 +32140,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) @@ -32211,7 +32219,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) @@ -32279,9 +32287,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. @@ -32331,7 +32339,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) @@ -32381,7 +32389,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) @@ -32402,7 +32410,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) @@ -32419,7 +32427,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. @@ -32450,7 +32458,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. @@ -32458,14 +32466,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) @@ -32551,7 +32559,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. @@ -32842,7 +32850,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) @@ -32855,7 +32863,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) @@ -32907,7 +32915,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. @@ -32916,9 +32924,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. @@ -33033,7 +33041,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) @@ -33196,24 +33204,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. @@ -33373,7 +33381,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) @@ -33399,9 +33407,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) @@ -33421,7 +33429,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) @@ -33506,7 +33514,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. @@ -33669,9 +33677,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) @@ -33849,10 +33857,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) @@ -34140,351 +34148,351 @@ Node: Built-in Variables423654 Node: User-modified424781 Ref: User-modified-Footnote-1432470 Node: Auto-set432532 -Ref: Auto-set-Footnote-1445114 -Ref: Auto-set-Footnote-2445319 -Node: ARGC and ARGV445375 -Node: Pattern Action Summary449229 -Node: Arrays451452 -Node: Array Basics453001 -Node: Array Intro453827 -Ref: figure-array-elements455800 -Node: Reference to Elements458207 -Node: Assigning Elements460480 -Node: Array Example460971 -Node: Scanning an Array462703 -Node: Controlling Scanning465718 -Ref: Controlling Scanning-Footnote-1470891 -Node: Delete471207 -Ref: Delete-Footnote-1473972 -Node: Numeric Array Subscripts474029 -Node: Uninitialized Subscripts476212 -Node: Multidimensional477837 -Node: Multiscanning480930 -Node: Arrays of Arrays482519 -Node: Arrays Summary487182 -Node: Functions489287 -Node: Built-in490160 -Node: Calling Built-in491238 -Node: Numeric Functions493226 -Ref: Numeric Functions-Footnote-1497060 -Ref: Numeric Functions-Footnote-2497417 -Ref: Numeric Functions-Footnote-3497465 -Node: String Functions497734 -Ref: String Functions-Footnote-1520745 -Ref: String Functions-Footnote-2520874 -Ref: String Functions-Footnote-3521122 -Node: Gory Details521209 -Ref: table-sub-escapes522878 -Ref: table-sub-posix-92524232 -Ref: table-sub-proposed525583 -Ref: table-posix-sub526937 -Ref: table-gensub-escapes528482 -Ref: Gory Details-Footnote-1529658 -Ref: Gory Details-Footnote-2529709 -Node: I/O Functions529860 -Ref: I/O Functions-Footnote-1536983 -Node: Time Functions537130 -Ref: Time Functions-Footnote-1547594 -Ref: Time Functions-Footnote-2547662 -Ref: Time Functions-Footnote-3547820 -Ref: Time Functions-Footnote-4547931 -Ref: Time Functions-Footnote-5548043 -Ref: Time Functions-Footnote-6548270 -Node: Bitwise Functions548536 -Ref: table-bitwise-ops549098 -Ref: Bitwise Functions-Footnote-1553343 -Node: Type Functions553527 -Node: I18N Functions554669 -Node: User-defined556314 -Node: Definition Syntax557118 -Ref: Definition Syntax-Footnote-1562043 -Node: Function Example562112 -Ref: Function Example-Footnote-1564756 -Node: Function Caveats564778 -Node: Calling A Function565296 -Node: Variable Scope566251 -Node: Pass By Value/Reference569239 -Node: Return Statement572747 -Node: Dynamic Typing575731 -Node: Indirect Calls576660 -Node: Functions Summary586373 -Node: Library Functions588912 -Ref: Library Functions-Footnote-1592530 -Ref: Library Functions-Footnote-2592673 -Node: Library Names592844 -Ref: Library Names-Footnote-1596317 -Ref: Library Names-Footnote-2596537 -Node: General Functions596623 -Node: Strtonum Function597651 -Node: Assert Function600431 -Node: Round Function603757 -Node: Cliff Random Function605298 -Node: Ordinal Functions606314 -Ref: Ordinal Functions-Footnote-1609391 -Ref: Ordinal Functions-Footnote-2609643 -Node: Join Function609854 -Ref: Join Function-Footnote-1611625 -Node: Getlocaltime Function611825 -Node: Readfile Function615561 -Node: Data File Management617400 -Node: Filetrans Function618032 -Node: Rewind Function622101 -Node: File Checking623488 -Ref: File Checking-Footnote-1624620 -Node: Empty Files624821 -Node: Ignoring Assigns626800 -Node: Getopt Function628354 -Ref: Getopt Function-Footnote-1639657 -Node: Passwd Functions639860 -Ref: Passwd Functions-Footnote-1648839 -Node: Group Functions648927 -Ref: Group Functions-Footnote-1656868 -Node: Walking Arrays657081 -Node: Library Functions Summary658684 -Node: Library exercises660072 -Node: Sample Programs661352 -Node: Running Examples662122 -Node: Clones662850 -Node: Cut Program664074 -Node: Egrep Program673942 -Ref: Egrep Program-Footnote-1681913 -Node: Id Program682023 -Node: Split Program685687 -Ref: Split Program-Footnote-1689225 -Node: Tee Program689353 -Node: Uniq Program692160 -Node: Wc Program699590 -Ref: Wc Program-Footnote-1703855 -Node: Miscellaneous Programs703947 -Node: Dupword Program705160 -Node: Alarm Program707191 -Node: Translate Program712005 -Ref: Translate Program-Footnote-1716396 -Ref: Translate Program-Footnote-2716666 -Node: Labels Program716800 -Ref: Labels Program-Footnote-1720171 -Node: Word Sorting720255 -Node: History Sorting724298 -Node: Extract Program726134 -Node: Simple Sed733670 -Node: Igawk Program736732 -Ref: Igawk Program-Footnote-1751043 -Ref: Igawk Program-Footnote-2751244 -Node: Anagram Program751382 -Node: Signature Program754450 -Node: Programs Summary755697 -Node: Programs Exercises756912 -Node: Advanced Features760563 -Node: Nondecimal Data762511 -Node: Array Sorting764088 -Node: Controlling Array Traversal764785 -Node: Array Sorting Functions773065 -Ref: Array Sorting Functions-Footnote-1776972 -Node: Two-way I/O777166 -Ref: Two-way I/O-Footnote-1782682 -Node: TCP/IP Networking782764 -Node: Profiling785608 -Node: Advanced Features Summary793150 -Node: Internationalization795014 -Node: I18N and L10N796494 -Node: Explaining gettext797180 -Ref: Explaining gettext-Footnote-1802320 -Ref: Explaining gettext-Footnote-2802504 -Node: Programmer i18n802669 -Node: Translator i18n806894 -Node: String Extraction807688 -Ref: String Extraction-Footnote-1808649 -Node: Printf Ordering808735 -Ref: Printf Ordering-Footnote-1811517 -Node: I18N Portability811581 -Ref: I18N Portability-Footnote-1814030 -Node: I18N Example814093 -Ref: I18N Example-Footnote-1816815 -Node: Gawk I18N816887 -Node: I18N Summary817525 -Node: Debugger818864 -Node: Debugging819886 -Node: Debugging Concepts820327 -Node: Debugging Terms822183 -Node: Awk Debugging824780 -Node: Sample Debugging Session825672 -Node: Debugger Invocation826192 -Node: Finding The Bug827525 -Node: List of Debugger Commands834007 -Node: Breakpoint Control835339 -Node: Debugger Execution Control839003 -Node: Viewing And Changing Data842363 -Node: Execution Stack845721 -Node: Debugger Info847234 -Node: Miscellaneous Debugger Commands851228 -Node: Readline Support856412 -Node: Limitations857304 -Node: Debugging Summary859578 -Node: Arbitrary Precision Arithmetic860742 -Node: Computer Arithmetic862071 -Ref: Computer Arithmetic-Footnote-1866458 -Node: Math Definitions866515 -Ref: table-ieee-formats869399 -Node: MPFR features869903 -Node: FP Math Caution871545 -Ref: FP Math Caution-Footnote-1872586 -Node: Inexactness of computations872955 -Node: Inexact representation873903 -Node: Comparing FP Values875258 -Node: Errors accumulate876222 -Node: Getting Accuracy877655 -Node: Try To Round880314 -Node: Setting precision881213 -Ref: table-predefined-precision-strings881895 -Node: Setting the rounding mode883688 -Ref: table-gawk-rounding-modes884052 -Ref: Setting the rounding mode-Footnote-1887506 -Node: Arbitrary Precision Integers887685 -Ref: Arbitrary Precision Integers-Footnote-1890688 -Node: POSIX Floating Point Problems890837 -Ref: POSIX Floating Point Problems-Footnote-1894713 -Node: Floating point summary894751 -Node: Dynamic Extensions896968 -Node: Extension Intro898520 -Node: Plugin License899785 -Node: Extension Mechanism Outline900470 -Ref: figure-load-extension900894 -Ref: figure-load-new-function902379 -Ref: figure-call-new-function903381 -Node: Extension API Description905365 -Node: Extension API Functions Introduction906815 -Node: General Data Types911680 -Ref: General Data Types-Footnote-1917373 -Node: Requesting Values917672 -Ref: table-value-types-returned918409 -Node: Memory Allocation Functions919367 -Ref: Memory Allocation Functions-Footnote-1922114 -Node: Constructor Functions922210 -Node: Registration Functions923968 -Node: Extension Functions924653 -Node: Exit Callback Functions926955 -Node: Extension Version String928204 -Node: Input Parsers928854 -Node: Output Wrappers938657 -Node: Two-way processors943173 -Node: Printing Messages945377 -Ref: Printing Messages-Footnote-1946454 -Node: Updating `ERRNO'946606 -Node: Accessing Parameters947345 -Node: Symbol Table Access948575 -Node: Symbol table by name949089 -Node: Symbol table by cookie951065 -Ref: Symbol table by cookie-Footnote-1955198 -Node: Cached values955261 -Ref: Cached values-Footnote-1958765 -Node: Array Manipulation958856 -Ref: Array Manipulation-Footnote-1959954 -Node: Array Data Types959993 -Ref: Array Data Types-Footnote-1962696 -Node: Array Functions962788 -Node: Flattening Arrays966662 -Node: Creating Arrays973514 -Node: Extension API Variables978245 -Node: Extension Versioning978881 -Node: Extension API Informational Variables980782 -Node: Extension API Boilerplate981868 -Node: Finding Extensions985672 -Node: Extension Example986232 -Node: Internal File Description986962 -Node: Internal File Ops991053 -Ref: Internal File Ops-Footnote-11002485 -Node: Using Internal File Ops1002625 -Ref: Using Internal File Ops-Footnote-11004972 -Node: Extension Samples1005240 -Node: Extension Sample File Functions1006764 -Node: Extension Sample Fnmatch1014332 -Node: Extension Sample Fork1015813 -Node: Extension Sample Inplace1017026 -Node: Extension Sample Ord1018701 -Node: Extension Sample Readdir1019537 -Ref: table-readdir-file-types1020393 -Node: Extension Sample Revout1021192 -Node: Extension Sample Rev2way1021783 -Node: Extension Sample Read write array1022524 -Node: Extension Sample Readfile1024403 -Node: Extension Sample API Tests1025503 -Node: Extension Sample Time1026028 -Node: gawkextlib1027343 -Node: Extension summary1030156 -Node: Extension Exercises1033849 -Node: Language History1034571 -Node: V7/SVR3.11036214 -Node: SVR41038534 -Node: POSIX1039976 -Node: BTL1041362 -Node: POSIX/GNU1042096 -Node: Feature History1047695 -Node: Common Extensions1060825 -Node: Ranges and Locales1062137 -Ref: Ranges and Locales-Footnote-11066754 -Ref: Ranges and Locales-Footnote-21066781 -Ref: Ranges and Locales-Footnote-31067015 -Node: Contributors1067236 -Node: History summary1072698 -Node: Installation1074067 -Node: Gawk Distribution1075018 -Node: Getting1075502 -Node: Extracting1076326 -Node: Distribution contents1077968 -Node: Unix Installation1083685 -Node: Quick Installation1084302 -Node: Additional Configuration Options1086744 -Node: Configuration Philosophy1088482 -Node: Non-Unix Installation1090833 -Node: PC Installation1091291 -Node: PC Binary Installation1092602 -Node: PC Compiling1094450 -Ref: PC Compiling-Footnote-11097449 -Node: PC Testing1097554 -Node: PC Using1098730 -Node: Cygwin1102888 -Node: MSYS1103697 -Node: VMS Installation1104211 -Node: VMS Compilation1105007 -Ref: VMS Compilation-Footnote-11106229 -Node: VMS Dynamic Extensions1106287 -Node: VMS Installation Details1107660 -Node: VMS Running1109912 -Node: VMS GNV1112746 -Node: VMS Old Gawk1113469 -Node: Bugs1113939 -Node: Other Versions1117943 -Node: Installation summary1124198 -Node: Notes1125254 -Node: Compatibility Mode1126119 -Node: Additions1126901 -Node: Accessing The Source1127826 -Node: Adding Code1129262 -Node: New Ports1135440 -Node: Derived Files1139921 -Ref: Derived Files-Footnote-11145002 -Ref: Derived Files-Footnote-21145036 -Ref: Derived Files-Footnote-31145632 -Node: Future Extensions1145746 -Node: Implementation Limitations1146352 -Node: Extension Design1147600 -Node: Old Extension Problems1148754 -Ref: Old Extension Problems-Footnote-11150271 -Node: Extension New Mechanism Goals1150328 -Ref: Extension New Mechanism Goals-Footnote-11153688 -Node: Extension Other Design Decisions1153877 -Node: Extension Future Growth1155983 -Node: Old Extension Mechanism1156819 -Node: Notes summary1158581 -Node: Basic Concepts1159767 -Node: Basic High Level1160448 -Ref: figure-general-flow1160720 -Ref: figure-process-flow1161319 -Ref: Basic High Level-Footnote-11164548 -Node: Basic Data Typing1164733 -Node: Glossary1168061 -Node: Copying1193213 -Node: GNU Free Documentation License1230769 -Node: Index1255905 +Ref: Auto-set-Footnote-1445451 +Ref: Auto-set-Footnote-2445656 +Node: ARGC and ARGV445712 +Node: Pattern Action Summary449566 +Node: Arrays451789 +Node: Array Basics453338 +Node: Array Intro454164 +Ref: figure-array-elements456137 +Node: Reference to Elements458544 +Node: Assigning Elements460817 +Node: Array Example461308 +Node: Scanning an Array463040 +Node: Controlling Scanning466055 +Ref: Controlling Scanning-Footnote-1471228 +Node: Delete471544 +Ref: Delete-Footnote-1474309 +Node: Numeric Array Subscripts474366 +Node: Uninitialized Subscripts476549 +Node: Multidimensional478174 +Node: Multiscanning481267 +Node: Arrays of Arrays482856 +Node: Arrays Summary487519 +Node: Functions489624 +Node: Built-in490497 +Node: Calling Built-in491575 +Node: Numeric Functions493563 +Ref: Numeric Functions-Footnote-1497397 +Ref: Numeric Functions-Footnote-2497754 +Ref: Numeric Functions-Footnote-3497802 +Node: String Functions498071 +Ref: String Functions-Footnote-1521082 +Ref: String Functions-Footnote-2521211 +Ref: String Functions-Footnote-3521459 +Node: Gory Details521546 +Ref: table-sub-escapes523215 +Ref: table-sub-posix-92524569 +Ref: table-sub-proposed525920 +Ref: table-posix-sub527274 +Ref: table-gensub-escapes528819 +Ref: Gory Details-Footnote-1529995 +Ref: Gory Details-Footnote-2530046 +Node: I/O Functions530197 +Ref: I/O Functions-Footnote-1537320 +Node: Time Functions537467 +Ref: Time Functions-Footnote-1547931 +Ref: Time Functions-Footnote-2547999 +Ref: Time Functions-Footnote-3548157 +Ref: Time Functions-Footnote-4548268 +Ref: Time Functions-Footnote-5548380 +Ref: Time Functions-Footnote-6548607 +Node: Bitwise Functions548873 +Ref: table-bitwise-ops549435 +Ref: Bitwise Functions-Footnote-1553680 +Node: Type Functions553864 +Node: I18N Functions555006 +Node: User-defined556651 +Node: Definition Syntax557455 +Ref: Definition Syntax-Footnote-1562380 +Node: Function Example562449 +Ref: Function Example-Footnote-1565093 +Node: Function Caveats565115 +Node: Calling A Function565633 +Node: Variable Scope566588 +Node: Pass By Value/Reference569576 +Node: Return Statement573084 +Node: Dynamic Typing576068 +Node: Indirect Calls576997 +Node: Functions Summary586710 +Node: Library Functions589249 +Ref: Library Functions-Footnote-1592867 +Ref: Library Functions-Footnote-2593010 +Node: Library Names593181 +Ref: Library Names-Footnote-1596654 +Ref: Library Names-Footnote-2596874 +Node: General Functions596960 +Node: Strtonum Function597988 +Node: Assert Function600768 +Node: Round Function604094 +Node: Cliff Random Function605635 +Node: Ordinal Functions606651 +Ref: Ordinal Functions-Footnote-1609728 +Ref: Ordinal Functions-Footnote-2609980 +Node: Join Function610191 +Ref: Join Function-Footnote-1611962 +Node: Getlocaltime Function612162 +Node: Readfile Function615898 +Node: Data File Management617737 +Node: Filetrans Function618369 +Node: Rewind Function622438 +Node: File Checking623825 +Ref: File Checking-Footnote-1624957 +Node: Empty Files625158 +Node: Ignoring Assigns627137 +Node: Getopt Function628691 +Ref: Getopt Function-Footnote-1639994 +Node: Passwd Functions640197 +Ref: Passwd Functions-Footnote-1649176 +Node: Group Functions649264 +Ref: Group Functions-Footnote-1657205 +Node: Walking Arrays657418 +Node: Library Functions Summary659021 +Node: Library exercises660409 +Node: Sample Programs661689 +Node: Running Examples662459 +Node: Clones663187 +Node: Cut Program664411 +Node: Egrep Program674279 +Ref: Egrep Program-Footnote-1682250 +Node: Id Program682360 +Node: Split Program686024 +Ref: Split Program-Footnote-1689562 +Node: Tee Program689690 +Node: Uniq Program692497 +Node: Wc Program699927 +Ref: Wc Program-Footnote-1704192 +Node: Miscellaneous Programs704284 +Node: Dupword Program705497 +Node: Alarm Program707528 +Node: Translate Program712342 +Ref: Translate Program-Footnote-1716733 +Ref: Translate Program-Footnote-2717003 +Node: Labels Program717137 +Ref: Labels Program-Footnote-1720508 +Node: Word Sorting720592 +Node: History Sorting724635 +Node: Extract Program726471 +Node: Simple Sed734007 +Node: Igawk Program737069 +Ref: Igawk Program-Footnote-1751380 +Ref: Igawk Program-Footnote-2751581 +Node: Anagram Program751719 +Node: Signature Program754787 +Node: Programs Summary756034 +Node: Programs Exercises757249 +Node: Advanced Features760900 +Node: Nondecimal Data762848 +Node: Array Sorting764425 +Node: Controlling Array Traversal765122 +Node: Array Sorting Functions773402 +Ref: Array Sorting Functions-Footnote-1777309 +Node: Two-way I/O777503 +Ref: Two-way I/O-Footnote-1783019 +Node: TCP/IP Networking783101 +Node: Profiling785945 +Node: Advanced Features Summary793487 +Node: Internationalization795351 +Node: I18N and L10N796831 +Node: Explaining gettext797517 +Ref: Explaining gettext-Footnote-1802657 +Ref: Explaining gettext-Footnote-2802841 +Node: Programmer i18n803006 +Node: Translator i18n807231 +Node: String Extraction808025 +Ref: String Extraction-Footnote-1808986 +Node: Printf Ordering809072 +Ref: Printf Ordering-Footnote-1811854 +Node: I18N Portability811918 +Ref: I18N Portability-Footnote-1814367 +Node: I18N Example814430 +Ref: I18N Example-Footnote-1817152 +Node: Gawk I18N817224 +Node: I18N Summary817862 +Node: Debugger819201 +Node: Debugging820223 +Node: Debugging Concepts820664 +Node: Debugging Terms822520 +Node: Awk Debugging825117 +Node: Sample Debugging Session826009 +Node: Debugger Invocation826529 +Node: Finding The Bug827862 +Node: List of Debugger Commands834344 +Node: Breakpoint Control835676 +Node: Debugger Execution Control839340 +Node: Viewing And Changing Data842700 +Node: Execution Stack846058 +Node: Debugger Info847571 +Node: Miscellaneous Debugger Commands851565 +Node: Readline Support856749 +Node: Limitations857641 +Node: Debugging Summary859915 +Node: Arbitrary Precision Arithmetic861079 +Node: Computer Arithmetic862408 +Ref: Computer Arithmetic-Footnote-1866795 +Node: Math Definitions866852 +Ref: table-ieee-formats869736 +Node: MPFR features870240 +Node: FP Math Caution871882 +Ref: FP Math Caution-Footnote-1872923 +Node: Inexactness of computations873292 +Node: Inexact representation874240 +Node: Comparing FP Values875595 +Node: Errors accumulate876559 +Node: Getting Accuracy877992 +Node: Try To Round880651 +Node: Setting precision881550 +Ref: table-predefined-precision-strings882232 +Node: Setting the rounding mode884025 +Ref: table-gawk-rounding-modes884389 +Ref: Setting the rounding mode-Footnote-1887843 +Node: Arbitrary Precision Integers888022 +Ref: Arbitrary Precision Integers-Footnote-1891025 +Node: POSIX Floating Point Problems891174 +Ref: POSIX Floating Point Problems-Footnote-1895050 +Node: Floating point summary895088 +Node: Dynamic Extensions897305 +Node: Extension Intro898857 +Node: Plugin License900122 +Node: Extension Mechanism Outline900807 +Ref: figure-load-extension901231 +Ref: figure-load-new-function902716 +Ref: figure-call-new-function903718 +Node: Extension API Description905702 +Node: Extension API Functions Introduction907152 +Node: General Data Types912017 +Ref: General Data Types-Footnote-1917710 +Node: Requesting Values918009 +Ref: table-value-types-returned918746 +Node: Memory Allocation Functions919704 +Ref: Memory Allocation Functions-Footnote-1922451 +Node: Constructor Functions922547 +Node: Registration Functions924305 +Node: Extension Functions924990 +Node: Exit Callback Functions927292 +Node: Extension Version String928541 +Node: Input Parsers929191 +Node: Output Wrappers938994 +Node: Two-way processors943510 +Node: Printing Messages945714 +Ref: Printing Messages-Footnote-1946791 +Node: Updating `ERRNO'946943 +Node: Accessing Parameters947682 +Node: Symbol Table Access948912 +Node: Symbol table by name949426 +Node: Symbol table by cookie951402 +Ref: Symbol table by cookie-Footnote-1955535 +Node: Cached values955598 +Ref: Cached values-Footnote-1959102 +Node: Array Manipulation959193 +Ref: Array Manipulation-Footnote-1960291 +Node: Array Data Types960330 +Ref: Array Data Types-Footnote-1963033 +Node: Array Functions963125 +Node: Flattening Arrays966999 +Node: Creating Arrays973851 +Node: Extension API Variables978582 +Node: Extension Versioning979218 +Node: Extension API Informational Variables981119 +Node: Extension API Boilerplate982205 +Node: Finding Extensions986009 +Node: Extension Example986569 +Node: Internal File Description987299 +Node: Internal File Ops991390 +Ref: Internal File Ops-Footnote-11002822 +Node: Using Internal File Ops1002962 +Ref: Using Internal File Ops-Footnote-11005309 +Node: Extension Samples1005577 +Node: Extension Sample File Functions1007101 +Node: Extension Sample Fnmatch1014669 +Node: Extension Sample Fork1016150 +Node: Extension Sample Inplace1017363 +Node: Extension Sample Ord1019038 +Node: Extension Sample Readdir1019874 +Ref: table-readdir-file-types1020730 +Node: Extension Sample Revout1021529 +Node: Extension Sample Rev2way1022120 +Node: Extension Sample Read write array1022861 +Node: Extension Sample Readfile1024740 +Node: Extension Sample API Tests1025840 +Node: Extension Sample Time1026365 +Node: gawkextlib1027680 +Node: Extension summary1030493 +Node: Extension Exercises1034186 +Node: Language History1034908 +Node: V7/SVR3.11036551 +Node: SVR41038871 +Node: POSIX1040313 +Node: BTL1041699 +Node: POSIX/GNU1042433 +Node: Feature History1048032 +Node: Common Extensions1061162 +Node: Ranges and Locales1062474 +Ref: Ranges and Locales-Footnote-11067091 +Ref: Ranges and Locales-Footnote-21067118 +Ref: Ranges and Locales-Footnote-31067352 +Node: Contributors1067573 +Node: History summary1073035 +Node: Installation1074404 +Node: Gawk Distribution1075355 +Node: Getting1075839 +Node: Extracting1076663 +Node: Distribution contents1078305 +Node: Unix Installation1084022 +Node: Quick Installation1084639 +Node: Additional Configuration Options1087081 +Node: Configuration Philosophy1088819 +Node: Non-Unix Installation1091170 +Node: PC Installation1091628 +Node: PC Binary Installation1092939 +Node: PC Compiling1094787 +Ref: PC Compiling-Footnote-11097786 +Node: PC Testing1097891 +Node: PC Using1099067 +Node: Cygwin1103225 +Node: MSYS1104034 +Node: VMS Installation1104548 +Node: VMS Compilation1105344 +Ref: VMS Compilation-Footnote-11106566 +Node: VMS Dynamic Extensions1106624 +Node: VMS Installation Details1107997 +Node: VMS Running1110249 +Node: VMS GNV1113083 +Node: VMS Old Gawk1113806 +Node: Bugs1114276 +Node: Other Versions1118280 +Node: Installation summary1124535 +Node: Notes1125591 +Node: Compatibility Mode1126456 +Node: Additions1127238 +Node: Accessing The Source1128163 +Node: Adding Code1129599 +Node: New Ports1135777 +Node: Derived Files1140258 +Ref: Derived Files-Footnote-11145339 +Ref: Derived Files-Footnote-21145373 +Ref: Derived Files-Footnote-31145969 +Node: Future Extensions1146083 +Node: Implementation Limitations1146689 +Node: Extension Design1147937 +Node: Old Extension Problems1149091 +Ref: Old Extension Problems-Footnote-11150608 +Node: Extension New Mechanism Goals1150665 +Ref: Extension New Mechanism Goals-Footnote-11154025 +Node: Extension Other Design Decisions1154214 +Node: Extension Future Growth1156320 +Node: Old Extension Mechanism1157156 +Node: Notes summary1158918 +Node: Basic Concepts1160104 +Node: Basic High Level1160785 +Ref: figure-general-flow1161057 +Ref: figure-process-flow1161656 +Ref: Basic High Level-Footnote-11164885 +Node: Basic Data Typing1165070 +Node: Glossary1168398 +Node: Copying1193550 +Node: GNU Free Documentation License1231106 +Node: Index1256242 End Tag Table |