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 8c13d181..dc0a7591 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -9809,9 +9809,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 @@ -30969,9 +30978,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) @@ -31155,12 +31164,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) @@ -31183,7 +31192,7 @@ 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, read timeouts: Read Timeout. (line 6) * differences in awk and gawk, record separators: awk split records. (line 124) @@ -31193,7 +31202,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 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. @@ -31201,7 +31210,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 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. @@ -31242,8 +31251,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) @@ -31298,13 +31307,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 139) * 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) @@ -31358,7 +31367,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) @@ -31437,7 +31446,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) @@ -31507,9 +31516,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. @@ -31559,7 +31568,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) @@ -31609,7 +31618,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) @@ -31630,7 +31639,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 139) @@ -31647,7 +31656,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. @@ -31678,7 +31687,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. @@ -31686,14 +31695,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: 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 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) @@ -31780,7 +31789,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. @@ -32075,7 +32084,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. @@ -32087,7 +32096,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) @@ -32141,7 +32150,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. @@ -32150,9 +32159,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. @@ -32267,7 +32276,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) @@ -32432,24 +32441,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. @@ -32609,7 +32618,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) @@ -32638,9 +32647,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 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: awk split records. (line 124) * Rubin, Paul <1>: Contributors. (line 15) @@ -32747,7 +32756,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. @@ -32909,9 +32918,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 148) * system: I/O Functions. (line 72) @@ -33090,10 +33099,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) @@ -33372,341 +33381,341 @@ Node: Built-in Variables408274 Node: User-modified409369 Ref: User-modified-Footnote-1417727 Node: Auto-set417789 -Ref: Auto-set-Footnote-1430856 -Ref: Auto-set-Footnote-2431061 -Node: ARGC and ARGV431117 -Node: Arrays434971 -Node: Array Basics436476 -Node: Array Intro437302 -Node: Reference to Elements441619 -Node: Assigning Elements443889 -Node: Array Example444380 -Node: Scanning an Array446112 -Node: Controlling Scanning448426 -Ref: Controlling Scanning-Footnote-1453513 -Node: Delete453829 -Ref: Delete-Footnote-1456594 -Node: Numeric Array Subscripts456651 -Node: Uninitialized Subscripts458834 -Node: Multidimensional460461 -Node: Multiscanning463554 -Node: Arrays of Arrays465143 -Node: Functions469783 -Node: Built-in470602 -Node: Calling Built-in471680 -Node: Numeric Functions473668 -Ref: Numeric Functions-Footnote-1477502 -Ref: Numeric Functions-Footnote-2477859 -Ref: Numeric Functions-Footnote-3477907 -Node: String Functions478176 -Ref: String Functions-Footnote-1501179 -Ref: String Functions-Footnote-2501308 -Ref: String Functions-Footnote-3501556 -Node: Gory Details501643 -Ref: table-sub-escapes503322 -Ref: table-sub-posix-92504676 -Ref: table-sub-proposed506027 -Ref: table-posix-sub507381 -Ref: table-gensub-escapes508926 -Ref: Gory Details-Footnote-1510102 -Ref: Gory Details-Footnote-2510153 -Node: I/O Functions510304 -Ref: I/O Functions-Footnote-1517300 -Node: Time Functions517447 -Ref: Time Functions-Footnote-1528440 -Ref: Time Functions-Footnote-2528508 -Ref: Time Functions-Footnote-3528666 -Ref: Time Functions-Footnote-4528777 -Ref: Time Functions-Footnote-5528889 -Ref: Time Functions-Footnote-6529116 -Node: Bitwise Functions529382 -Ref: table-bitwise-ops529944 -Ref: Bitwise Functions-Footnote-1534189 -Node: Type Functions534373 -Node: I18N Functions535524 -Node: User-defined537176 -Node: Definition Syntax537980 -Ref: Definition Syntax-Footnote-1542894 -Node: Function Example542963 -Ref: Function Example-Footnote-1545612 -Node: Function Caveats545634 -Node: Calling A Function546152 -Node: Variable Scope547107 -Node: Pass By Value/Reference550070 -Node: Return Statement553578 -Node: Dynamic Typing556559 -Node: Indirect Calls557490 -Node: Library Functions567177 -Ref: Library Functions-Footnote-1570690 -Ref: Library Functions-Footnote-2570833 -Node: Library Names571004 -Ref: Library Names-Footnote-1574477 -Ref: Library Names-Footnote-2574697 -Node: General Functions574783 -Node: Strtonum Function575811 -Node: Assert Function578741 -Node: Round Function582067 -Node: Cliff Random Function583608 -Node: Ordinal Functions584624 -Ref: Ordinal Functions-Footnote-1587701 -Ref: Ordinal Functions-Footnote-2587953 -Node: Join Function588164 -Ref: Join Function-Footnote-1589935 -Node: Getlocaltime Function590135 -Node: Readfile Function593876 -Node: Data File Management595715 -Node: Filetrans Function596347 -Node: Rewind Function600416 -Node: File Checking601803 -Node: Empty Files602897 -Node: Ignoring Assigns605127 -Node: Getopt Function606681 -Ref: Getopt Function-Footnote-1617984 -Node: Passwd Functions618187 -Ref: Passwd Functions-Footnote-1627165 -Node: Group Functions627253 -Node: Walking Arrays635337 -Node: Sample Programs637473 -Node: Running Examples638147 -Node: Clones638875 -Node: Cut Program640099 -Node: Egrep Program649950 -Ref: Egrep Program-Footnote-1657723 -Node: Id Program657833 -Node: Split Program661482 -Ref: Split Program-Footnote-1665001 -Node: Tee Program665129 -Node: Uniq Program667932 -Node: Wc Program675361 -Ref: Wc Program-Footnote-1679627 -Ref: Wc Program-Footnote-2679827 -Node: Miscellaneous Programs679919 -Node: Dupword Program681107 -Node: Alarm Program683138 -Node: Translate Program687945 -Ref: Translate Program-Footnote-1692332 -Ref: Translate Program-Footnote-2692580 -Node: Labels Program692714 -Ref: Labels Program-Footnote-1696085 -Node: Word Sorting696169 -Node: History Sorting700053 -Node: Extract Program701892 -Ref: Extract Program-Footnote-1709395 -Node: Simple Sed709523 -Node: Igawk Program712585 -Ref: Igawk Program-Footnote-1727756 -Ref: Igawk Program-Footnote-2727957 -Node: Anagram Program728095 -Node: Signature Program731163 -Node: Advanced Features732263 -Node: Nondecimal Data734149 -Node: Array Sorting735732 -Node: Controlling Array Traversal736429 -Node: Array Sorting Functions744713 -Ref: Array Sorting Functions-Footnote-1748582 -Node: Two-way I/O748776 -Ref: Two-way I/O-Footnote-1754208 -Node: TCP/IP Networking754290 -Node: Profiling757134 -Node: Internationalization764637 -Node: I18N and L10N766062 -Node: Explaining gettext766748 -Ref: Explaining gettext-Footnote-1771816 -Ref: Explaining gettext-Footnote-2772000 -Node: Programmer i18n772165 -Node: Translator i18n776392 -Node: String Extraction777186 -Ref: String Extraction-Footnote-1778147 -Node: Printf Ordering778233 -Ref: Printf Ordering-Footnote-1781015 -Node: I18N Portability781079 -Ref: I18N Portability-Footnote-1783528 -Node: I18N Example783591 -Ref: I18N Example-Footnote-1786229 -Node: Gawk I18N786301 -Node: Debugger786922 -Node: Debugging787893 -Node: Debugging Concepts788326 -Node: Debugging Terms790182 -Node: Awk Debugging792779 -Node: Sample Debugging Session793671 -Node: Debugger Invocation794191 -Node: Finding The Bug795524 -Node: List of Debugger Commands802011 -Node: Breakpoint Control803345 -Node: Debugger Execution Control807009 -Node: Viewing And Changing Data810369 -Node: Execution Stack813725 -Node: Debugger Info815192 -Node: Miscellaneous Debugger Commands819186 -Node: Readline Support824364 -Node: Limitations825195 -Node: Arbitrary Precision Arithmetic827447 -Ref: Arbitrary Precision Arithmetic-Footnote-1829096 -Node: General Arithmetic829244 -Node: Floating Point Issues830964 -Node: String Conversion Precision831845 -Ref: String Conversion Precision-Footnote-1833550 -Node: Unexpected Results833659 -Node: POSIX Floating Point Problems835812 -Ref: POSIX Floating Point Problems-Footnote-1839637 -Node: Integer Programming839675 -Node: Floating-point Programming841414 -Ref: Floating-point Programming-Footnote-1847745 -Ref: Floating-point Programming-Footnote-2848015 -Node: Floating-point Representation848279 -Node: Floating-point Context849444 -Ref: table-ieee-formats850283 -Node: Rounding Mode851667 -Ref: table-rounding-modes852146 -Ref: Rounding Mode-Footnote-1855161 -Node: Gawk and MPFR855340 -Node: Arbitrary Precision Floats856749 -Ref: Arbitrary Precision Floats-Footnote-1859192 -Node: Setting Precision859508 -Ref: table-predefined-precision-strings860194 -Node: Setting Rounding Mode862339 -Ref: table-gawk-rounding-modes862743 -Node: Floating-point Constants863930 -Node: Changing Precision865359 -Ref: Changing Precision-Footnote-1866756 -Node: Exact Arithmetic866930 -Node: Arbitrary Precision Integers870068 -Ref: Arbitrary Precision Integers-Footnote-1873083 -Node: Dynamic Extensions873230 -Node: Extension Intro874688 -Node: Plugin License875953 -Node: Extension Mechanism Outline876638 -Ref: load-extension877055 -Ref: load-new-function878533 -Ref: call-new-function879528 -Node: Extension API Description881543 -Node: Extension API Functions Introduction882830 -Node: General Data Types887757 -Ref: General Data Types-Footnote-1893452 -Node: Requesting Values893751 -Ref: table-value-types-returned894488 -Node: Memory Allocation Functions895442 -Ref: Memory Allocation Functions-Footnote-1898188 -Node: Constructor Functions898284 -Node: Registration Functions900042 -Node: Extension Functions900727 -Node: Exit Callback Functions903029 -Node: Extension Version String904278 -Node: Input Parsers904928 -Node: Output Wrappers914685 -Node: Two-way processors919195 -Node: Printing Messages921403 -Ref: Printing Messages-Footnote-1922480 -Node: Updating `ERRNO'922632 -Node: Accessing Parameters923371 -Node: Symbol Table Access924601 -Node: Symbol table by name925115 -Node: Symbol table by cookie927091 -Ref: Symbol table by cookie-Footnote-1931223 -Node: Cached values931286 -Ref: Cached values-Footnote-1934776 -Node: Array Manipulation934867 -Ref: Array Manipulation-Footnote-1935965 -Node: Array Data Types936004 -Ref: Array Data Types-Footnote-1938707 -Node: Array Functions938799 -Node: Flattening Arrays942635 -Node: Creating Arrays949487 -Node: Extension API Variables954212 -Node: Extension Versioning954848 -Node: Extension API Informational Variables956749 -Node: Extension API Boilerplate957835 -Node: Finding Extensions961639 -Node: Extension Example962199 -Node: Internal File Description962929 -Node: Internal File Ops967020 -Ref: Internal File Ops-Footnote-1978529 -Node: Using Internal File Ops978669 -Ref: Using Internal File Ops-Footnote-1981016 -Node: Extension Samples981282 -Node: Extension Sample File Functions982806 -Node: Extension Sample Fnmatch991293 -Node: Extension Sample Fork993062 -Node: Extension Sample Inplace994275 -Node: Extension Sample Ord996053 -Node: Extension Sample Readdir996889 -Node: Extension Sample Revout998421 -Node: Extension Sample Rev2way999014 -Node: Extension Sample Read write array999704 -Node: Extension Sample Readfile1001587 -Node: Extension Sample API Tests1002687 -Node: Extension Sample Time1003212 -Node: gawkextlib1004576 -Node: Language History1007357 -Node: V7/SVR3.11008950 -Node: SVR41011270 -Node: POSIX1012712 -Node: BTL1014098 -Node: POSIX/GNU1014832 -Node: Feature History1020431 -Node: Common Extensions1033407 -Node: Ranges and Locales1034719 -Ref: Ranges and Locales-Footnote-11039336 -Ref: Ranges and Locales-Footnote-21039363 -Ref: Ranges and Locales-Footnote-31039597 -Node: Contributors1039818 -Node: Installation1045199 -Node: Gawk Distribution1046093 -Node: Getting1046577 -Node: Extracting1047403 -Node: Distribution contents1049095 -Node: Unix Installation1054816 -Node: Quick Installation1055433 -Node: Additional Configuration Options1057879 -Node: Configuration Philosophy1059615 -Node: Non-Unix Installation1061969 -Node: PC Installation1062427 -Node: PC Binary Installation1063726 -Node: PC Compiling1065574 -Node: PC Testing1068518 -Node: PC Using1069694 -Node: Cygwin1073862 -Node: MSYS1074671 -Node: VMS Installation1075185 -Node: VMS Compilation1075981 -Ref: VMS Compilation-Footnote-11077233 -Node: VMS Dynamic Extensions1077291 -Node: VMS Installation Details1078664 -Node: VMS Running1080915 -Node: VMS GNV1083749 -Node: VMS Old Gawk1084472 -Node: Bugs1084942 -Node: Other Versions1088860 -Node: Notes1094944 -Node: Compatibility Mode1095744 -Node: Additions1096527 -Node: Accessing The Source1097454 -Node: Adding Code1098894 -Node: New Ports1104939 -Node: Derived Files1109074 -Ref: Derived Files-Footnote-11114395 -Ref: Derived Files-Footnote-21114429 -Ref: Derived Files-Footnote-31115029 -Node: Future Extensions1115127 -Node: Implementation Limitations1115710 -Node: Extension Design1116958 -Node: Old Extension Problems1118112 -Ref: Old Extension Problems-Footnote-11119620 -Node: Extension New Mechanism Goals1119677 -Ref: Extension New Mechanism Goals-Footnote-11123042 -Node: Extension Other Design Decisions1123228 -Node: Extension Future Growth1125334 -Node: Old Extension Mechanism1126170 -Node: Basic Concepts1127910 -Node: Basic High Level1128591 -Ref: figure-general-flow1128863 -Ref: figure-process-flow1129462 -Ref: Basic High Level-Footnote-11132691 -Node: Basic Data Typing1132876 -Node: Glossary1136231 -Node: Copying1161462 -Node: GNU Free Documentation License1199018 -Node: Index1224154 +Ref: Auto-set-Footnote-1431248 +Ref: Auto-set-Footnote-2431453 +Node: ARGC and ARGV431509 +Node: Arrays435363 +Node: Array Basics436868 +Node: Array Intro437694 +Node: Reference to Elements442011 +Node: Assigning Elements444281 +Node: Array Example444772 +Node: Scanning an Array446504 +Node: Controlling Scanning448818 +Ref: Controlling Scanning-Footnote-1453905 +Node: Delete454221 +Ref: Delete-Footnote-1456986 +Node: Numeric Array Subscripts457043 +Node: Uninitialized Subscripts459226 +Node: Multidimensional460853 +Node: Multiscanning463946 +Node: Arrays of Arrays465535 +Node: Functions470175 +Node: Built-in470994 +Node: Calling Built-in472072 +Node: Numeric Functions474060 +Ref: Numeric Functions-Footnote-1477894 +Ref: Numeric Functions-Footnote-2478251 +Ref: Numeric Functions-Footnote-3478299 +Node: String Functions478568 +Ref: String Functions-Footnote-1501571 +Ref: String Functions-Footnote-2501700 +Ref: String Functions-Footnote-3501948 +Node: Gory Details502035 +Ref: table-sub-escapes503714 +Ref: table-sub-posix-92505068 +Ref: table-sub-proposed506419 +Ref: table-posix-sub507773 +Ref: table-gensub-escapes509318 +Ref: Gory Details-Footnote-1510494 +Ref: Gory Details-Footnote-2510545 +Node: I/O Functions510696 +Ref: I/O Functions-Footnote-1517692 +Node: Time Functions517839 +Ref: Time Functions-Footnote-1528832 +Ref: Time Functions-Footnote-2528900 +Ref: Time Functions-Footnote-3529058 +Ref: Time Functions-Footnote-4529169 +Ref: Time Functions-Footnote-5529281 +Ref: Time Functions-Footnote-6529508 +Node: Bitwise Functions529774 +Ref: table-bitwise-ops530336 +Ref: Bitwise Functions-Footnote-1534581 +Node: Type Functions534765 +Node: I18N Functions535916 +Node: User-defined537568 +Node: Definition Syntax538372 +Ref: Definition Syntax-Footnote-1543286 +Node: Function Example543355 +Ref: Function Example-Footnote-1546004 +Node: Function Caveats546026 +Node: Calling A Function546544 +Node: Variable Scope547499 +Node: Pass By Value/Reference550462 +Node: Return Statement553970 +Node: Dynamic Typing556951 +Node: Indirect Calls557882 +Node: Library Functions567569 +Ref: Library Functions-Footnote-1571082 +Ref: Library Functions-Footnote-2571225 +Node: Library Names571396 +Ref: Library Names-Footnote-1574869 +Ref: Library Names-Footnote-2575089 +Node: General Functions575175 +Node: Strtonum Function576203 +Node: Assert Function579133 +Node: Round Function582459 +Node: Cliff Random Function584000 +Node: Ordinal Functions585016 +Ref: Ordinal Functions-Footnote-1588093 +Ref: Ordinal Functions-Footnote-2588345 +Node: Join Function588556 +Ref: Join Function-Footnote-1590327 +Node: Getlocaltime Function590527 +Node: Readfile Function594268 +Node: Data File Management596107 +Node: Filetrans Function596739 +Node: Rewind Function600808 +Node: File Checking602195 +Node: Empty Files603289 +Node: Ignoring Assigns605519 +Node: Getopt Function607073 +Ref: Getopt Function-Footnote-1618376 +Node: Passwd Functions618579 +Ref: Passwd Functions-Footnote-1627557 +Node: Group Functions627645 +Node: Walking Arrays635729 +Node: Sample Programs637865 +Node: Running Examples638539 +Node: Clones639267 +Node: Cut Program640491 +Node: Egrep Program650342 +Ref: Egrep Program-Footnote-1658115 +Node: Id Program658225 +Node: Split Program661874 +Ref: Split Program-Footnote-1665393 +Node: Tee Program665521 +Node: Uniq Program668324 +Node: Wc Program675753 +Ref: Wc Program-Footnote-1680019 +Ref: Wc Program-Footnote-2680219 +Node: Miscellaneous Programs680311 +Node: Dupword Program681499 +Node: Alarm Program683530 +Node: Translate Program688337 +Ref: Translate Program-Footnote-1692724 +Ref: Translate Program-Footnote-2692972 +Node: Labels Program693106 +Ref: Labels Program-Footnote-1696477 +Node: Word Sorting696561 +Node: History Sorting700445 +Node: Extract Program702284 +Ref: Extract Program-Footnote-1709787 +Node: Simple Sed709915 +Node: Igawk Program712977 +Ref: Igawk Program-Footnote-1728148 +Ref: Igawk Program-Footnote-2728349 +Node: Anagram Program728487 +Node: Signature Program731555 +Node: Advanced Features732655 +Node: Nondecimal Data734541 +Node: Array Sorting736124 +Node: Controlling Array Traversal736821 +Node: Array Sorting Functions745105 +Ref: Array Sorting Functions-Footnote-1748974 +Node: Two-way I/O749168 +Ref: Two-way I/O-Footnote-1754600 +Node: TCP/IP Networking754682 +Node: Profiling757526 +Node: Internationalization765029 +Node: I18N and L10N766454 +Node: Explaining gettext767140 +Ref: Explaining gettext-Footnote-1772208 +Ref: Explaining gettext-Footnote-2772392 +Node: Programmer i18n772557 +Node: Translator i18n776784 +Node: String Extraction777578 +Ref: String Extraction-Footnote-1778539 +Node: Printf Ordering778625 +Ref: Printf Ordering-Footnote-1781407 +Node: I18N Portability781471 +Ref: I18N Portability-Footnote-1783920 +Node: I18N Example783983 +Ref: I18N Example-Footnote-1786621 +Node: Gawk I18N786693 +Node: Debugger787314 +Node: Debugging788285 +Node: Debugging Concepts788718 +Node: Debugging Terms790574 +Node: Awk Debugging793171 +Node: Sample Debugging Session794063 +Node: Debugger Invocation794583 +Node: Finding The Bug795916 +Node: List of Debugger Commands802403 +Node: Breakpoint Control803737 +Node: Debugger Execution Control807401 +Node: Viewing And Changing Data810761 +Node: Execution Stack814117 +Node: Debugger Info815584 +Node: Miscellaneous Debugger Commands819578 +Node: Readline Support824756 +Node: Limitations825587 +Node: Arbitrary Precision Arithmetic827839 +Ref: Arbitrary Precision Arithmetic-Footnote-1829488 +Node: General Arithmetic829636 +Node: Floating Point Issues831356 +Node: String Conversion Precision832237 +Ref: String Conversion Precision-Footnote-1833942 +Node: Unexpected Results834051 +Node: POSIX Floating Point Problems836204 +Ref: POSIX Floating Point Problems-Footnote-1840029 +Node: Integer Programming840067 +Node: Floating-point Programming841806 +Ref: Floating-point Programming-Footnote-1848137 +Ref: Floating-point Programming-Footnote-2848407 +Node: Floating-point Representation848671 +Node: Floating-point Context849836 +Ref: table-ieee-formats850675 +Node: Rounding Mode852059 +Ref: table-rounding-modes852538 +Ref: Rounding Mode-Footnote-1855553 +Node: Gawk and MPFR855732 +Node: Arbitrary Precision Floats857141 +Ref: Arbitrary Precision Floats-Footnote-1859584 +Node: Setting Precision859900 +Ref: table-predefined-precision-strings860586 +Node: Setting Rounding Mode862731 +Ref: table-gawk-rounding-modes863135 +Node: Floating-point Constants864322 +Node: Changing Precision865751 +Ref: Changing Precision-Footnote-1867148 +Node: Exact Arithmetic867322 +Node: Arbitrary Precision Integers870460 +Ref: Arbitrary Precision Integers-Footnote-1873475 +Node: Dynamic Extensions873622 +Node: Extension Intro875080 +Node: Plugin License876345 +Node: Extension Mechanism Outline877030 +Ref: load-extension877447 +Ref: load-new-function878925 +Ref: call-new-function879920 +Node: Extension API Description881935 +Node: Extension API Functions Introduction883222 +Node: General Data Types888149 +Ref: General Data Types-Footnote-1893844 +Node: Requesting Values894143 +Ref: table-value-types-returned894880 +Node: Memory Allocation Functions895834 +Ref: Memory Allocation Functions-Footnote-1898580 +Node: Constructor Functions898676 +Node: Registration Functions900434 +Node: Extension Functions901119 +Node: Exit Callback Functions903421 +Node: Extension Version String904670 +Node: Input Parsers905320 +Node: Output Wrappers915077 +Node: Two-way processors919587 +Node: Printing Messages921795 +Ref: Printing Messages-Footnote-1922872 +Node: Updating `ERRNO'923024 +Node: Accessing Parameters923763 +Node: Symbol Table Access924993 +Node: Symbol table by name925507 +Node: Symbol table by cookie927483 +Ref: Symbol table by cookie-Footnote-1931615 +Node: Cached values931678 +Ref: Cached values-Footnote-1935168 +Node: Array Manipulation935259 +Ref: Array Manipulation-Footnote-1936357 +Node: Array Data Types936396 +Ref: Array Data Types-Footnote-1939099 +Node: Array Functions939191 +Node: Flattening Arrays943027 +Node: Creating Arrays949879 +Node: Extension API Variables954604 +Node: Extension Versioning955240 +Node: Extension API Informational Variables957141 +Node: Extension API Boilerplate958227 +Node: Finding Extensions962031 +Node: Extension Example962591 +Node: Internal File Description963321 +Node: Internal File Ops967412 +Ref: Internal File Ops-Footnote-1978921 +Node: Using Internal File Ops979061 +Ref: Using Internal File Ops-Footnote-1981408 +Node: Extension Samples981674 +Node: Extension Sample File Functions983198 +Node: Extension Sample Fnmatch991685 +Node: Extension Sample Fork993454 +Node: Extension Sample Inplace994667 +Node: Extension Sample Ord996445 +Node: Extension Sample Readdir997281 +Node: Extension Sample Revout998813 +Node: Extension Sample Rev2way999406 +Node: Extension Sample Read write array1000096 +Node: Extension Sample Readfile1001979 +Node: Extension Sample API Tests1003079 +Node: Extension Sample Time1003604 +Node: gawkextlib1004968 +Node: Language History1007749 +Node: V7/SVR3.11009342 +Node: SVR41011662 +Node: POSIX1013104 +Node: BTL1014490 +Node: POSIX/GNU1015224 +Node: Feature History1020823 +Node: Common Extensions1033799 +Node: Ranges and Locales1035111 +Ref: Ranges and Locales-Footnote-11039728 +Ref: Ranges and Locales-Footnote-21039755 +Ref: Ranges and Locales-Footnote-31039989 +Node: Contributors1040210 +Node: Installation1045591 +Node: Gawk Distribution1046485 +Node: Getting1046969 +Node: Extracting1047795 +Node: Distribution contents1049487 +Node: Unix Installation1055208 +Node: Quick Installation1055825 +Node: Additional Configuration Options1058271 +Node: Configuration Philosophy1060007 +Node: Non-Unix Installation1062361 +Node: PC Installation1062819 +Node: PC Binary Installation1064118 +Node: PC Compiling1065966 +Node: PC Testing1068910 +Node: PC Using1070086 +Node: Cygwin1074254 +Node: MSYS1075063 +Node: VMS Installation1075577 +Node: VMS Compilation1076373 +Ref: VMS Compilation-Footnote-11077625 +Node: VMS Dynamic Extensions1077683 +Node: VMS Installation Details1079056 +Node: VMS Running1081307 +Node: VMS GNV1084141 +Node: VMS Old Gawk1084864 +Node: Bugs1085334 +Node: Other Versions1089252 +Node: Notes1095336 +Node: Compatibility Mode1096136 +Node: Additions1096919 +Node: Accessing The Source1097846 +Node: Adding Code1099286 +Node: New Ports1105331 +Node: Derived Files1109466 +Ref: Derived Files-Footnote-11114787 +Ref: Derived Files-Footnote-21114821 +Ref: Derived Files-Footnote-31115421 +Node: Future Extensions1115519 +Node: Implementation Limitations1116102 +Node: Extension Design1117350 +Node: Old Extension Problems1118504 +Ref: Old Extension Problems-Footnote-11120012 +Node: Extension New Mechanism Goals1120069 +Ref: Extension New Mechanism Goals-Footnote-11123434 +Node: Extension Other Design Decisions1123620 +Node: Extension Future Growth1125726 +Node: Old Extension Mechanism1126562 +Node: Basic Concepts1128302 +Node: Basic High Level1128983 +Ref: figure-general-flow1129255 +Ref: figure-process-flow1129854 +Ref: Basic High Level-Footnote-11133083 +Node: Basic Data Typing1133268 +Node: Glossary1136623 +Node: Copying1161854 +Node: GNU Free Documentation License1199410 +Node: Index1224546 End Tag Table |