diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 909 |
1 files changed, 458 insertions, 451 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 7c08ae18..07f283ff 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -7432,8 +7432,11 @@ File: gawk.info, Node: Using Variables, Next: Assignment Options, Up: Variabl Variables let you give names to values and refer to them later. Variables have already been used in many of the examples. The name of a variable must be a sequence of letters, digits, or underscores, and -it may not begin with a digit. Case is significant in variable names; -`a' and `A' are distinct variables. +it may not begin with a digit. Here, a "letter" is any one of the 52 +upper- and lowercase English letters. Other characters that may be +defined as letters in non-English locales are not valid in variable +names. Case is significant in variable names; `a' and `A' are distinct +variables. A variable name is a valid expression by itself; it represents the variable's current value. Variables are given new values with @@ -10302,8 +10305,11 @@ Options::), they are not special. `PROCINFO["identifiers"]' A subarray, indexed by the names of all identifiers used in - the text of the AWK program. For each identifier, the value - of the element is one of the following: + the text of the AWK program. An "identifier" is simply the + name of a variable (be it scalar or array), built-in + function, user-defined function, or extension function. For + each identifier, the value of the element is one of the + following: `"array"' The identifier is an array. @@ -13318,9 +13324,10 @@ starting to execute any of it. Here, NAME is the name of the function to define. A valid function name is like a valid variable name: a sequence of letters, digits, and -underscores that doesn't start with a digit. Within a single `awk' -program, any particular name can only be used as a variable, array, or -function. +underscores that doesn't start with a digit. Here too, only the 52 +upper- and lowercase English letters may be used in a function name. +Within a single `awk' program, any particular name can only be used as +a variable, array, or function. PARAMETER-LIST is an optional list of the function's arguments and local variable names, separated by commas. When the function is called, @@ -31777,7 +31784,7 @@ Index * common extensions, \x escape sequence: Escape Sequences. (line 61) * common extensions, BINMODE variable: PC Using. (line 33) * common extensions, delete to delete entire arrays: Delete. (line 39) -* common extensions, func keyword: Definition Syntax. (line 92) +* common extensions, func keyword: Definition Syntax. (line 93) * common extensions, length() applied to an array: String Functions. (line 197) * common extensions, RS as a regexp: gawk split records. (line 6) @@ -31889,7 +31896,7 @@ Index (line 46) * 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 313) +* dark corner, FNR/NR variables: Auto-set. (line 316) * dark corner, format-control characters: Control Letters. (line 18) * dark corner, FS as null string: Single Character Fields. (line 20) @@ -32113,7 +32120,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 269) +* differences in awk and gawk, RT variable: Auto-set. (line 272) * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. @@ -32121,7 +32128,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 273) +* differences in awk and gawk, SYMTAB variable: Auto-set. (line 276) * differences in awk and gawk, TEXTDOMAIN variable: User-modified. (line 152) * differences in awk and gawk, trunc-mod operation: Arithmetic Ops. @@ -32277,7 +32284,7 @@ Index (line 6) * extension API version: Extension Versioning. (line 6) -* extension API, version number: Auto-set. (line 236) +* extension API, version number: Auto-set. (line 239) * extension example: Extension Example. (line 6) * extension registration: Registration Functions. (line 6) @@ -32296,7 +32303,7 @@ Index * extensions, common, BINMODE variable: PC Using. (line 33) * extensions, common, delete to delete entire arrays: Delete. (line 39) * extensions, common, fflush() function: I/O Functions. (line 43) -* extensions, common, func keyword: Definition Syntax. (line 92) +* extensions, common, func keyword: Definition Syntax. (line 93) * extensions, common, length() applied to an array: String Functions. (line 197) * extensions, common, RS as a regexp: gawk split records. (line 6) @@ -32429,7 +32436,7 @@ Index (line 12) * FNR variable <1>: Auto-set. (line 107) * FNR variable: Records. (line 6) -* FNR variable, changing: Auto-set. (line 313) +* FNR variable, changing: Auto-set. (line 316) * for statement: For Statement. (line 6) * for statement, looping over arrays: Scanning an Array. (line 20) * fork() extension function: Extension Sample Fork. @@ -32515,7 +32522,7 @@ Index (line 6) * functions, names of <1>: Definition Syntax. (line 23) * functions, names of: Arrays. (line 18) -* functions, recursive: Definition Syntax. (line 82) +* functions, recursive: Definition Syntax. (line 83) * functions, string-translation: I18N Functions. (line 6) * functions, undefined: Pass By Value/Reference. (line 71) @@ -32530,7 +32537,7 @@ Index * G-d: Acknowledgments. (line 92) * Garfinkle, Scott: Contributors. (line 34) * gawk program, dynamic profiling: Profiling. (line 179) -* gawk version: Auto-set. (line 211) +* gawk version: Auto-set. (line 214) * gawk, ARGIND variable in: Other Arguments. (line 12) * gawk, awk and <1>: This Manual. (line 14) * gawk, awk and: Preface. (line 21) @@ -32607,14 +32614,14 @@ Index * gawk, regular expressions, operators: GNU Regexp Operators. (line 6) * gawk, regular expressions, precedence: Regexp Operators. (line 161) -* gawk, RT variable in <1>: Auto-set. (line 269) +* gawk, RT variable in <1>: Auto-set. (line 272) * gawk, RT variable in <2>: Multiple Line. (line 129) * gawk, RT variable in: awk split records. (line 124) * gawk, See Also awk: Preface. (line 34) * 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 273) +* gawk, SYMTAB array in: Auto-set. (line 276) * gawk, TEXTDOMAIN variable in: User-modified. (line 152) * gawk, timestamps: Time Functions. (line 6) * gawk, uses for: Preface. (line 34) @@ -32700,7 +32707,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 184) +* group ID of gawk user: Auto-set. (line 187) * groups, information about: Group Functions. (line 6) * gsub <1>: String Functions. (line 139) * gsub: Using Constant Regexps. @@ -32994,7 +33001,7 @@ Index * mawk utility <3>: Concatenation. (line 36) * mawk utility <4>: Getline/Pipe. (line 62) * mawk utility: Escape Sequences. (line 132) -* maximum precision supported by MPFR library: Auto-set. (line 225) +* maximum precision supported by MPFR library: Auto-set. (line 228) * McIlroy, Doug: Glossary. (line 149) * McPhee, Patrick: Contributors. (line 100) * message object files: Explaining gettext. (line 42) @@ -33007,7 +33014,7 @@ Index * messages from extensions: Printing Messages. (line 6) * metacharacters in regular expressions: Regexp Operators. (line 6) * metacharacters, escape sequences for: Escape Sequences. (line 138) -* minimum precision supported by MPFR library: Auto-set. (line 228) +* minimum precision supported by MPFR library: Auto-set. (line 231) * mktime: Time Functions. (line 25) * modifiers, in format specifiers: Format Modifiers. (line 6) * monetary information, localization: Explaining gettext. (line 104) @@ -33069,7 +33076,7 @@ Index * not Boolean-logic operator: Boolean Ops. (line 6) * NR variable <1>: Auto-set. (line 132) * NR variable: Records. (line 6) -* NR variable, changing: Auto-set. (line 313) +* NR variable, changing: Auto-set. (line 316) * null strings <1>: Basic Data Typing. (line 26) * null strings <2>: Truth Values. (line 6) * null strings <3>: Regexp Field Splitting. @@ -33183,7 +33190,7 @@ Index * p debugger command (alias for print): Viewing And Changing Data. (line 36) * Papadopoulos, Panos: Contributors. (line 128) -* parent process ID of gawk process: Auto-set. (line 193) +* parent process ID of gawk process: Auto-set. (line 196) * parentheses (), in a profile: Profiling. (line 146) * parentheses (), regexp operator: Regexp Operators. (line 81) * password file: Passwd Functions. (line 16) @@ -33239,7 +33246,7 @@ Index (line 65) * portability, deleting array elements: Delete. (line 56) * portability, example programs: Library Functions. (line 42) -* portability, functions, defining: Definition Syntax. (line 108) +* portability, functions, defining: Definition Syntax. (line 109) * portability, gawk: New Ports. (line 6) * portability, gettext library and: Explaining gettext. (line 11) * portability, internationalization and: I18N Portability. (line 6) @@ -33285,7 +33292,7 @@ Index (line 40) * POSIX awk, field separators and: Fields. (line 6) * POSIX awk, FS variable and: User-modified. (line 60) -* POSIX awk, function keyword in: Definition Syntax. (line 92) +* POSIX awk, function keyword in: Definition Syntax. (line 93) * POSIX awk, functions and, gsub()/sub(): Gory Details. (line 90) * POSIX awk, functions and, length(): String Functions. (line 176) * POSIX awk, GNU long options and: Options. (line 15) @@ -33346,8 +33353,8 @@ 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 187) -* process ID of gawk process: Auto-set. (line 190) +* process group idIDof gawk process: Auto-set. (line 190) +* process ID of gawk process: Auto-set. (line 193) * processes, two-way communications with: Two-way I/O. (line 6) * processing data: Basic High Level. (line 6) * PROCINFO array <1>: Passwd Functions. (line 6) @@ -33358,7 +33365,7 @@ Index * 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 246) +* PROCINFO array, uses: Auto-set. (line 249) * PROCINFO, values of sorted_in: Controlling Scanning. (line 26) * profiling awk programs: Profiling. (line 6) @@ -33374,7 +33381,7 @@ Index * programming conventions, functions, calling: Calling Built-in. (line 10) * programming conventions, functions, writing: Definition Syntax. - (line 64) + (line 65) * programming conventions, gawk extensions: Internal File Ops. (line 45) * programming conventions, private variable names: Library Names. @@ -33444,7 +33451,7 @@ Index * records, splitting input into: Records. (line 6) * records, terminating: awk split records. (line 124) * records, treating files as: gawk split records. (line 92) -* recursive functions: Definition Syntax. (line 82) +* recursive functions: Definition Syntax. (line 83) * redirect gawk output, in debugger: Debugger Info. (line 72) * redirection of input: Getline/File. (line 6) * redirection of output: Redirection. (line 6) @@ -33522,7 +33529,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 256) +* RLENGTH variable: Auto-set. (line 259) * RLENGTH variable, match() function and: String Functions. (line 224) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) @@ -33548,9 +33555,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 262) +* RSTART variable: Auto-set. (line 265) * RSTART variable, match() function and: String Functions. (line 224) -* RT variable <1>: Auto-set. (line 269) +* RT variable <1>: Auto-set. (line 272) * RT variable <2>: Multiple Line. (line 129) * RT variable: awk split records. (line 124) * Rubin, Paul <1>: Contributors. (line 15) @@ -33570,7 +33577,7 @@ Index * scanning arrays: Scanning an Array. (line 6) * scanning multidimensional arrays: Multiscanning. (line 11) * Schorr, Andrew <1>: Contributors. (line 133) -* Schorr, Andrew <2>: Auto-set. (line 296) +* Schorr, Andrew <2>: Auto-set. (line 299) * Schorr, Andrew: Acknowledgments. (line 60) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) @@ -33614,7 +33621,7 @@ Index * set directory of message catalogs: I18N Functions. (line 12) * set watchpoint: Viewing And Changing Data. (line 67) -* shadowing of variable values: Definition Syntax. (line 70) +* shadowing of variable values: Definition Syntax. (line 71) * shell quoting, rules for: Quoting. (line 6) * shells, piping commands into: Redirection. (line 142) * shells, quoting: Using Shell Variables. @@ -33654,7 +33661,7 @@ Index (line 118) * sidebar, Changing FS Does Not Affect the Fields: Field Splitting Summary. (line 38) -* sidebar, Changing NR and FNR: Auto-set. (line 311) +* sidebar, Changing NR and FNR: Auto-set. (line 314) * sidebar, Controlling Output Buffering with system(): I/O Functions. (line 138) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. @@ -33817,9 +33824,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 241) +* supplementary groups of gawk process: Auto-set. (line 244) * switch statement: Switch Statement. (line 6) -* SYMTAB array: Auto-set. (line 273) +* SYMTAB array: Auto-set. (line 276) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. (line 148) * system: I/O Functions. (line 75) @@ -33972,7 +33979,7 @@ Index * variables: Other Features. (line 6) * variables, assigning on command line: Assignment Options. (line 6) * variables, built-in <1>: Built-in Variables. (line 6) -* variables, built-in: Using Variables. (line 20) +* variables, built-in: Using Variables. (line 23) * variables, built-in, -v option, setting with: Options. (line 40) * variables, built-in, conveying information: Auto-set. (line 6) * variables, flag: Boolean Ops. (line 67) @@ -33985,22 +33992,22 @@ Index * variables, getline command into, using: Getline/Variable. (line 6) * variables, global, for library functions: Library Names. (line 11) * variables, global, printing list of: Options. (line 93) -* variables, initializing: Using Variables. (line 20) +* variables, initializing: Using Variables. (line 23) * variables, local to a function: Variable Scope. (line 6) * variables, names of: Arrays. (line 18) * variables, private: Library Names. (line 11) * variables, setting: Options. (line 32) -* variables, shadowing: Definition Syntax. (line 70) +* variables, shadowing: Definition Syntax. (line 71) * variables, types of: Assignment Ops. (line 40) * variables, types of, comparison expressions and: Typing and Comparison. (line 9) * variables, uninitialized, as array subscripts: Uninitialized Subscripts. (line 6) * variables, user-defined: Variables. (line 6) -* version of gawk: Auto-set. (line 211) -* version of gawk extension API: Auto-set. (line 236) -* version of GNU MP library: Auto-set. (line 222) -* version of GNU MPFR library: Auto-set. (line 218) +* version of gawk: Auto-set. (line 214) +* version of gawk extension API: Auto-set. (line 239) +* version of GNU MP library: Auto-set. (line 225) +* version of GNU MPFR library: Auto-set. (line 221) * vertical bar (|): Regexp Operators. (line 70) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 65) * vertical bar (|), | operator (I/O): Getline/Pipe. (line 9) @@ -34229,411 +34236,411 @@ Node: Regexp Constants318616 Node: Using Constant Regexps319141 Node: Variables322213 Node: Using Variables322868 -Node: Assignment Options324592 -Node: Conversion326467 -Node: Strings And Numbers326991 -Ref: Strings And Numbers-Footnote-1330053 -Node: Locale influences conversions330162 -Ref: table-locale-affects332879 -Node: All Operators333467 -Node: Arithmetic Ops334097 -Node: Concatenation336602 -Ref: Concatenation-Footnote-1339421 -Node: Assignment Ops339527 -Ref: table-assign-ops344510 -Node: Increment Ops345813 -Node: Truth Values and Conditions349251 -Node: Truth Values350334 -Node: Typing and Comparison351383 -Node: Variable Typing352176 -Node: Comparison Operators355828 -Ref: table-relational-ops356238 -Node: POSIX String Comparison359788 -Ref: POSIX String Comparison-Footnote-1360872 -Node: Boolean Ops361010 -Ref: Boolean Ops-Footnote-1365349 -Node: Conditional Exp365440 -Node: Function Calls367167 -Node: Precedence371047 -Node: Locales374716 -Node: Expressions Summary376347 -Node: Patterns and Actions378888 -Node: Pattern Overview380004 -Node: Regexp Patterns381681 -Node: Expression Patterns382224 -Node: Ranges386004 -Node: BEGIN/END389110 -Node: Using BEGIN/END389872 -Ref: Using BEGIN/END-Footnote-1392608 -Node: I/O And BEGIN/END392714 -Node: BEGINFILE/ENDFILE394985 -Node: Empty397916 -Node: Using Shell Variables398233 -Node: Action Overview400516 -Node: Statements402843 -Node: If Statement404691 -Node: While Statement406189 -Node: Do Statement408233 -Node: For Statement409389 -Node: Switch Statement412541 -Node: Break Statement414929 -Node: Continue Statement416970 -Node: Next Statement418795 -Node: Nextfile Statement421165 -Node: Exit Statement423822 -Node: Built-in Variables426226 -Node: User-modified427353 -Ref: User-modified-Footnote-1435042 -Node: Auto-set435104 -Ref: Auto-set-Footnote-1448123 -Ref: Auto-set-Footnote-2448328 -Node: ARGC and ARGV448384 -Node: Pattern Action Summary452288 -Node: Arrays454511 -Node: Array Basics456060 -Node: Array Intro456886 -Ref: figure-array-elements458859 -Ref: Array Intro-Footnote-1461383 -Node: Reference to Elements461511 -Node: Assigning Elements463961 -Node: Array Example464452 -Node: Scanning an Array466184 -Node: Controlling Scanning469185 -Ref: Controlling Scanning-Footnote-1474358 -Node: Delete474674 -Ref: Delete-Footnote-1477425 -Node: Numeric Array Subscripts477482 -Node: Uninitialized Subscripts479665 -Node: Multidimensional481292 -Node: Multiscanning484405 -Node: Arrays of Arrays485994 -Node: Arrays Summary490657 -Node: Functions492762 -Node: Built-in493635 -Node: Calling Built-in494713 -Node: Numeric Functions496701 -Ref: Numeric Functions-Footnote-1501537 -Ref: Numeric Functions-Footnote-2501894 -Ref: Numeric Functions-Footnote-3501942 -Node: String Functions502211 -Ref: String Functions-Footnote-1525208 -Ref: String Functions-Footnote-2525337 -Ref: String Functions-Footnote-3525585 -Node: Gory Details525672 -Ref: table-sub-escapes527445 -Ref: table-sub-proposed528965 -Ref: table-posix-sub530329 -Ref: table-gensub-escapes531869 -Ref: Gory Details-Footnote-1533045 -Node: I/O Functions533196 -Ref: I/O Functions-Footnote-1540306 -Node: Time Functions540453 -Ref: Time Functions-Footnote-1550917 -Ref: Time Functions-Footnote-2550985 -Ref: Time Functions-Footnote-3551143 -Ref: Time Functions-Footnote-4551254 -Ref: Time Functions-Footnote-5551366 -Ref: Time Functions-Footnote-6551593 -Node: Bitwise Functions551859 -Ref: table-bitwise-ops552421 -Ref: Bitwise Functions-Footnote-1556666 -Node: Type Functions556850 -Node: I18N Functions557992 -Node: User-defined559637 -Node: Definition Syntax560441 -Ref: Definition Syntax-Footnote-1565754 -Node: Function Example565823 -Ref: Function Example-Footnote-1568463 -Node: Function Caveats568485 -Node: Calling A Function569003 -Node: Variable Scope569958 -Node: Pass By Value/Reference572946 -Node: Return Statement576456 -Node: Dynamic Typing579440 -Node: Indirect Calls580369 -Ref: Indirect Calls-Footnote-1590085 -Node: Functions Summary590213 -Node: Library Functions592863 -Ref: Library Functions-Footnote-1596481 -Ref: Library Functions-Footnote-2596624 -Node: Library Names596795 -Ref: Library Names-Footnote-1600268 -Ref: Library Names-Footnote-2600488 -Node: General Functions600574 -Node: Strtonum Function601602 -Node: Assert Function604504 -Node: Round Function607830 -Node: Cliff Random Function609371 -Node: Ordinal Functions610387 -Ref: Ordinal Functions-Footnote-1613452 -Ref: Ordinal Functions-Footnote-2613704 -Node: Join Function613915 -Ref: Join Function-Footnote-1615686 -Node: Getlocaltime Function615886 -Node: Readfile Function619622 -Node: Data File Management621461 -Node: Filetrans Function622093 -Node: Rewind Function626162 -Node: File Checking627720 -Ref: File Checking-Footnote-1628852 -Node: Empty Files629053 -Node: Ignoring Assigns631032 -Node: Getopt Function632586 -Ref: Getopt Function-Footnote-1643850 -Node: Passwd Functions644053 -Ref: Passwd Functions-Footnote-1653032 -Node: Group Functions653120 -Ref: Group Functions-Footnote-1661051 -Node: Walking Arrays661264 -Node: Library Functions Summary662867 -Node: Library Exercises664255 -Node: Sample Programs665535 -Node: Running Examples666305 -Node: Clones667033 -Node: Cut Program668257 -Node: Egrep Program678115 -Ref: Egrep Program-Footnote-1685702 -Node: Id Program685812 -Node: Split Program689466 -Ref: Split Program-Footnote-1693004 -Node: Tee Program693132 -Node: Uniq Program695919 -Node: Wc Program703342 -Ref: Wc Program-Footnote-1707607 -Node: Miscellaneous Programs707699 -Node: Dupword Program708912 -Node: Alarm Program710943 -Node: Translate Program715747 -Ref: Translate Program-Footnote-1720320 -Ref: Translate Program-Footnote-2720590 -Node: Labels Program720729 -Ref: Labels Program-Footnote-1724090 -Node: Word Sorting724174 -Node: History Sorting728217 -Node: Extract Program730053 -Node: Simple Sed737589 -Node: Igawk Program740651 -Ref: Igawk Program-Footnote-1754955 -Ref: Igawk Program-Footnote-2755156 -Node: Anagram Program755294 -Node: Signature Program758362 -Node: Programs Summary759609 -Node: Programs Exercises760824 -Ref: Programs Exercises-Footnote-1764955 -Node: Advanced Features765046 -Node: Nondecimal Data766994 -Node: Array Sorting768571 -Node: Controlling Array Traversal769268 -Node: Array Sorting Functions777548 -Ref: Array Sorting Functions-Footnote-1781455 -Node: Two-way I/O781649 -Ref: Two-way I/O-Footnote-1786593 -Ref: Two-way I/O-Footnote-2786772 -Node: TCP/IP Networking786854 -Node: Profiling789699 -Node: Advanced Features Summary797250 -Node: Internationalization799114 -Node: I18N and L10N800594 -Node: Explaining gettext801280 -Ref: Explaining gettext-Footnote-1806306 -Ref: Explaining gettext-Footnote-2806490 -Node: Programmer i18n806655 -Ref: Programmer i18n-Footnote-1811449 -Node: Translator i18n811498 -Node: String Extraction812292 -Ref: String Extraction-Footnote-1813425 -Node: Printf Ordering813511 -Ref: Printf Ordering-Footnote-1816293 -Node: I18N Portability816357 -Ref: I18N Portability-Footnote-1818806 -Node: I18N Example818869 -Ref: I18N Example-Footnote-1821575 -Node: Gawk I18N821647 -Node: I18N Summary822285 -Node: Debugger823624 -Node: Debugging824646 -Node: Debugging Concepts825087 -Node: Debugging Terms826943 -Node: Awk Debugging829540 -Node: Sample Debugging Session830432 -Node: Debugger Invocation830952 -Node: Finding The Bug832288 -Node: List of Debugger Commands838767 -Node: Breakpoint Control840099 -Node: Debugger Execution Control843763 -Node: Viewing And Changing Data847123 -Node: Execution Stack850481 -Node: Debugger Info851994 -Node: Miscellaneous Debugger Commands855988 -Node: Readline Support861172 -Node: Limitations862064 -Node: Debugging Summary864337 -Node: Arbitrary Precision Arithmetic865505 -Node: Computer Arithmetic866992 -Ref: Computer Arithmetic-Footnote-1871379 -Node: Math Definitions871436 -Ref: table-ieee-formats874725 -Ref: Math Definitions-Footnote-1875265 -Node: MPFR features875368 -Node: FP Math Caution876985 -Ref: FP Math Caution-Footnote-1878035 -Node: Inexactness of computations878404 -Node: Inexact representation879352 -Node: Comparing FP Values880707 -Node: Errors accumulate881671 -Node: Getting Accuracy883104 -Node: Try To Round885763 -Node: Setting precision886662 -Ref: table-predefined-precision-strings887344 -Node: Setting the rounding mode889137 -Ref: table-gawk-rounding-modes889501 -Ref: Setting the rounding mode-Footnote-1892955 -Node: Arbitrary Precision Integers893134 -Ref: Arbitrary Precision Integers-Footnote-1896907 -Node: POSIX Floating Point Problems897056 -Ref: POSIX Floating Point Problems-Footnote-1900932 -Node: Floating point summary900970 -Node: Dynamic Extensions903174 -Node: Extension Intro904726 -Node: Plugin License905991 -Node: Extension Mechanism Outline906676 -Ref: figure-load-extension907100 -Ref: figure-load-new-function908585 -Ref: figure-call-new-function909587 -Node: Extension API Description911571 -Node: Extension API Functions Introduction913021 -Node: General Data Types917888 -Ref: General Data Types-Footnote-1923581 -Node: Requesting Values923880 -Ref: table-value-types-returned924617 -Node: Memory Allocation Functions925575 -Ref: Memory Allocation Functions-Footnote-1928322 -Node: Constructor Functions928418 -Node: Registration Functions930176 -Node: Extension Functions930861 -Node: Exit Callback Functions933163 -Node: Extension Version String934411 -Node: Input Parsers935061 -Node: Output Wrappers944875 -Node: Two-way processors949391 -Node: Printing Messages951595 -Ref: Printing Messages-Footnote-1952672 -Node: Updating `ERRNO'952824 -Node: Accessing Parameters953563 -Node: Symbol Table Access954793 -Node: Symbol table by name955307 -Node: Symbol table by cookie957283 -Ref: Symbol table by cookie-Footnote-1961416 -Node: Cached values961479 -Ref: Cached values-Footnote-1964983 -Node: Array Manipulation965074 -Ref: Array Manipulation-Footnote-1966172 -Node: Array Data Types966211 -Ref: Array Data Types-Footnote-1968914 -Node: Array Functions969006 -Node: Flattening Arrays972880 -Node: Creating Arrays979732 -Node: Extension API Variables984463 -Node: Extension Versioning985099 -Node: Extension API Informational Variables987000 -Node: Extension API Boilerplate988086 -Node: Finding Extensions991890 -Node: Extension Example992450 -Node: Internal File Description993180 -Node: Internal File Ops997271 -Ref: Internal File Ops-Footnote-11008703 -Node: Using Internal File Ops1008843 -Ref: Using Internal File Ops-Footnote-11011190 -Node: Extension Samples1011458 -Node: Extension Sample File Functions1012982 -Node: Extension Sample Fnmatch1020550 -Node: Extension Sample Fork1022032 -Node: Extension Sample Inplace1023245 -Node: Extension Sample Ord1024920 -Node: Extension Sample Readdir1025756 -Ref: table-readdir-file-types1026612 -Node: Extension Sample Revout1027411 -Node: Extension Sample Rev2way1028002 -Node: Extension Sample Read write array1028743 -Node: Extension Sample Readfile1030622 -Node: Extension Sample API Tests1031722 -Node: Extension Sample Time1032247 -Node: gawkextlib1033562 -Node: Extension summary1036375 -Node: Extension Exercises1040068 -Node: Language History1040790 -Node: V7/SVR3.11042433 -Node: SVR41044753 -Node: POSIX1046195 -Node: BTL1047581 -Node: POSIX/GNU1048315 -Node: Feature History1054091 -Node: Common Extensions1067182 -Node: Ranges and Locales1068494 -Ref: Ranges and Locales-Footnote-11073111 -Ref: Ranges and Locales-Footnote-21073138 -Ref: Ranges and Locales-Footnote-31073372 -Node: Contributors1073593 -Node: History summary1079018 -Node: Installation1080387 -Node: Gawk Distribution1081338 -Node: Getting1081822 -Node: Extracting1082646 -Node: Distribution contents1084288 -Node: Unix Installation1090058 -Node: Quick Installation1090675 -Node: Additional Configuration Options1093117 -Node: Configuration Philosophy1094855 -Node: Non-Unix Installation1097206 -Node: PC Installation1097664 -Node: PC Binary Installation1098975 -Node: PC Compiling1100823 -Ref: PC Compiling-Footnote-11103822 -Node: PC Testing1103927 -Node: PC Using1105103 -Node: Cygwin1109255 -Node: MSYS1110064 -Node: VMS Installation1110578 -Node: VMS Compilation1111374 -Ref: VMS Compilation-Footnote-11112596 -Node: VMS Dynamic Extensions1112654 -Node: VMS Installation Details1114027 -Node: VMS Running1116279 -Node: VMS GNV1119113 -Node: VMS Old Gawk1119836 -Node: Bugs1120306 -Node: Other Versions1124310 -Node: Installation summary1130537 -Node: Notes1131593 -Node: Compatibility Mode1132458 -Node: Additions1133240 -Node: Accessing The Source1134165 -Node: Adding Code1135601 -Node: New Ports1141779 -Node: Derived Files1146260 -Ref: Derived Files-Footnote-11151735 -Ref: Derived Files-Footnote-21151769 -Ref: Derived Files-Footnote-31152365 -Node: Future Extensions1152479 -Node: Implementation Limitations1153085 -Node: Extension Design1154333 -Node: Old Extension Problems1155487 -Ref: Old Extension Problems-Footnote-11157004 -Node: Extension New Mechanism Goals1157061 -Ref: Extension New Mechanism Goals-Footnote-11160421 -Node: Extension Other Design Decisions1160610 -Node: Extension Future Growth1162716 -Node: Old Extension Mechanism1163552 -Node: Notes summary1165314 -Node: Basic Concepts1166500 -Node: Basic High Level1167181 -Ref: figure-general-flow1167453 -Ref: figure-process-flow1168052 -Ref: Basic High Level-Footnote-11171281 -Node: Basic Data Typing1171466 -Node: Glossary1174794 -Node: Copying1199946 -Node: GNU Free Documentation License1237502 -Node: Index1262638 +Node: Assignment Options324774 +Node: Conversion326649 +Node: Strings And Numbers327173 +Ref: Strings And Numbers-Footnote-1330235 +Node: Locale influences conversions330344 +Ref: table-locale-affects333061 +Node: All Operators333649 +Node: Arithmetic Ops334279 +Node: Concatenation336784 +Ref: Concatenation-Footnote-1339603 +Node: Assignment Ops339709 +Ref: table-assign-ops344692 +Node: Increment Ops345995 +Node: Truth Values and Conditions349433 +Node: Truth Values350516 +Node: Typing and Comparison351565 +Node: Variable Typing352358 +Node: Comparison Operators356010 +Ref: table-relational-ops356420 +Node: POSIX String Comparison359970 +Ref: POSIX String Comparison-Footnote-1361054 +Node: Boolean Ops361192 +Ref: Boolean Ops-Footnote-1365531 +Node: Conditional Exp365622 +Node: Function Calls367349 +Node: Precedence371229 +Node: Locales374898 +Node: Expressions Summary376529 +Node: Patterns and Actions379070 +Node: Pattern Overview380186 +Node: Regexp Patterns381863 +Node: Expression Patterns382406 +Node: Ranges386186 +Node: BEGIN/END389292 +Node: Using BEGIN/END390054 +Ref: Using BEGIN/END-Footnote-1392790 +Node: I/O And BEGIN/END392896 +Node: BEGINFILE/ENDFILE395167 +Node: Empty398098 +Node: Using Shell Variables398415 +Node: Action Overview400698 +Node: Statements403025 +Node: If Statement404873 +Node: While Statement406371 +Node: Do Statement408415 +Node: For Statement409571 +Node: Switch Statement412723 +Node: Break Statement415111 +Node: Continue Statement417152 +Node: Next Statement418977 +Node: Nextfile Statement421347 +Node: Exit Statement424004 +Node: Built-in Variables426408 +Node: User-modified427535 +Ref: User-modified-Footnote-1435224 +Node: Auto-set435286 +Ref: Auto-set-Footnote-1448475 +Ref: Auto-set-Footnote-2448680 +Node: ARGC and ARGV448736 +Node: Pattern Action Summary452640 +Node: Arrays454863 +Node: Array Basics456412 +Node: Array Intro457238 +Ref: figure-array-elements459211 +Ref: Array Intro-Footnote-1461735 +Node: Reference to Elements461863 +Node: Assigning Elements464313 +Node: Array Example464804 +Node: Scanning an Array466536 +Node: Controlling Scanning469537 +Ref: Controlling Scanning-Footnote-1474710 +Node: Delete475026 +Ref: Delete-Footnote-1477777 +Node: Numeric Array Subscripts477834 +Node: Uninitialized Subscripts480017 +Node: Multidimensional481644 +Node: Multiscanning484757 +Node: Arrays of Arrays486346 +Node: Arrays Summary491009 +Node: Functions493114 +Node: Built-in493987 +Node: Calling Built-in495065 +Node: Numeric Functions497053 +Ref: Numeric Functions-Footnote-1501889 +Ref: Numeric Functions-Footnote-2502246 +Ref: Numeric Functions-Footnote-3502294 +Node: String Functions502563 +Ref: String Functions-Footnote-1525560 +Ref: String Functions-Footnote-2525689 +Ref: String Functions-Footnote-3525937 +Node: Gory Details526024 +Ref: table-sub-escapes527797 +Ref: table-sub-proposed529317 +Ref: table-posix-sub530681 +Ref: table-gensub-escapes532221 +Ref: Gory Details-Footnote-1533397 +Node: I/O Functions533548 +Ref: I/O Functions-Footnote-1540658 +Node: Time Functions540805 +Ref: Time Functions-Footnote-1551269 +Ref: Time Functions-Footnote-2551337 +Ref: Time Functions-Footnote-3551495 +Ref: Time Functions-Footnote-4551606 +Ref: Time Functions-Footnote-5551718 +Ref: Time Functions-Footnote-6551945 +Node: Bitwise Functions552211 +Ref: table-bitwise-ops552773 +Ref: Bitwise Functions-Footnote-1557018 +Node: Type Functions557202 +Node: I18N Functions558344 +Node: User-defined559989 +Node: Definition Syntax560793 +Ref: Definition Syntax-Footnote-1566197 +Node: Function Example566266 +Ref: Function Example-Footnote-1568906 +Node: Function Caveats568928 +Node: Calling A Function569446 +Node: Variable Scope570401 +Node: Pass By Value/Reference573389 +Node: Return Statement576899 +Node: Dynamic Typing579883 +Node: Indirect Calls580812 +Ref: Indirect Calls-Footnote-1590528 +Node: Functions Summary590656 +Node: Library Functions593306 +Ref: Library Functions-Footnote-1596924 +Ref: Library Functions-Footnote-2597067 +Node: Library Names597238 +Ref: Library Names-Footnote-1600711 +Ref: Library Names-Footnote-2600931 +Node: General Functions601017 +Node: Strtonum Function602045 +Node: Assert Function604947 +Node: Round Function608273 +Node: Cliff Random Function609814 +Node: Ordinal Functions610830 +Ref: Ordinal Functions-Footnote-1613895 +Ref: Ordinal Functions-Footnote-2614147 +Node: Join Function614358 +Ref: Join Function-Footnote-1616129 +Node: Getlocaltime Function616329 +Node: Readfile Function620065 +Node: Data File Management621904 +Node: Filetrans Function622536 +Node: Rewind Function626605 +Node: File Checking628163 +Ref: File Checking-Footnote-1629295 +Node: Empty Files629496 +Node: Ignoring Assigns631475 +Node: Getopt Function633029 +Ref: Getopt Function-Footnote-1644293 +Node: Passwd Functions644496 +Ref: Passwd Functions-Footnote-1653475 +Node: Group Functions653563 +Ref: Group Functions-Footnote-1661494 +Node: Walking Arrays661707 +Node: Library Functions Summary663310 +Node: Library Exercises664698 +Node: Sample Programs665978 +Node: Running Examples666748 +Node: Clones667476 +Node: Cut Program668700 +Node: Egrep Program678558 +Ref: Egrep Program-Footnote-1686145 +Node: Id Program686255 +Node: Split Program689909 +Ref: Split Program-Footnote-1693447 +Node: Tee Program693575 +Node: Uniq Program696362 +Node: Wc Program703785 +Ref: Wc Program-Footnote-1708050 +Node: Miscellaneous Programs708142 +Node: Dupword Program709355 +Node: Alarm Program711386 +Node: Translate Program716190 +Ref: Translate Program-Footnote-1720763 +Ref: Translate Program-Footnote-2721033 +Node: Labels Program721172 +Ref: Labels Program-Footnote-1724533 +Node: Word Sorting724617 +Node: History Sorting728660 +Node: Extract Program730496 +Node: Simple Sed738032 +Node: Igawk Program741094 +Ref: Igawk Program-Footnote-1755398 +Ref: Igawk Program-Footnote-2755599 +Node: Anagram Program755737 +Node: Signature Program758805 +Node: Programs Summary760052 +Node: Programs Exercises761267 +Ref: Programs Exercises-Footnote-1765398 +Node: Advanced Features765489 +Node: Nondecimal Data767437 +Node: Array Sorting769014 +Node: Controlling Array Traversal769711 +Node: Array Sorting Functions777991 +Ref: Array Sorting Functions-Footnote-1781898 +Node: Two-way I/O782092 +Ref: Two-way I/O-Footnote-1787036 +Ref: Two-way I/O-Footnote-2787215 +Node: TCP/IP Networking787297 +Node: Profiling790142 +Node: Advanced Features Summary797693 +Node: Internationalization799557 +Node: I18N and L10N801037 +Node: Explaining gettext801723 +Ref: Explaining gettext-Footnote-1806749 +Ref: Explaining gettext-Footnote-2806933 +Node: Programmer i18n807098 +Ref: Programmer i18n-Footnote-1811892 +Node: Translator i18n811941 +Node: String Extraction812735 +Ref: String Extraction-Footnote-1813868 +Node: Printf Ordering813954 +Ref: Printf Ordering-Footnote-1816736 +Node: I18N Portability816800 +Ref: I18N Portability-Footnote-1819249 +Node: I18N Example819312 +Ref: I18N Example-Footnote-1822018 +Node: Gawk I18N822090 +Node: I18N Summary822728 +Node: Debugger824067 +Node: Debugging825089 +Node: Debugging Concepts825530 +Node: Debugging Terms827386 +Node: Awk Debugging829983 +Node: Sample Debugging Session830875 +Node: Debugger Invocation831395 +Node: Finding The Bug832731 +Node: List of Debugger Commands839210 +Node: Breakpoint Control840542 +Node: Debugger Execution Control844206 +Node: Viewing And Changing Data847566 +Node: Execution Stack850924 +Node: Debugger Info852437 +Node: Miscellaneous Debugger Commands856431 +Node: Readline Support861615 +Node: Limitations862507 +Node: Debugging Summary864780 +Node: Arbitrary Precision Arithmetic865948 +Node: Computer Arithmetic867435 +Ref: Computer Arithmetic-Footnote-1871822 +Node: Math Definitions871879 +Ref: table-ieee-formats875168 +Ref: Math Definitions-Footnote-1875708 +Node: MPFR features875811 +Node: FP Math Caution877428 +Ref: FP Math Caution-Footnote-1878478 +Node: Inexactness of computations878847 +Node: Inexact representation879795 +Node: Comparing FP Values881150 +Node: Errors accumulate882114 +Node: Getting Accuracy883547 +Node: Try To Round886206 +Node: Setting precision887105 +Ref: table-predefined-precision-strings887787 +Node: Setting the rounding mode889580 +Ref: table-gawk-rounding-modes889944 +Ref: Setting the rounding mode-Footnote-1893398 +Node: Arbitrary Precision Integers893577 +Ref: Arbitrary Precision Integers-Footnote-1897350 +Node: POSIX Floating Point Problems897499 +Ref: POSIX Floating Point Problems-Footnote-1901375 +Node: Floating point summary901413 +Node: Dynamic Extensions903617 +Node: Extension Intro905169 +Node: Plugin License906434 +Node: Extension Mechanism Outline907119 +Ref: figure-load-extension907543 +Ref: figure-load-new-function909028 +Ref: figure-call-new-function910030 +Node: Extension API Description912014 +Node: Extension API Functions Introduction913464 +Node: General Data Types918331 +Ref: General Data Types-Footnote-1924024 +Node: Requesting Values924323 +Ref: table-value-types-returned925060 +Node: Memory Allocation Functions926018 +Ref: Memory Allocation Functions-Footnote-1928765 +Node: Constructor Functions928861 +Node: Registration Functions930619 +Node: Extension Functions931304 +Node: Exit Callback Functions933606 +Node: Extension Version String934854 +Node: Input Parsers935504 +Node: Output Wrappers945318 +Node: Two-way processors949834 +Node: Printing Messages952038 +Ref: Printing Messages-Footnote-1953115 +Node: Updating `ERRNO'953267 +Node: Accessing Parameters954006 +Node: Symbol Table Access955236 +Node: Symbol table by name955750 +Node: Symbol table by cookie957726 +Ref: Symbol table by cookie-Footnote-1961859 +Node: Cached values961922 +Ref: Cached values-Footnote-1965426 +Node: Array Manipulation965517 +Ref: Array Manipulation-Footnote-1966615 +Node: Array Data Types966654 +Ref: Array Data Types-Footnote-1969357 +Node: Array Functions969449 +Node: Flattening Arrays973323 +Node: Creating Arrays980175 +Node: Extension API Variables984906 +Node: Extension Versioning985542 +Node: Extension API Informational Variables987443 +Node: Extension API Boilerplate988529 +Node: Finding Extensions992333 +Node: Extension Example992893 +Node: Internal File Description993623 +Node: Internal File Ops997714 +Ref: Internal File Ops-Footnote-11009146 +Node: Using Internal File Ops1009286 +Ref: Using Internal File Ops-Footnote-11011633 +Node: Extension Samples1011901 +Node: Extension Sample File Functions1013425 +Node: Extension Sample Fnmatch1020993 +Node: Extension Sample Fork1022475 +Node: Extension Sample Inplace1023688 +Node: Extension Sample Ord1025363 +Node: Extension Sample Readdir1026199 +Ref: table-readdir-file-types1027055 +Node: Extension Sample Revout1027854 +Node: Extension Sample Rev2way1028445 +Node: Extension Sample Read write array1029186 +Node: Extension Sample Readfile1031065 +Node: Extension Sample API Tests1032165 +Node: Extension Sample Time1032690 +Node: gawkextlib1034005 +Node: Extension summary1036818 +Node: Extension Exercises1040511 +Node: Language History1041233 +Node: V7/SVR3.11042876 +Node: SVR41045196 +Node: POSIX1046638 +Node: BTL1048024 +Node: POSIX/GNU1048758 +Node: Feature History1054534 +Node: Common Extensions1067625 +Node: Ranges and Locales1068937 +Ref: Ranges and Locales-Footnote-11073554 +Ref: Ranges and Locales-Footnote-21073581 +Ref: Ranges and Locales-Footnote-31073815 +Node: Contributors1074036 +Node: History summary1079461 +Node: Installation1080830 +Node: Gawk Distribution1081781 +Node: Getting1082265 +Node: Extracting1083089 +Node: Distribution contents1084731 +Node: Unix Installation1090501 +Node: Quick Installation1091118 +Node: Additional Configuration Options1093560 +Node: Configuration Philosophy1095298 +Node: Non-Unix Installation1097649 +Node: PC Installation1098107 +Node: PC Binary Installation1099418 +Node: PC Compiling1101266 +Ref: PC Compiling-Footnote-11104265 +Node: PC Testing1104370 +Node: PC Using1105546 +Node: Cygwin1109698 +Node: MSYS1110507 +Node: VMS Installation1111021 +Node: VMS Compilation1111817 +Ref: VMS Compilation-Footnote-11113039 +Node: VMS Dynamic Extensions1113097 +Node: VMS Installation Details1114470 +Node: VMS Running1116722 +Node: VMS GNV1119556 +Node: VMS Old Gawk1120279 +Node: Bugs1120749 +Node: Other Versions1124753 +Node: Installation summary1130980 +Node: Notes1132036 +Node: Compatibility Mode1132901 +Node: Additions1133683 +Node: Accessing The Source1134608 +Node: Adding Code1136044 +Node: New Ports1142222 +Node: Derived Files1146703 +Ref: Derived Files-Footnote-11152178 +Ref: Derived Files-Footnote-21152212 +Ref: Derived Files-Footnote-31152808 +Node: Future Extensions1152922 +Node: Implementation Limitations1153528 +Node: Extension Design1154776 +Node: Old Extension Problems1155930 +Ref: Old Extension Problems-Footnote-11157447 +Node: Extension New Mechanism Goals1157504 +Ref: Extension New Mechanism Goals-Footnote-11160864 +Node: Extension Other Design Decisions1161053 +Node: Extension Future Growth1163159 +Node: Old Extension Mechanism1163995 +Node: Notes summary1165757 +Node: Basic Concepts1166943 +Node: Basic High Level1167624 +Ref: figure-general-flow1167896 +Ref: figure-process-flow1168495 +Ref: Basic High Level-Footnote-11171724 +Node: Basic Data Typing1171909 +Node: Glossary1175237 +Node: Copying1200389 +Node: GNU Free Documentation License1237945 +Node: Index1263081 End Tag Table |