diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 775 |
1 files changed, 392 insertions, 383 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 1d5f496d..c54a3399 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -9768,9 +9768,18 @@ with a pound sign (`#'). 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. + 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 @@ -30928,9 +30937,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 93) +* dark corner, FILENAME variable <1>: Auto-set. (line 102) * dark corner, FILENAME variable: Getline Notes. (line 19) -* dark corner, FNR/NR variables: Auto-set. (line 314) +* dark corner, FNR/NR variables: Auto-set. (line 323) * dark corner, format-control characters: Control Letters. (line 18) * dark corner, FS as null string: Single Character Fields. (line 20) @@ -31114,12 +31123,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 73) +* 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 35) * differences in awk and gawk, FPAT variable: User-modified. (line 45) -* differences in awk and gawk, FUNCTAB variable: Auto-set. (line 119) +* differences in awk and gawk, FUNCTAB variable: Auto-set. (line 128) * differences in awk and gawk, function arguments (gawk): Calling Built-in. (line 16) * differences in awk and gawk, getline command: Getline. (line 19) @@ -31142,21 +31151,21 @@ Index (line 257) * differences in awk and gawk, print/printf statements: Format Modifiers. (line 13) -* differences in awk and gawk, PROCINFO array: Auto-set. (line 133) +* differences in awk and gawk, PROCINFO array: Auto-set. (line 142) * differences in awk and gawk, record separators: Records. (line 132) * differences in awk and gawk, regexp constants: Using Constant Regexps. (line 43) * differences in awk and gawk, regular expressions: Case-sensitivity. (line 26) * differences in awk and gawk, RS/RT variables: Records. (line 187) -* differences in awk and gawk, RT variable: Auto-set. (line 266) +* differences in awk and gawk, RT variable: Auto-set. (line 275) * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. (line 347) * differences in awk and gawk, strings: Scalar Constants. (line 20) * differences in awk and gawk, strings, storing: Records. (line 206) -* differences in awk and gawk, SYMTAB variable: Auto-set. (line 274) +* differences in awk and gawk, SYMTAB variable: Auto-set. (line 283) * differences in awk and gawk, TEXTDOMAIN variable: User-modified. (line 162) * differences in awk and gawk, trunc-mod operation: Arithmetic Ops. @@ -31197,8 +31206,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 138) -* effective user ID of gawk user: Auto-set. (line 142) +* effective group ID of gawk user: Auto-set. (line 147) +* effective user ID of gawk user: Auto-set. (line 151) * egrep utility <1>: Egrep Program. (line 6) * egrep utility: Bracket Expressions. (line 24) * egrep.awk program: Egrep Program. (line 54) @@ -31253,13 +31262,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 73) +* 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 138) * ERRNO variable, with getline command: Getline. (line 19) * error handling: Special FD. (line 16) -* error handling, ERRNO variable and: Auto-set. (line 73) +* 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) @@ -31313,7 +31322,7 @@ Index (line 6) * extension API version: Extension Versioning. (line 6) -* extension API, version number: Auto-set. (line 229) +* extension API, version number: Auto-set. (line 238) * extension example: Extension Example. (line 6) * extension registration: Registration Functions. (line 6) @@ -31393,7 +31402,7 @@ Index * file names, distinguishing: Auto-set. (line 52) * 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 93) +* FILENAME variable <1>: Auto-set. (line 102) * FILENAME variable: Reading Files. (line 6) * FILENAME variable, getline, setting with: Getline Notes. (line 19) * filenames, assignments as: Ignoring Assigns. (line 6) @@ -31463,9 +31472,9 @@ Index * flush buffered output: I/O Functions. (line 25) * fnmatch() extension function: Extension Sample Fnmatch. (line 12) -* FNR variable <1>: Auto-set. (line 103) +* FNR variable <1>: Auto-set. (line 112) * FNR variable: Records. (line 6) -* FNR variable, changing: Auto-set. (line 314) +* FNR variable, changing: Auto-set. (line 323) * for statement: For Statement. (line 6) * for statement, looping over arrays: Scanning an Array. (line 20) * fork() extension function: Extension Sample Fork. @@ -31515,7 +31524,7 @@ Index * FSF (Free Software Foundation): Manual History. (line 6) * fts() extension function: Extension Sample File Functions. (line 77) -* FUNCTAB array: Auto-set. (line 119) +* FUNCTAB array: Auto-set. (line 128) * function calls: Function Calls. (line 6) * function calls, indirect: Indirect Calls. (line 6) * function definition example: Function Example. (line 6) @@ -31565,7 +31574,7 @@ Index * G-d: Acknowledgments. (line 78) * Garfinkle, Scott: Contributors. (line 34) * gawk program, dynamic profiling: Profiling. (line 179) -* gawk version: Auto-set. (line 204) +* gawk version: Auto-set. (line 213) * gawk, ARGIND variable in: Other Arguments. (line 12) * gawk, awk and <1>: This Manual. (line 14) * gawk, awk and: Preface. (line 23) @@ -31586,7 +31595,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 73) +* 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 138) @@ -31603,7 +31612,7 @@ Index * gawk, FPAT variable in <1>: User-modified. (line 45) * gawk, FPAT variable in: Splitting By Content. (line 27) -* gawk, FUNCTAB array in: Auto-set. (line 119) +* gawk, FUNCTAB array in: Auto-set. (line 128) * 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. @@ -31634,7 +31643,7 @@ Index * gawk, OS/2 version of: PC Using. (line 10) * gawk, PROCINFO array in <1>: Two-way I/O. (line 116) * gawk, PROCINFO array in <2>: Time Functions. (line 47) -* gawk, PROCINFO array in: Auto-set. (line 133) +* gawk, PROCINFO array in: Auto-set. (line 142) * gawk, regexp constants and: Using Constant Regexps. (line 28) * gawk, regular expressions, case sensitivity: Case-sensitivity. @@ -31642,14 +31651,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 266) +* gawk, RT variable in <1>: Auto-set. (line 275) * gawk, RT variable in <2>: Multiple Line. (line 129) * gawk, RT variable in: Records. (line 132) * 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 274) +* gawk, SYMTAB array in: Auto-set. (line 283) * gawk, TEXTDOMAIN variable in: User-modified. (line 162) * gawk, timestamps: Time Functions. (line 6) * gawk, uses for: Preface. (line 36) @@ -31736,7 +31745,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 177) +* group ID of gawk user: Auto-set. (line 186) * groups, information about: Group Functions. (line 6) * gsub <1>: String Functions. (line 135) * gsub: Using Constant Regexps. @@ -32031,7 +32040,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 218) +* maximum precision supported by MPFR library: Auto-set. (line 227) * McPhee, Patrick: Contributors. (line 100) * message object files: Explaining gettext. (line 41) * message object files, converting from portable object files: I18N Example. @@ -32043,7 +32052,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 221) +* minimum precision supported by MPFR library: Auto-set. (line 230) * mktime: Time Functions. (line 25) * modifiers, in format specifiers: Format Modifiers. (line 6) * monetary information, localization: Explaining gettext. (line 103) @@ -32096,7 +32105,7 @@ Index (line 47) * nexti debugger command: Debugger Execution Control. (line 49) -* NF variable <1>: Auto-set. (line 108) +* NF variable <1>: Auto-set. (line 117) * NF variable: Fields. (line 33) * NF variable, decrementing: Changing Fields. (line 107) * ni debugger command (alias for nexti): Debugger Execution Control. @@ -32105,9 +32114,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 128) +* NR variable <1>: Auto-set. (line 137) * NR variable: Records. (line 6) -* NR variable, changing: Auto-set. (line 314) +* NR variable, changing: Auto-set. (line 323) * null strings <1>: Basic Data Typing. (line 26) * null strings <2>: Truth Values. (line 6) * null strings <3>: Regexp Field Splitting. @@ -32222,7 +32231,7 @@ Index * p debugger command (alias for print): Viewing And Changing Data. (line 36) * P1003.1 POSIX standard: Glossary. (line 454) -* parent process ID of gawk process: Auto-set. (line 186) +* parent process ID of gawk process: Auto-set. (line 195) * parentheses (), in a profile: Profiling. (line 146) * parentheses (), regexp operator: Regexp Operators. (line 80) * password file: Passwd Functions. (line 16) @@ -32386,24 +32395,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 180) -* process ID of gawk process: Auto-set. (line 183) +* process group idIDof gawk process: Auto-set. (line 189) +* process ID of gawk process: Auto-set. (line 192) * 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 133) +* PROCINFO array: Auto-set. (line 142) * PROCINFO array, and communications via ptys: Two-way I/O. (line 116) * 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 239) +* PROCINFO array, uses: Auto-set. (line 248) * PROCINFO, values of sorted_in: Controlling Scanning. (line 24) * profiling awk programs: Profiling. (line 6) * profiling awk programs, dynamically: Profiling. (line 179) -* program identifiers: Auto-set. (line 151) +* program identifiers: Auto-set. (line 160) * program, definition of: Getting Started. (line 21) * programmers, attractiveness of: Two-way I/O. (line 6) * programming conventions, --non-decimal-data option: Nondecimal Data. @@ -32561,7 +32570,7 @@ Index * right shift: Bitwise Functions. (line 52) * right shift, bitwise: Bitwise Functions. (line 32) * Ritchie, Dennis: Basic Data Typing. (line 55) -* RLENGTH variable: Auto-set. (line 253) +* RLENGTH variable: Auto-set. (line 262) * RLENGTH variable, match() function and: String Functions. (line 221) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) @@ -32590,9 +32599,9 @@ Index * RS variable: Records. (line 20) * RS variable, multiline records and: Multiple Line. (line 17) * rshift: Bitwise Functions. (line 52) -* RSTART variable: Auto-set. (line 259) +* RSTART variable: Auto-set. (line 268) * RSTART variable, match() function and: String Functions. (line 221) -* RT variable <1>: Auto-set. (line 266) +* RT variable <1>: Auto-set. (line 275) * RT variable <2>: Multiple Line. (line 129) * RT variable: Records. (line 132) * Rubin, Paul <1>: Contributors. (line 15) @@ -32698,7 +32707,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 312) +* sidebar, Changing NR and FNR: Auto-set. (line 321) * sidebar, Controlling Output Buffering with system(): I/O Functions. (line 135) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. @@ -32860,9 +32869,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 234) +* supplementary groups of gawk process: Auto-set. (line 243) * switch statement: Switch Statement. (line 6) -* SYMTAB array: Auto-set. (line 274) +* SYMTAB array: Auto-set. (line 283) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. (line 147) * system: I/O Functions. (line 72) @@ -33041,10 +33050,10 @@ Index * variables, uninitialized, as array subscripts: Uninitialized Subscripts. (line 6) * variables, user-defined: Variables. (line 6) -* version of gawk: Auto-set. (line 204) -* version of gawk extension API: Auto-set. (line 229) -* version of GNU MP library: Auto-set. (line 215) -* version of GNU MPFR library: Auto-set. (line 211) +* version of gawk: Auto-set. (line 213) +* version of gawk extension API: Auto-set. (line 238) +* version of GNU MP library: Auto-set. (line 224) +* version of GNU MPFR library: Auto-set. (line 220) * vertical bar (|): Regexp Operators. (line 70) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 65) * vertical bar (|), | operator (I/O): Getline/Pipe. (line 9) @@ -33320,341 +33329,341 @@ Node: Built-in Variables406516 Node: User-modified407611 Ref: User-modified-Footnote-1415969 Node: Auto-set416031 -Ref: Auto-set-Footnote-1429098 -Ref: Auto-set-Footnote-2429303 -Node: ARGC and ARGV429359 -Node: Arrays433213 -Node: Array Basics434718 -Node: Array Intro435544 -Node: Reference to Elements439861 -Node: Assigning Elements442131 -Node: Array Example442622 -Node: Scanning an Array444354 -Node: Controlling Scanning446668 -Ref: Controlling Scanning-Footnote-1451755 -Node: Delete452071 -Ref: Delete-Footnote-1454836 -Node: Numeric Array Subscripts454893 -Node: Uninitialized Subscripts457076 -Node: Multidimensional458703 -Node: Multiscanning461796 -Node: Arrays of Arrays463385 -Node: Functions468025 -Node: Built-in468844 -Node: Calling Built-in469922 -Node: Numeric Functions471910 -Ref: Numeric Functions-Footnote-1475744 -Ref: Numeric Functions-Footnote-2476101 -Ref: Numeric Functions-Footnote-3476149 -Node: String Functions476418 -Ref: String Functions-Footnote-1499421 -Ref: String Functions-Footnote-2499550 -Ref: String Functions-Footnote-3499798 -Node: Gory Details499885 -Ref: table-sub-escapes501564 -Ref: table-sub-posix-92502918 -Ref: table-sub-proposed504269 -Ref: table-posix-sub505623 -Ref: table-gensub-escapes507168 -Ref: Gory Details-Footnote-1508344 -Ref: Gory Details-Footnote-2508395 -Node: I/O Functions508546 -Ref: I/O Functions-Footnote-1515542 -Node: Time Functions515689 -Ref: Time Functions-Footnote-1526682 -Ref: Time Functions-Footnote-2526750 -Ref: Time Functions-Footnote-3526908 -Ref: Time Functions-Footnote-4527019 -Ref: Time Functions-Footnote-5527131 -Ref: Time Functions-Footnote-6527358 -Node: Bitwise Functions527624 -Ref: table-bitwise-ops528186 -Ref: Bitwise Functions-Footnote-1532431 -Node: Type Functions532615 -Node: I18N Functions533766 -Node: User-defined535418 -Node: Definition Syntax536222 -Ref: Definition Syntax-Footnote-1541136 -Node: Function Example541205 -Ref: Function Example-Footnote-1543854 -Node: Function Caveats543876 -Node: Calling A Function544394 -Node: Variable Scope545349 -Node: Pass By Value/Reference548312 -Node: Return Statement551820 -Node: Dynamic Typing554801 -Node: Indirect Calls555732 -Node: Library Functions565419 -Ref: Library Functions-Footnote-1568932 -Ref: Library Functions-Footnote-2569075 -Node: Library Names569246 -Ref: Library Names-Footnote-1572719 -Ref: Library Names-Footnote-2572939 -Node: General Functions573025 -Node: Strtonum Function574053 -Node: Assert Function576983 -Node: Round Function580309 -Node: Cliff Random Function581850 -Node: Ordinal Functions582866 -Ref: Ordinal Functions-Footnote-1585943 -Ref: Ordinal Functions-Footnote-2586195 -Node: Join Function586406 -Ref: Join Function-Footnote-1588177 -Node: Getlocaltime Function588377 -Node: Readfile Function592118 -Node: Data File Management593957 -Node: Filetrans Function594589 -Node: Rewind Function598658 -Node: File Checking600045 -Node: Empty Files601139 -Node: Ignoring Assigns603369 -Node: Getopt Function604923 -Ref: Getopt Function-Footnote-1616226 -Node: Passwd Functions616429 -Ref: Passwd Functions-Footnote-1625407 -Node: Group Functions625495 -Node: Walking Arrays633579 -Node: Sample Programs635715 -Node: Running Examples636389 -Node: Clones637117 -Node: Cut Program638341 -Node: Egrep Program648192 -Ref: Egrep Program-Footnote-1655965 -Node: Id Program656075 -Node: Split Program659724 -Ref: Split Program-Footnote-1663243 -Node: Tee Program663371 -Node: Uniq Program666174 -Node: Wc Program673603 -Ref: Wc Program-Footnote-1677869 -Ref: Wc Program-Footnote-2678069 -Node: Miscellaneous Programs678161 -Node: Dupword Program679349 -Node: Alarm Program681380 -Node: Translate Program686187 -Ref: Translate Program-Footnote-1690574 -Ref: Translate Program-Footnote-2690822 -Node: Labels Program690956 -Ref: Labels Program-Footnote-1694327 -Node: Word Sorting694411 -Node: History Sorting698295 -Node: Extract Program700134 -Ref: Extract Program-Footnote-1707637 -Node: Simple Sed707765 -Node: Igawk Program710827 -Ref: Igawk Program-Footnote-1725998 -Ref: Igawk Program-Footnote-2726199 -Node: Anagram Program726337 -Node: Signature Program729405 -Node: Advanced Features730505 -Node: Nondecimal Data732391 -Node: Array Sorting733974 -Node: Controlling Array Traversal734671 -Node: Array Sorting Functions742955 -Ref: Array Sorting Functions-Footnote-1746824 -Node: Two-way I/O747018 -Ref: Two-way I/O-Footnote-1752450 -Node: TCP/IP Networking752532 -Node: Profiling755376 -Node: Internationalization762879 -Node: I18N and L10N764304 -Node: Explaining gettext764990 -Ref: Explaining gettext-Footnote-1770058 -Ref: Explaining gettext-Footnote-2770242 -Node: Programmer i18n770407 -Node: Translator i18n774634 -Node: String Extraction775428 -Ref: String Extraction-Footnote-1776389 -Node: Printf Ordering776475 -Ref: Printf Ordering-Footnote-1779257 -Node: I18N Portability779321 -Ref: I18N Portability-Footnote-1781770 -Node: I18N Example781833 -Ref: I18N Example-Footnote-1784471 -Node: Gawk I18N784543 -Node: Debugger785164 -Node: Debugging786135 -Node: Debugging Concepts786568 -Node: Debugging Terms788424 -Node: Awk Debugging791021 -Node: Sample Debugging Session791913 -Node: Debugger Invocation792433 -Node: Finding The Bug793766 -Node: List of Debugger Commands800253 -Node: Breakpoint Control801587 -Node: Debugger Execution Control805251 -Node: Viewing And Changing Data808611 -Node: Execution Stack811967 -Node: Debugger Info813434 -Node: Miscellaneous Debugger Commands817428 -Node: Readline Support822606 -Node: Limitations823437 -Node: Arbitrary Precision Arithmetic825689 -Ref: Arbitrary Precision Arithmetic-Footnote-1827338 -Node: General Arithmetic827486 -Node: Floating Point Issues829206 -Node: String Conversion Precision830087 -Ref: String Conversion Precision-Footnote-1831792 -Node: Unexpected Results831901 -Node: POSIX Floating Point Problems834054 -Ref: POSIX Floating Point Problems-Footnote-1837879 -Node: Integer Programming837917 -Node: Floating-point Programming839656 -Ref: Floating-point Programming-Footnote-1845987 -Ref: Floating-point Programming-Footnote-2846257 -Node: Floating-point Representation846521 -Node: Floating-point Context847686 -Ref: table-ieee-formats848525 -Node: Rounding Mode849909 -Ref: table-rounding-modes850388 -Ref: Rounding Mode-Footnote-1853403 -Node: Gawk and MPFR853582 -Node: Arbitrary Precision Floats854991 -Ref: Arbitrary Precision Floats-Footnote-1857434 -Node: Setting Precision857750 -Ref: table-predefined-precision-strings858436 -Node: Setting Rounding Mode860581 -Ref: table-gawk-rounding-modes860985 -Node: Floating-point Constants862172 -Node: Changing Precision863601 -Ref: Changing Precision-Footnote-1864998 -Node: Exact Arithmetic865172 -Node: Arbitrary Precision Integers868310 -Ref: Arbitrary Precision Integers-Footnote-1871325 -Node: Dynamic Extensions871472 -Node: Extension Intro872930 -Node: Plugin License874195 -Node: Extension Mechanism Outline874880 -Ref: load-extension875297 -Ref: load-new-function876775 -Ref: call-new-function877770 -Node: Extension API Description879785 -Node: Extension API Functions Introduction881072 -Node: General Data Types885999 -Ref: General Data Types-Footnote-1891694 -Node: Requesting Values891993 -Ref: table-value-types-returned892730 -Node: Memory Allocation Functions893684 -Ref: Memory Allocation Functions-Footnote-1896430 -Node: Constructor Functions896526 -Node: Registration Functions898284 -Node: Extension Functions898969 -Node: Exit Callback Functions901271 -Node: Extension Version String902520 -Node: Input Parsers903170 -Node: Output Wrappers912927 -Node: Two-way processors917437 -Node: Printing Messages919645 -Ref: Printing Messages-Footnote-1920722 -Node: Updating `ERRNO'920874 -Node: Accessing Parameters921613 -Node: Symbol Table Access922843 -Node: Symbol table by name923357 -Node: Symbol table by cookie925333 -Ref: Symbol table by cookie-Footnote-1929465 -Node: Cached values929528 -Ref: Cached values-Footnote-1933018 -Node: Array Manipulation933109 -Ref: Array Manipulation-Footnote-1934207 -Node: Array Data Types934246 -Ref: Array Data Types-Footnote-1936949 -Node: Array Functions937041 -Node: Flattening Arrays940877 -Node: Creating Arrays947729 -Node: Extension API Variables952454 -Node: Extension Versioning953090 -Node: Extension API Informational Variables954991 -Node: Extension API Boilerplate956077 -Node: Finding Extensions959881 -Node: Extension Example960441 -Node: Internal File Description961171 -Node: Internal File Ops965262 -Ref: Internal File Ops-Footnote-1976771 -Node: Using Internal File Ops976911 -Ref: Using Internal File Ops-Footnote-1979258 -Node: Extension Samples979524 -Node: Extension Sample File Functions981048 -Node: Extension Sample Fnmatch989535 -Node: Extension Sample Fork991304 -Node: Extension Sample Inplace992517 -Node: Extension Sample Ord994295 -Node: Extension Sample Readdir995131 -Node: Extension Sample Revout996663 -Node: Extension Sample Rev2way997256 -Node: Extension Sample Read write array997946 -Node: Extension Sample Readfile999829 -Node: Extension Sample API Tests1000929 -Node: Extension Sample Time1001454 -Node: gawkextlib1002818 -Node: Language History1005599 -Node: V7/SVR3.11007192 -Node: SVR41009512 -Node: POSIX1010954 -Node: BTL1012340 -Node: POSIX/GNU1013074 -Node: Feature History1018673 -Node: Common Extensions1031649 -Node: Ranges and Locales1032961 -Ref: Ranges and Locales-Footnote-11037578 -Ref: Ranges and Locales-Footnote-21037605 -Ref: Ranges and Locales-Footnote-31037839 -Node: Contributors1038060 -Node: Installation1043441 -Node: Gawk Distribution1044335 -Node: Getting1044819 -Node: Extracting1045645 -Node: Distribution contents1047337 -Node: Unix Installation1053058 -Node: Quick Installation1053675 -Node: Additional Configuration Options1056121 -Node: Configuration Philosophy1057857 -Node: Non-Unix Installation1060211 -Node: PC Installation1060669 -Node: PC Binary Installation1061968 -Node: PC Compiling1063816 -Node: PC Testing1066760 -Node: PC Using1067936 -Node: Cygwin1072104 -Node: MSYS1072913 -Node: VMS Installation1073427 -Node: VMS Compilation1074223 -Ref: VMS Compilation-Footnote-11075475 -Node: VMS Dynamic Extensions1075533 -Node: VMS Installation Details1076906 -Node: VMS Running1079157 -Node: VMS GNV1081991 -Node: VMS Old Gawk1082714 -Node: Bugs1083184 -Node: Other Versions1087102 -Node: Notes1093186 -Node: Compatibility Mode1093986 -Node: Additions1094769 -Node: Accessing The Source1095696 -Node: Adding Code1097136 -Node: New Ports1103181 -Node: Derived Files1107316 -Ref: Derived Files-Footnote-11112637 -Ref: Derived Files-Footnote-21112671 -Ref: Derived Files-Footnote-31113271 -Node: Future Extensions1113369 -Node: Implementation Limitations1113952 -Node: Extension Design1115204 -Node: Old Extension Problems1116358 -Ref: Old Extension Problems-Footnote-11117866 -Node: Extension New Mechanism Goals1117923 -Ref: Extension New Mechanism Goals-Footnote-11121288 -Node: Extension Other Design Decisions1121474 -Node: Extension Future Growth1123580 -Node: Old Extension Mechanism1124416 -Node: Basic Concepts1126156 -Node: Basic High Level1126837 -Ref: figure-general-flow1127109 -Ref: figure-process-flow1127708 -Ref: Basic High Level-Footnote-11130937 -Node: Basic Data Typing1131122 -Node: Glossary1134477 -Node: Copying1159708 -Node: GNU Free Documentation License1197264 -Node: Index1222400 +Ref: Auto-set-Footnote-1429490 +Ref: Auto-set-Footnote-2429695 +Node: ARGC and ARGV429751 +Node: Arrays433605 +Node: Array Basics435110 +Node: Array Intro435936 +Node: Reference to Elements440253 +Node: Assigning Elements442523 +Node: Array Example443014 +Node: Scanning an Array444746 +Node: Controlling Scanning447060 +Ref: Controlling Scanning-Footnote-1452147 +Node: Delete452463 +Ref: Delete-Footnote-1455228 +Node: Numeric Array Subscripts455285 +Node: Uninitialized Subscripts457468 +Node: Multidimensional459095 +Node: Multiscanning462188 +Node: Arrays of Arrays463777 +Node: Functions468417 +Node: Built-in469236 +Node: Calling Built-in470314 +Node: Numeric Functions472302 +Ref: Numeric Functions-Footnote-1476136 +Ref: Numeric Functions-Footnote-2476493 +Ref: Numeric Functions-Footnote-3476541 +Node: String Functions476810 +Ref: String Functions-Footnote-1499813 +Ref: String Functions-Footnote-2499942 +Ref: String Functions-Footnote-3500190 +Node: Gory Details500277 +Ref: table-sub-escapes501956 +Ref: table-sub-posix-92503310 +Ref: table-sub-proposed504661 +Ref: table-posix-sub506015 +Ref: table-gensub-escapes507560 +Ref: Gory Details-Footnote-1508736 +Ref: Gory Details-Footnote-2508787 +Node: I/O Functions508938 +Ref: I/O Functions-Footnote-1515934 +Node: Time Functions516081 +Ref: Time Functions-Footnote-1527074 +Ref: Time Functions-Footnote-2527142 +Ref: Time Functions-Footnote-3527300 +Ref: Time Functions-Footnote-4527411 +Ref: Time Functions-Footnote-5527523 +Ref: Time Functions-Footnote-6527750 +Node: Bitwise Functions528016 +Ref: table-bitwise-ops528578 +Ref: Bitwise Functions-Footnote-1532823 +Node: Type Functions533007 +Node: I18N Functions534158 +Node: User-defined535810 +Node: Definition Syntax536614 +Ref: Definition Syntax-Footnote-1541528 +Node: Function Example541597 +Ref: Function Example-Footnote-1544246 +Node: Function Caveats544268 +Node: Calling A Function544786 +Node: Variable Scope545741 +Node: Pass By Value/Reference548704 +Node: Return Statement552212 +Node: Dynamic Typing555193 +Node: Indirect Calls556124 +Node: Library Functions565811 +Ref: Library Functions-Footnote-1569324 +Ref: Library Functions-Footnote-2569467 +Node: Library Names569638 +Ref: Library Names-Footnote-1573111 +Ref: Library Names-Footnote-2573331 +Node: General Functions573417 +Node: Strtonum Function574445 +Node: Assert Function577375 +Node: Round Function580701 +Node: Cliff Random Function582242 +Node: Ordinal Functions583258 +Ref: Ordinal Functions-Footnote-1586335 +Ref: Ordinal Functions-Footnote-2586587 +Node: Join Function586798 +Ref: Join Function-Footnote-1588569 +Node: Getlocaltime Function588769 +Node: Readfile Function592510 +Node: Data File Management594349 +Node: Filetrans Function594981 +Node: Rewind Function599050 +Node: File Checking600437 +Node: Empty Files601531 +Node: Ignoring Assigns603761 +Node: Getopt Function605315 +Ref: Getopt Function-Footnote-1616618 +Node: Passwd Functions616821 +Ref: Passwd Functions-Footnote-1625799 +Node: Group Functions625887 +Node: Walking Arrays633971 +Node: Sample Programs636107 +Node: Running Examples636781 +Node: Clones637509 +Node: Cut Program638733 +Node: Egrep Program648584 +Ref: Egrep Program-Footnote-1656357 +Node: Id Program656467 +Node: Split Program660116 +Ref: Split Program-Footnote-1663635 +Node: Tee Program663763 +Node: Uniq Program666566 +Node: Wc Program673995 +Ref: Wc Program-Footnote-1678261 +Ref: Wc Program-Footnote-2678461 +Node: Miscellaneous Programs678553 +Node: Dupword Program679741 +Node: Alarm Program681772 +Node: Translate Program686579 +Ref: Translate Program-Footnote-1690966 +Ref: Translate Program-Footnote-2691214 +Node: Labels Program691348 +Ref: Labels Program-Footnote-1694719 +Node: Word Sorting694803 +Node: History Sorting698687 +Node: Extract Program700526 +Ref: Extract Program-Footnote-1708029 +Node: Simple Sed708157 +Node: Igawk Program711219 +Ref: Igawk Program-Footnote-1726390 +Ref: Igawk Program-Footnote-2726591 +Node: Anagram Program726729 +Node: Signature Program729797 +Node: Advanced Features730897 +Node: Nondecimal Data732783 +Node: Array Sorting734366 +Node: Controlling Array Traversal735063 +Node: Array Sorting Functions743347 +Ref: Array Sorting Functions-Footnote-1747216 +Node: Two-way I/O747410 +Ref: Two-way I/O-Footnote-1752842 +Node: TCP/IP Networking752924 +Node: Profiling755768 +Node: Internationalization763271 +Node: I18N and L10N764696 +Node: Explaining gettext765382 +Ref: Explaining gettext-Footnote-1770450 +Ref: Explaining gettext-Footnote-2770634 +Node: Programmer i18n770799 +Node: Translator i18n775026 +Node: String Extraction775820 +Ref: String Extraction-Footnote-1776781 +Node: Printf Ordering776867 +Ref: Printf Ordering-Footnote-1779649 +Node: I18N Portability779713 +Ref: I18N Portability-Footnote-1782162 +Node: I18N Example782225 +Ref: I18N Example-Footnote-1784863 +Node: Gawk I18N784935 +Node: Debugger785556 +Node: Debugging786527 +Node: Debugging Concepts786960 +Node: Debugging Terms788816 +Node: Awk Debugging791413 +Node: Sample Debugging Session792305 +Node: Debugger Invocation792825 +Node: Finding The Bug794158 +Node: List of Debugger Commands800645 +Node: Breakpoint Control801979 +Node: Debugger Execution Control805643 +Node: Viewing And Changing Data809003 +Node: Execution Stack812359 +Node: Debugger Info813826 +Node: Miscellaneous Debugger Commands817820 +Node: Readline Support822998 +Node: Limitations823829 +Node: Arbitrary Precision Arithmetic826081 +Ref: Arbitrary Precision Arithmetic-Footnote-1827730 +Node: General Arithmetic827878 +Node: Floating Point Issues829598 +Node: String Conversion Precision830479 +Ref: String Conversion Precision-Footnote-1832184 +Node: Unexpected Results832293 +Node: POSIX Floating Point Problems834446 +Ref: POSIX Floating Point Problems-Footnote-1838271 +Node: Integer Programming838309 +Node: Floating-point Programming840048 +Ref: Floating-point Programming-Footnote-1846379 +Ref: Floating-point Programming-Footnote-2846649 +Node: Floating-point Representation846913 +Node: Floating-point Context848078 +Ref: table-ieee-formats848917 +Node: Rounding Mode850301 +Ref: table-rounding-modes850780 +Ref: Rounding Mode-Footnote-1853795 +Node: Gawk and MPFR853974 +Node: Arbitrary Precision Floats855383 +Ref: Arbitrary Precision Floats-Footnote-1857826 +Node: Setting Precision858142 +Ref: table-predefined-precision-strings858828 +Node: Setting Rounding Mode860973 +Ref: table-gawk-rounding-modes861377 +Node: Floating-point Constants862564 +Node: Changing Precision863993 +Ref: Changing Precision-Footnote-1865390 +Node: Exact Arithmetic865564 +Node: Arbitrary Precision Integers868702 +Ref: Arbitrary Precision Integers-Footnote-1871717 +Node: Dynamic Extensions871864 +Node: Extension Intro873322 +Node: Plugin License874587 +Node: Extension Mechanism Outline875272 +Ref: load-extension875689 +Ref: load-new-function877167 +Ref: call-new-function878162 +Node: Extension API Description880177 +Node: Extension API Functions Introduction881464 +Node: General Data Types886391 +Ref: General Data Types-Footnote-1892086 +Node: Requesting Values892385 +Ref: table-value-types-returned893122 +Node: Memory Allocation Functions894076 +Ref: Memory Allocation Functions-Footnote-1896822 +Node: Constructor Functions896918 +Node: Registration Functions898676 +Node: Extension Functions899361 +Node: Exit Callback Functions901663 +Node: Extension Version String902912 +Node: Input Parsers903562 +Node: Output Wrappers913319 +Node: Two-way processors917829 +Node: Printing Messages920037 +Ref: Printing Messages-Footnote-1921114 +Node: Updating `ERRNO'921266 +Node: Accessing Parameters922005 +Node: Symbol Table Access923235 +Node: Symbol table by name923749 +Node: Symbol table by cookie925725 +Ref: Symbol table by cookie-Footnote-1929857 +Node: Cached values929920 +Ref: Cached values-Footnote-1933410 +Node: Array Manipulation933501 +Ref: Array Manipulation-Footnote-1934599 +Node: Array Data Types934638 +Ref: Array Data Types-Footnote-1937341 +Node: Array Functions937433 +Node: Flattening Arrays941269 +Node: Creating Arrays948121 +Node: Extension API Variables952846 +Node: Extension Versioning953482 +Node: Extension API Informational Variables955383 +Node: Extension API Boilerplate956469 +Node: Finding Extensions960273 +Node: Extension Example960833 +Node: Internal File Description961563 +Node: Internal File Ops965654 +Ref: Internal File Ops-Footnote-1977163 +Node: Using Internal File Ops977303 +Ref: Using Internal File Ops-Footnote-1979650 +Node: Extension Samples979916 +Node: Extension Sample File Functions981440 +Node: Extension Sample Fnmatch989927 +Node: Extension Sample Fork991696 +Node: Extension Sample Inplace992909 +Node: Extension Sample Ord994687 +Node: Extension Sample Readdir995523 +Node: Extension Sample Revout997055 +Node: Extension Sample Rev2way997648 +Node: Extension Sample Read write array998338 +Node: Extension Sample Readfile1000221 +Node: Extension Sample API Tests1001321 +Node: Extension Sample Time1001846 +Node: gawkextlib1003210 +Node: Language History1005991 +Node: V7/SVR3.11007584 +Node: SVR41009904 +Node: POSIX1011346 +Node: BTL1012732 +Node: POSIX/GNU1013466 +Node: Feature History1019065 +Node: Common Extensions1032041 +Node: Ranges and Locales1033353 +Ref: Ranges and Locales-Footnote-11037970 +Ref: Ranges and Locales-Footnote-21037997 +Ref: Ranges and Locales-Footnote-31038231 +Node: Contributors1038452 +Node: Installation1043833 +Node: Gawk Distribution1044727 +Node: Getting1045211 +Node: Extracting1046037 +Node: Distribution contents1047729 +Node: Unix Installation1053450 +Node: Quick Installation1054067 +Node: Additional Configuration Options1056513 +Node: Configuration Philosophy1058249 +Node: Non-Unix Installation1060603 +Node: PC Installation1061061 +Node: PC Binary Installation1062360 +Node: PC Compiling1064208 +Node: PC Testing1067152 +Node: PC Using1068328 +Node: Cygwin1072496 +Node: MSYS1073305 +Node: VMS Installation1073819 +Node: VMS Compilation1074615 +Ref: VMS Compilation-Footnote-11075867 +Node: VMS Dynamic Extensions1075925 +Node: VMS Installation Details1077298 +Node: VMS Running1079549 +Node: VMS GNV1082383 +Node: VMS Old Gawk1083106 +Node: Bugs1083576 +Node: Other Versions1087494 +Node: Notes1093578 +Node: Compatibility Mode1094378 +Node: Additions1095161 +Node: Accessing The Source1096088 +Node: Adding Code1097528 +Node: New Ports1103573 +Node: Derived Files1107708 +Ref: Derived Files-Footnote-11113029 +Ref: Derived Files-Footnote-21113063 +Ref: Derived Files-Footnote-31113663 +Node: Future Extensions1113761 +Node: Implementation Limitations1114344 +Node: Extension Design1115596 +Node: Old Extension Problems1116750 +Ref: Old Extension Problems-Footnote-11118258 +Node: Extension New Mechanism Goals1118315 +Ref: Extension New Mechanism Goals-Footnote-11121680 +Node: Extension Other Design Decisions1121866 +Node: Extension Future Growth1123972 +Node: Old Extension Mechanism1124808 +Node: Basic Concepts1126548 +Node: Basic High Level1127229 +Ref: figure-general-flow1127501 +Ref: figure-process-flow1128100 +Ref: Basic High Level-Footnote-11131329 +Node: Basic Data Typing1131514 +Node: Glossary1134869 +Node: Copying1160100 +Node: GNU Free Documentation License1197656 +Node: Index1222792 End Tag Table |