diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 1577 |
1 files changed, 894 insertions, 683 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 2e18da5b..29af8ab4 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -2475,7 +2475,7 @@ The following list describes options mandated by the POSIX standard: `--bignum' Force arbitrary precision arithmetic on numbers. This option has no effect if `gawk' is not compiled to use the GNU MPFR and MP - libraries (*note Arbitrary Precision Arithmetic::). + libraries (*note Gawk and MPFR::). `-n' `--non-decimal-data' @@ -2743,13 +2743,14 @@ on the command-line with the `-f' option. In most `awk' implementations, you must supply a precise path name for each program file, unless the file is in the current directory. But in `gawk', if the file name supplied to the `-f' or `-i' options does not contain a -`/', then `gawk' searches a list of directories (called the "search -path"), one by one, looking for a file with the specified name. +directory separator `/', then `gawk' searches a list of directories +(called the "search path"), one by one, looking for a file with the +specified name. The search path is a string consisting of directory names separated by -colons. `gawk' gets its search path from the `AWKPATH' environment +colons(1). `gawk' gets its search path from the `AWKPATH' environment variable. If that variable does not exist, `gawk' uses a default path, -`.:/usr/local/share/awk'.(1) +`.:/usr/local/share/awk'.(2) The search path feature is particularly useful for building libraries of useful `awk' functions. The library files can be placed in a @@ -2790,7 +2791,9 @@ found, and `gawk' no longer needs to use `AWKPATH'. ---------- Footnotes ---------- - (1) Your version of `gawk' may use a different directory; it will + (1) Semicolons on MS-Windows and MS-DOS. + + (2) Your version of `gawk' may use a different directory; it will depend upon how `gawk' was built and installed. The actual directory is the value of `$(datadir)' generated when `gawk' was configured. You probably don't need to worry about this, though. @@ -9873,8 +9876,8 @@ with a pound sign (`#'). The following additional elements in the array are available to provide information about the MPFR and GMP libraries if your - version of `gawk' supports arbitrary precision numbers (*note - Arbitrary Precision Arithmetic::): + version of `gawk' supports arbitrary precision numbers (*note Gawk + and MPFR::): `PROCINFO["mpfr_version"]' The version of the GNU MPFR library. @@ -11272,9 +11275,10 @@ pound sign (`#'): SOURCE is duplicated into DEST. DEST is then sorted, leaving the indices of SOURCE unchanged. - When comparing strings, `IGNORECASE' affects the sorting. If the - SOURCE array contains subarrays as values (*note Arrays of - Arrays::), they will come last, after all scalar values. + When comparing strings, `IGNORECASE' affects the sorting (*note + Array Sorting Functions::). If the SOURCE array contains + subarrays as values (*note Arrays of Arrays::), they will come + last, after all scalar values. For example, if the contents of `a' are as follows: @@ -11313,7 +11317,7 @@ pound sign (`#'): `$0'. It returns the modified string as the result of the function and the original target string is _not_ changed. - `gensub()' is a general substitution function. It's purpose is to + `gensub()' is a general substitution function. Its purpose is to provide more features than the standard `sub()' and `gsub()' functions. @@ -16028,9 +16032,9 @@ groups in the `PROCINFO' array have the indices `"group1"' through However, we don't know in advance how many of these groups there are. This loop works by starting at one, concatenating the value with -`"group"', and then using `in' to see if that value is in the array. -Eventually, `i' is incremented past the last group in the array and the -loop exits. +`"group"', and then using `in' to see if that value is in the array +(*note Reference to Elements::). Eventually, `i' is incremented past +the last group in the array and the loop exits. The loop is also correct if there are _no_ supplementary groups; then the condition is false the first time it's tested, and the loop @@ -30024,9 +30028,9 @@ Index * ! (exclamation point), !~ operator <5>: Computed Regexps. (line 6) * ! (exclamation point), !~ operator <6>: Case-sensitivity. (line 26) * ! (exclamation point), !~ operator: Regexp Usage. (line 19) -* " (double quote) <1>: Quoting. (line 37) -* " (double quote): Read Terminal. (line 25) +* " (double quote) in shell commands: Read Terminal. (line 25) * " (double quote), in regexp constants: Computed Regexps. (line 28) +* " (double quote), in shell commands: Quoting. (line 37) * # (number sign), #! (executable scripts): Executable Scripts. (line 6) * # (number sign), commenting: Comments. (line 6) @@ -30042,13 +30046,13 @@ Index * & (ampersand), && operator: Boolean Ops. (line 57) * & (ampersand), gsub()/gensub()/sub() functions and: Gory Details. (line 6) -* ' (single quote) <1>: Quoting. (line 31) -* ' (single quote) <2>: Long. (line 33) * ' (single quote): One-shot. (line 15) +* ' (single quote) in gawk command lines: Long. (line 33) +* ' (single quote), in shell commands: Quoting. (line 31) * ' (single quote), vs. apostrophe: Comments. (line 27) * ' (single quote), with double quotes: Quoting. (line 53) -* () (parentheses) <1>: Profiling. (line 146) * () (parentheses): Regexp Operators. (line 79) +* () (parentheses), in a profile: Profiling. (line 146) * * (asterisk), * operator, as multiplication operator: Precedence. (line 55) * * (asterisk), * operator, as regexp operator: Regexp Operators. @@ -30086,8 +30090,9 @@ Index (line 15) * --disable-nls configuration option: Additional Configuration Options. (line 30) -* --dump-variables option <1>: Library Names. (line 45) * --dump-variables option: Options. (line 93) +* --dump-variables option, using for library functions: Library Names. + (line 45) * --exec option: Options. (line 125) * --field-separator option: Options. (line 21) * --file option: Options. (line 25) @@ -30130,12 +30135,12 @@ Index * -d option: Options. (line 93) * -E option: Options. (line 125) * -e option: Options. (line 117) -* -F option: Command Line Field Separator. - (line 6) * -f option: Options. (line 25) * -F option: Options. (line 21) * -f option: Long. (line 12) * -F option, -Ft sets FS to TAB: Options. (line 301) +* -F option, command line: Command Line Field Separator. + (line 6) * -f option, multiple uses: Options. (line 306) * -g option: Options. (line 147) * -h option: Options. (line 154) @@ -30155,7 +30160,7 @@ Index * -V option: Options. (line 293) * -v option: Options. (line 32) * -W option: Options. (line 46) -* . (period): Regexp Operators. (line 43) +* . (period), regexp operator: Regexp Operators. (line 43) * .gmo files: Explaining gettext. (line 41) * .gmo files, converting from .po: I18N Example. (line 62) * .gmo files, specifying directory of <1>: Programmer i18n. (line 47) @@ -30164,7 +30169,7 @@ Index * .po files: Explaining gettext. (line 36) * .po files, converting to .gmo: I18N Example. (line 62) * .pot files: Explaining gettext. (line 30) -* / (forward slash): Regexp. (line 10) +* / (forward slash) to enclose regular expressions: Regexp. (line 10) * / (forward slash), / operator: Precedence. (line 55) * / (forward slash), /= operator <1>: Precedence. (line 95) * / (forward slash), /= operator: Assignment Ops. (line 129) @@ -30208,11 +30213,9 @@ Index * ? (question mark), regexp operator <1>: GNU Regexp Operators. (line 59) * ? (question mark), regexp operator: Regexp Operators. (line 111) -* [] (square brackets): Regexp Operators. (line 55) -* \ (backslash) <1>: Regexp Operators. (line 18) -* \ (backslash) <2>: Quoting. (line 31) -* \ (backslash) <3>: Comments. (line 50) -* \ (backslash): Read Terminal. (line 25) +* [] (square brackets), regexp operator: Regexp Operators. (line 55) +* \ (backslash): Comments. (line 50) +* \ (backslash) in shell commands: Read Terminal. (line 25) * \ (backslash), \" escape sequence: Escape Sequences. (line 76) * \ (backslash), \' operator (gawk): GNU Regexp Operators. (line 56) @@ -30259,6 +30262,8 @@ Index * \ (backslash), in escape sequences, POSIX and: Escape Sequences. (line 112) * \ (backslash), in regexp constants: Computed Regexps. (line 28) +* \ (backslash), in shell commands: Quoting. (line 31) +* \ (backslash), regexp operator: Regexp Operators. (line 18) * ^ (caret), ^ operator: Precedence. (line 49) * ^ (caret), ^= operator <1>: Precedence. (line 95) * ^ (caret), ^= operator: Assignment Ops. (line 129) @@ -30276,6 +30281,8 @@ Index * _ord_init() user-defined function: Ordinal Functions. (line 16) * _pw_init() user-defined function: Passwd Functions. (line 105) * accessing fields: Fields. (line 6) +* accessing global variables from extensions: Symbol Table Access. + (line 6) * account information <1>: Group Functions. (line 6) * account information: Passwd Functions. (line 16) * actions: Action Overview. (line 6) @@ -30298,6 +30305,8 @@ Index * alarm clock example program: Alarm Program. (line 11) * alarm.awk program: Alarm Program. (line 31) * algorithms: Basic High Level. (line 68) +* allocating memory for extensions: Memory Allocation Functions. + (line 6) * Alpha (DEC): Manual History. (line 28) * amazing awk assembler (aaa): Glossary. (line 12) * amazingly workable formatter (awf): Glossary. (line 25) @@ -30313,13 +30322,20 @@ Index * and Boolean-logic operator: Boolean Ops. (line 6) * and() function (gawk): Bitwise Functions. (line 39) * ANSI: Glossary. (line 35) +* API informational variables: Extension API Informational Variables. + (line 6) +* API version: Extension Versioning. + (line 6) * arbitrary precision: Arbitrary Precision Arithmetic. (line 6) +* arbitrary precision integers: Arbitrary Precision Integers. + (line 6) * archeologists: Bugs. (line 6) -* ARGC/ARGV variables <1>: ARGC and ARGV. (line 6) +* arctangent: Numeric Functions. (line 11) * ARGC/ARGV variables: Auto-set. (line 11) * ARGC/ARGV variables, command-line arguments: Other Arguments. (line 12) +* ARGC/ARGV variables, how to use: ARGC and ARGV. (line 6) * ARGC/ARGV variables, portability and: Executable Scripts. (line 42) * ARGIND variable: Auto-set. (line 40) * ARGIND variable, command-line arguments: Other Arguments. (line 12) @@ -30329,36 +30345,50 @@ Index * arguments, command-line, invoking awk: Command Line. (line 6) * arguments, in function calls: Function Calls. (line 16) * arguments, processing: Getopt Function. (line 6) +* ARGV array, indexing into: Other Arguments. (line 12) * arithmetic operators: Arithmetic Ops. (line 6) +* array manipulation in extensions: Array Manipulation. (line 6) +* array members: Reference to Elements. + (line 6) +* array scanning order, controlling: Controlling Scanning. + (line 12) +* array, number of elements: String Functions. (line 194) * arrays: Arrays. (line 6) +* arrays of arrays: Arrays of Arrays. (line 6) +* arrays, an example of using: Array Example. (line 6) +* arrays, and IGNORECASE variable: Array Intro. (line 91) * arrays, as parameters to functions: Pass By Value/Reference. (line 47) * arrays, associative: Array Intro. (line 49) * arrays, associative, library functions and: Library Names. (line 57) * arrays, deleting entire contents: Delete. (line 39) -* arrays, elements, assigning: Assigning Elements. (line 6) +* arrays, elements that don't exist: Reference to Elements. + (line 23) +* arrays, elements, assigning values: Assigning Elements. (line 6) * arrays, elements, deleting: Delete. (line 6) -* arrays, elements, order of: Scanning an Array. (line 48) -* arrays, elements, referencing: Reference to Elements. - (line 6) +* arrays, elements, order of access by in operator: Scanning an Array. + (line 48) * arrays, elements, retrieving number of: String Functions. (line 32) * arrays, for statement and: Scanning an Array. (line 20) -* arrays, IGNORECASE variable and: Array Intro. (line 91) * arrays, indexing: Array Intro. (line 49) * arrays, merging into strings: Join Function. (line 6) * arrays, multidimensional: Multidimensional. (line 10) * arrays, multidimensional, scanning: Multiscanning. (line 11) -* arrays, names of: Arrays. (line 18) +* arrays, names of, and names of functions/variables: Arrays. (line 18) +* arrays, numeric subscripts: Numeric Array Subscripts. + (line 6) +* arrays, referencing elements: Reference to Elements. + (line 6) * arrays, scanning: Scanning an Array. (line 6) * arrays, sorting: Array Sorting Functions. (line 6) -* arrays, sorting, IGNORECASE variable and: Array Sorting Functions. +* arrays, sorting, and IGNORECASE variable: Array Sorting Functions. (line 83) * arrays, sparse: Array Intro. (line 70) -* arrays, subscripts: Numeric Array Subscripts. - (line 6) * arrays, subscripts, uninitialized variables as: Uninitialized Subscripts. (line 6) +* arrays, unassigned elements: Reference to Elements. + (line 18) * artificial intelligence, gawk and: Distribution contents. (line 52) * ASCII <1>: Glossary. (line 133) @@ -30376,6 +30406,8 @@ Index * assert() function (C library): Assert Function. (line 6) * assert() user-defined function: Assert Function. (line 28) * assertions: Assert Function. (line 6) +* assign values to variables, in debugger: Viewing And Changing Data. + (line 59) * assignment operators: Assignment Ops. (line 6) * assignment operators, evaluation order: Assignment Ops. (line 111) * assignment operators, lvalues/rvalues: Assignment Ops. (line 32) @@ -30394,6 +30426,7 @@ Index * asterisk (*), *= operator <1>: Precedence. (line 95) * asterisk (*), *= operator: Assignment Ops. (line 129) * atan2() function: Numeric Functions. (line 11) +* automatic displays, in debugger: Debugger Info. (line 24) * awf (amazingly workable formatter) program: Glossary. (line 25) * awk debugging, enabling: Options. (line 108) * awk language, POSIX version: Assignment Ops. (line 136) @@ -30455,10 +30488,8 @@ Index * awksed.awk program: Simple Sed. (line 25) * awkvars.out file: Options. (line 93) * b debugger command (alias for break): Breakpoint Control. (line 11) -* backslash (\) <1>: Regexp Operators. (line 18) -* backslash (\) <2>: Quoting. (line 31) -* backslash (\) <3>: Comments. (line 50) -* backslash (\): Read Terminal. (line 25) +* backslash (\): Comments. (line 50) +* backslash (\) in shell commands: Read Terminal. (line 25) * backslash (\), \" escape sequence: Escape Sequences. (line 76) * backslash (\), \' operator (gawk): GNU Regexp Operators. (line 56) @@ -30505,13 +30536,15 @@ Index * backslash (\), in escape sequences, POSIX and: Escape Sequences. (line 112) * backslash (\), in regexp constants: Computed Regexps. (line 28) +* backslash (\), in shell commands: Quoting. (line 31) +* backslash (\), regexp operator: Regexp Operators. (line 18) * backtrace debugger command: Execution Stack. (line 13) * Beebe, Nelson H.F. <1>: Other Versions. (line 78) * Beebe, Nelson H.F.: Acknowledgments. (line 60) -* BEGIN pattern <1>: Profiling. (line 62) +* BEGIN pattern <1>: Using BEGIN/END. (line 6) * BEGIN pattern <2>: BEGIN/END. (line 6) -* BEGIN pattern <3>: Field Separators. (line 45) -* BEGIN pattern: Records. (line 29) +* BEGIN pattern: Field Separators. (line 45) +* BEGIN pattern, and profiling: Profiling. (line 62) * BEGIN pattern, assert() user-defined function and: Assert Function. (line 83) * BEGIN pattern, Boolean patterns and: Expression Patterns. (line 70) @@ -30545,7 +30578,12 @@ Index (line 33) * BINMODE variable <1>: PC Using. (line 33) * BINMODE variable: User-modified. (line 10) +* bit-manipulation functions: Bitwise Functions. (line 6) * bits2str() user-defined function: Bitwise Functions. (line 70) +* bitwise AND: Bitwise Functions. (line 39) +* bitwise complement: Bitwise Functions. (line 43) +* bitwise OR: Bitwise Functions. (line 49) +* bitwise XOR: Bitwise Functions. (line 55) * bitwise, complement: Bitwise Functions. (line 25) * bitwise, operations: Bitwise Functions. (line 6) * bitwise, shift: Bitwise Functions. (line 32) @@ -30574,6 +30612,14 @@ Index (line 6) * break debugger command: Breakpoint Control. (line 11) * break statement: Break Statement. (line 6) +* breakpoint: Debugging Terms. (line 33) +* breakpoint at location, how to delete: Breakpoint Control. (line 36) +* breakpoint commands: Debugger Execution Control. + (line 10) +* breakpoint condition: Breakpoint Control. (line 54) +* breakpoint, delete by number: Breakpoint Control. (line 64) +* breakpoint, how to disable or enable: Breakpoint Control. (line 69) +* breakpoint, setting: Breakpoint Control. (line 11) * Brennan, Michael <1>: Other Versions. (line 6) * Brennan, Michael <2>: Two-way I/O. (line 6) * Brennan, Michael <3>: Simple Sed. (line 25) @@ -30581,7 +30627,7 @@ Index * Brennan, Michael: Foreword. (line 83) * Brian Kernighan's awk <1>: I/O Functions. (line 40) * Brian Kernighan's awk <2>: Gory Details. (line 15) -* Brian Kernighan's awk <3>: String Functions. (line 489) +* Brian Kernighan's awk <3>: String Functions. (line 490) * Brian Kernighan's awk <4>: Delete. (line 48) * Brian Kernighan's awk <5>: Nextfile Statement. (line 47) * Brian Kernighan's awk <6>: Continue Statement. (line 43) @@ -30625,6 +30671,7 @@ Index (line 47) * call by value: Pass By Value/Reference. (line 18) +* call stack, display in debugger: Execution Stack. (line 13) * caret (^), ^ operator: Precedence. (line 49) * caret (^), ^= operator <1>: Precedence. (line 95) * caret (^), ^= operator: Assignment Ops. (line 129) @@ -30633,16 +30680,18 @@ Index (line 59) * caret (^), regexp operator: Regexp Operators. (line 22) * case keyword: Switch Statement. (line 6) +* case sensitivity, and regexps: User-modified. (line 82) +* case sensitivity, and string comparisons: User-modified. (line 82) * case sensitivity, array indices and: Array Intro. (line 91) -* case sensitivity, converting case: String Functions. (line 519) +* case sensitivity, converting case: String Functions. (line 520) * case sensitivity, example programs: Library Functions. (line 53) * case sensitivity, gawk: Case-sensitivity. (line 26) -* case sensitivity, regexps and <1>: User-modified. (line 82) * case sensitivity, regexps and: Case-sensitivity. (line 6) -* case sensitivity, string comparisons and: User-modified. (line 82) * CGI, awk scripts for: Options. (line 125) +* changing precision of a number: Changing Precision. (line 6) * character classes, See bracket expressions: Regexp Operators. (line 55) +* character lists in regular expression: Bracket Expressions. (line 6) * character lists, See bracket expressions: Regexp Operators. (line 55) * character sets (machine character encodings) <1>: Glossary. (line 133) * character sets (machine character encodings): Ordinal Functions. @@ -30664,12 +30713,12 @@ Index (line 6) * cliff_rand() user-defined function: Cliff Random Function. (line 12) +* close file or coprocess: I/O Functions. (line 10) * close() function <1>: I/O Functions. (line 10) -* close() function <2>: Close Files And Pipes. +* close() function: Close Files And Pipes. (line 18) -* close() function <3>: Getline/Pipe. (line 27) -* close() function: Getline/Variable/File. - (line 30) +* close() function, portability: Close Files And Pipes. + (line 81) * close() function, return value: Close Files And Pipes. (line 130) * close() function, two-way pipes and: Two-way I/O. (line 77) @@ -30683,6 +30732,7 @@ Index * columns, aligning: Print Examples. (line 70) * columns, cutting: Cut Program. (line 6) * comma (,), in range patterns: Ranges. (line 6) +* command completion, in debugger: Readline Support. (line 6) * command line, arguments <1>: ARGC and ARGV. (line 6) * command line, arguments <2>: Auto-set. (line 11) * command line, arguments: Other Arguments. (line 6) @@ -30692,16 +30742,16 @@ Index * command line, FS on, setting: Command Line Field Separator. (line 6) * command line, invoking awk from: Command Line. (line 6) -* command line, options <1>: Command Line Field Separator. - (line 6) -* command line, options <2>: Options. (line 6) -* command line, options: Long. (line 12) +* command line, option -f: Long. (line 12) +* command line, options: Options. (line 6) * command line, options, end of: Options. (line 54) * command line, variables, assigning on: Assignment Options. (line 6) * command-line options, processing: Getopt Function. (line 6) * command-line options, string extraction: String Extraction. (line 6) * commands debugger command: Debugger Execution Control. (line 10) +* commands to execute at breakpoint: Debugger Execution Control. + (line 10) * commenting: Comments. (line 6) * commenting, backslash continuation and: Statements/Lines. (line 76) * common extensions, ** operator: Arithmetic Ops. (line 30) @@ -30714,7 +30764,7 @@ Index * common extensions, delete to delete entire arrays: Delete. (line 39) * common extensions, func keyword: Definition Syntax. (line 83) * common extensions, length() applied to an array: String Functions. - (line 193) + (line 194) * common extensions, RS as a regexp: Records. (line 135) * common extensions, single character fields: Single Character Fields. (line 6) @@ -30753,25 +30803,33 @@ Index (line 35) * configuration options, gawk: Additional Configuration Options. (line 6) +* constant regexps: Regexp Usage. (line 57) * constants, floating-point: Floating-point Constants. (line 6) * constants, nondecimal: Nondecimal Data. (line 6) +* constants, numeric: Scalar Constants. (line 6) * constants, types of: Constants. (line 6) * context, floating-point: Floating-point Context. (line 6) +* continue program, in debugger: Debugger Execution Control. + (line 33) * continue statement: Continue Statement. (line 6) * control statements: Statements. (line 6) -* converting, case: String Functions. (line 519) -* converting, dates to timestamps: Time Functions. (line 75) -* converting, during subscripting: Numeric Array Subscripts. +* controlling array scanning order: Controlling Scanning. + (line 12) +* convert string to lower case: String Functions. (line 521) +* convert string to number: String Functions. (line 385) +* convert string to upper case: String Functions. (line 527) +* converting integer array subscripts: Numeric Array Subscripts. (line 31) +* converting, dates to timestamps: Time Functions. (line 75) * converting, numbers to strings <1>: Bitwise Functions. (line 109) * converting, numbers to strings: Conversion. (line 6) * converting, strings to numbers <1>: Bitwise Functions. (line 109) * converting, strings to numbers: Conversion. (line 6) * CONVFMT variable <1>: User-modified. (line 28) * CONVFMT variable: Conversion. (line 29) -* CONVFMT variable, array subscripts and: Numeric Array Subscripts. +* CONVFMT variable, and array subscripts: Numeric Array Subscripts. (line 6) * cookie: Glossary. (line 149) * coprocesses <1>: Two-way I/O. (line 44) @@ -30780,14 +30838,19 @@ Index (line 6) * coprocesses, getline from: Getline/Coprocess. (line 6) * cos() function: Numeric Functions. (line 15) +* cosine: Numeric Functions. (line 15) * counting: Wc Program. (line 6) * csh utility: Statements/Lines. (line 44) * csh utility, POSIXLY_CORRECT environment variable: Options. (line 348) * csh utility, |& operator, comparison with: Two-way I/O. (line 44) * ctime() user-defined function: Function Example. (line 73) * currency symbols, localization: Explaining gettext. (line 103) +* current system time: Time Functions. (line 65) * custom.h file: Configuration Philosophy. (line 30) +* customized input parser: Input Parsers. (line 6) +* customized output wrapper: Output Wrappers. (line 6) +* customized two-way processor: Two-way processors. (line 6) * cut utility: Cut Program. (line 6) * cut.awk program: Cut Program. (line 45) * d debugger command (alias for delete): Breakpoint Control. (line 64) @@ -30821,7 +30884,7 @@ Index (line 20) * dark corner, input files: Records. (line 118) * dark corner, invoking awk: Command Line. (line 16) -* dark corner, length() function: String Functions. (line 179) +* dark corner, length() function: String Functions. (line 180) * dark corner, locale's decimal point character: Conversion. (line 77) * dark corner, multiline records: Multiple Line. (line 35) * dark corner, NF variable, decrementing: Changing Fields. (line 107) @@ -30832,7 +30895,7 @@ Index (line 147) * dark corner, regexp constants, as arguments to user-defined functions: Using Constant Regexps. (line 43) -* dark corner, split() function: String Functions. (line 358) +* dark corner, split() function: String Functions. (line 359) * dark corner, strings, storing: Records. (line 210) * dark corner, value of ARGV[0]: Auto-set. (line 35) * data, fixed-width: Constant Size. (line 10) @@ -30951,6 +31014,12 @@ Index (line 67) * debugger commands, watch: Viewing And Changing Data. (line 67) +* debugger history file: Debugger Info. (line 80) +* debugger history size: Debugger Info. (line 65) +* debugger options: Debugger Info. (line 57) +* debugger prompt: Debugger Info. (line 77) +* debugger, how to start: Debugger Invocation. (line 6) +* debugger, read commands from a file: Debugger Info. (line 96) * debugging awk programs: Debugger. (line 6) * debugging gawk, bug reports: Bugs. (line 9) * decimal point character, locale specific: Options. (line 263) @@ -30959,12 +31028,18 @@ Index * Deifik, Scott <1>: Bugs. (line 70) * Deifik, Scott <2>: Contributors. (line 53) * Deifik, Scott: Acknowledgments. (line 60) +* delete ARRAY: Delete. (line 39) +* delete breakpoint at location: Breakpoint Control. (line 36) +* delete breakpoint by number: Breakpoint Control. (line 64) * delete debugger command: Breakpoint Control. (line 64) * delete statement: Delete. (line 6) +* delete watchpoint: Viewing And Changing Data. + (line 84) * deleting elements in arrays: Delete. (line 6) * deleting entire arrays: Delete. (line 39) * Demaille, Akim: Acknowledgments. (line 60) -* differences between gawk and awk: String Functions. (line 193) +* describe call stack frame, in debugger: Debugger Info. (line 27) +* differences between gawk and awk: String Functions. (line 194) * differences in awk and gawk, ARGC/ARGV variables: ARGC and ARGV. (line 88) * differences in awk and gawk, ARGIND variable: Auto-set. (line 40) @@ -31011,7 +31086,7 @@ Index (line 34) * differences in awk and gawk, LINT variable: User-modified. (line 98) * differences in awk and gawk, match() function: String Functions. - (line 256) + (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) @@ -31025,7 +31100,7 @@ Index * differences in awk and gawk, single-character fields: Single Character Fields. (line 6) * differences in awk and gawk, split() function: String Functions. - (line 346) + (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) @@ -31035,15 +31110,18 @@ Index (line 66) * directories, command line: Command line directories. (line 6) -* directories, searching <1>: Igawk Program. (line 368) -* directories, searching <2>: AWKLIBPATH Variable. (line 6) -* directories, searching: AWKPATH Variable. (line 6) +* directories, searching: Igawk Program. (line 368) +* directories, searching for shared libraries: AWKLIBPATH Variable. + (line 6) +* directories, searching for source files: AWKPATH Variable. (line 6) +* disable breakpoint: Breakpoint Control. (line 69) * disable debugger command: Breakpoint Control. (line 69) * display debugger command: Viewing And Changing Data. (line 8) +* display debugger options: Debugger Info. (line 57) * division: Arithmetic Ops. (line 44) -* do-while statement <1>: Do Statement. (line 6) -* do-while statement: Regexp Usage. (line 19) +* do-while statement: Do Statement. (line 6) +* do-while statement, use of regexps in: Regexp Usage. (line 19) * documentation, of awk programs: Library Names. (line 6) * documentation, online: Manual History. (line 11) * documents, searching: Dupword Program. (line 6) @@ -31053,35 +31131,46 @@ Index (line 30) * dollar sign ($), regexp operator: Regexp Operators. (line 35) * double precision floating-point: General Arithmetic. (line 21) -* double quote (") <1>: Quoting. (line 37) -* double quote ("): Read Terminal. (line 25) +* double quote (") in shell commands: Read Terminal. (line 25) * double quote ("), in regexp constants: Computed Regexps. (line 28) +* double quote ("), in shell commands: Quoting. (line 37) * down debugger command: Execution Stack. (line 21) * Drepper, Ulrich: Acknowledgments. (line 52) +* dump all variables of a program: Options. (line 93) * dump debugger command: Miscellaneous Debugger Commands. (line 9) * dupword.awk program: Dupword Program. (line 31) +* dynamic profiling: Profiling. (line 179) +* 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) * egrep utility <1>: Egrep Program. (line 6) * egrep utility: Bracket Expressions. (line 24) * egrep.awk program: Egrep Program. (line 54) -* elements in arrays: Reference to Elements. - (line 6) -* elements in arrays, assigning: Assigning Elements. (line 6) +* elements in arrays, assigning values: Assigning Elements. (line 6) * elements in arrays, deleting: Delete. (line 6) -* elements in arrays, order of: Scanning an Array. (line 48) +* elements in arrays, order of access by in operator: Scanning an Array. + (line 48) * elements in arrays, scanning: Scanning an Array. (line 6) +* elements of arrays: Reference to Elements. + (line 6) * email address for bug reports, bug-gawk@gnu.org: Bugs. (line 30) * EMISTERED: TCP/IP Networking. (line 6) +* empty array elements: Reference to Elements. + (line 18) * empty pattern: Empty. (line 6) +* empty strings: Records. (line 122) * empty strings, See null strings: Regexp Field Splitting. (line 43) +* enable breakpoint: Breakpoint Control. (line 73) * enable debugger command: Breakpoint Control. (line 73) * end debugger command: Debugger Execution Control. (line 10) -* END pattern <1>: Profiling. (line 62) +* END pattern <1>: Using BEGIN/END. (line 6) * END pattern: BEGIN/END. (line 6) +* END pattern, and profiling: Profiling. (line 62) * END pattern, assert() user-defined function and: Assert Function. (line 75) * END pattern, backslash continuation and: Egrep Program. (line 220) @@ -31101,7 +31190,9 @@ Index * endpwent() function (C library): Passwd Functions. (line 210) * endpwent() user-defined function: Passwd Functions. (line 213) * ENVIRON array: Auto-set. (line 60) -* environment variables: Auto-set. (line 60) +* environment variables used by gawk: Environment Variables. + (line 6) +* environment variables, in ENVIRON array: Auto-set. (line 60) * epoch, definition of: Glossary. (line 235) * equals sign (=), = operator: Assignment Ops. (line 6) * equals sign (=), == operator <1>: Precedence. (line 65) @@ -31109,19 +31200,21 @@ Index (line 11) * EREs (Extended Regular Expressions): Bracket Expressions. (line 24) * ERRNO variable <1>: TCP/IP Networking. (line 54) -* ERRNO variable <2>: Auto-set. (line 73) -* ERRNO variable <3>: BEGINFILE/ENDFILE. (line 26) -* ERRNO variable <4>: Close Files And Pipes. +* ERRNO variable: Auto-set. (line 73) +* ERRNO variable, with BEGINFILE pattern: BEGINFILE/ENDFILE. (line 26) +* ERRNO variable, with close() function: Close Files And Pipes. (line 138) -* ERRNO variable: Getline. (line 19) +* ERRNO variable, with getline command: Getline. (line 19) * error handling: Special FD. (line 16) * error handling, ERRNO variable and: Auto-set. (line 73) * error output: Special FD. (line 6) * escape processing, gsub()/gensub()/sub() functions: Gory Details. (line 6) -* escape sequences: Escape Sequences. (line 6) +* escape sequences, in strings: Escape Sequences. (line 6) * eval debugger command: Viewing And Changing Data. (line 23) +* evaluate expressions, in debugger: Viewing And Changing Data. + (line 23) * evaluation order: Increment Ops. (line 60) * evaluation order, concatenation: Concatenation. (line 41) * evaluation order, functions: Calling Built-in. (line 30) @@ -31144,9 +31237,12 @@ Index * exit statement: Exit Statement. (line 6) * exit status, of gawk: Exit Status. (line 6) * exit status, of VMS: VMS Running. (line 29) +* exit the debugger: Miscellaneous Debugger Commands. + (line 99) * exp() function: Numeric Functions. (line 18) * expand utility: Very Simple. (line 69) * Expat XML parser library: gawkextlib. (line 35) +* exponent: Numeric Functions. (line 18) * expressions: Expressions. (line 6) * expressions, as patterns: Expression Patterns. (line 6) * expressions, assignment: Assignment Ops. (line 6) @@ -31158,6 +31254,20 @@ Index (line 9) * expressions, selecting: Conditional Exp. (line 6) * Extended Regular Expressions (EREs): Bracket Expressions. (line 24) +* extension API: Extension API Description. + (line 6) +* extension API informational variables: Extension API Informational Variables. + (line 6) +* extension API version: Extension Versioning. + (line 6) +* extension API, version number: Auto-set. (line 229) +* extension example: Extension Example. (line 6) +* extension registration: Registration Functions. + (line 6) +* extension search path: Finding Extensions. (line 6) +* extensions distributed with gawk: Extension Samples. (line 6) +* extensions, allocating memory: Memory Allocation Functions. + (line 6) * extensions, Brian Kernighan's awk <1>: Common Extensions. (line 6) * extensions, Brian Kernighan's awk: BTL. (line 6) * extensions, common, ** operator: Arithmetic Ops. (line 30) @@ -31171,12 +31281,13 @@ Index * extensions, common, fflush() function: I/O Functions. (line 40) * extensions, common, func keyword: Definition Syntax. (line 83) * extensions, common, length() applied to an array: String Functions. - (line 193) + (line 194) * extensions, common, RS as a regexp: Records. (line 135) * extensions, common, single character fields: Single Character Fields. (line 6) * extensions, in gawk, not in POSIX awk: POSIX/GNU. (line 6) * extensions, mawk: Common Extensions. (line 6) +* extensions, where to find: gawkextlib. (line 6) * extract.awk program: Extract Program. (line 79) * extraction, of marked strings (internationalization): String Extraction. (line 6) @@ -31194,16 +31305,16 @@ Index * field numbers: Nonconstant Fields. (line 6) * field operator $: Fields. (line 19) * field operators, dollar sign as: Fields. (line 19) +* field separator, in multiline records: Multiple Line. (line 41) +* field separator, on command line: Command Line Field Separator. + (line 6) +* field separator, POSIX and: Field Splitting Summary. + (line 40) * field separators <1>: User-modified. (line 56) * field separators: Field Separators. (line 15) * field separators, choice of: Field Separators. (line 51) * field separators, FIELDWIDTHS variable and: User-modified. (line 35) * field separators, FPAT variable and: User-modified. (line 45) -* field separators, in multiline records: Multiple Line. (line 41) -* field separators, on command line: Command Line Field Separator. - (line 6) -* field separators, POSIX and <1>: Field Splitting Summary. - (line 40) * field separators, POSIX and: Fields. (line 6) * field separators, regular expressions as <1>: Regexp Field Splitting. (line 6) @@ -31245,7 +31356,6 @@ Index * files, /inet/... (gawk): TCP/IP Networking. (line 6) * files, /inet4/... (gawk): TCP/IP Networking. (line 6) * files, /inet6/... (gawk): TCP/IP Networking. (line 6) -* files, as single records: Records. (line 219) * files, awk programs in: Long. (line 6) * files, awkprof.out: Profiling. (line 6) * files, awkvars.out: Options. (line 93) @@ -31284,6 +31394,8 @@ Index * files, source, search path for: Igawk Program. (line 368) * files, splitting: Split Program. (line 6) * files, Texinfo, extracting programs from: Extract Program. (line 6) +* find substring in string: String Functions. (line 151) +* finding extensions: Finding Extensions. (line 6) * finish debugger command: Debugger Execution Control. (line 39) * Fish, Fred: Contributors. (line 50) @@ -31295,6 +31407,7 @@ Index * floating-point, numbers, arbitrary precision: Arbitrary Precision Arithmetic. (line 6) * floating-point, VAX/VMS: VMS Running. (line 51) +* flush buffered output: I/O Functions. (line 25) * fnmatch() extension function: Extension Sample Fnmatch. (line 12) * FNR variable <1>: Auto-set. (line 103) @@ -31310,9 +31423,11 @@ Index * format specifiers, printf statement: Control Letters. (line 6) * format specifiers, strftime() function (gawk): Time Functions. (line 88) +* format time string: Time Functions. (line 48) * formats, numeric output: OFMT. (line 6) * formatting output: Printf. (line 6) -* forward slash (/): Regexp. (line 10) +* formatting strings: String Functions. (line 378) +* forward slash (/) to enclose regular expressions: Regexp. (line 10) * forward slash (/), / operator: Precedence. (line 55) * forward slash (/), /= operator <1>: Precedence. (line 95) * forward slash (/), /= operator: Assignment Ops. (line 129) @@ -31341,6 +31456,7 @@ Index (line 6) * FS, containing ^: Regexp Field Splitting. (line 59) +* FS, in multiline records: Multiple Line. (line 41) * FSF (Free Software Foundation) <1>: Glossary. (line 297) * FSF (Free Software Foundation) <2>: Getting. (line 10) * FSF (Free Software Foundation): Manual History. (line 6) @@ -31349,6 +31465,7 @@ Index * FUNCTAB array: Auto-set. (line 119) * function calls: Function Calls. (line 6) * function calls, indirect: Indirect Calls. (line 6) +* function definition example: Function Example. (line 6) * function pointers: Indirect Calls. (line 6) * functions, arrays as parameters to: Pass By Value/Reference. (line 47) @@ -31386,7 +31503,7 @@ Index (line 71) * functions, user-defined: User-defined. (line 6) * functions, user-defined, calling: Function Caveats. (line 6) -* functions, user-defined, counts: Profiling. (line 137) +* functions, user-defined, counts, in a profile: Profiling. (line 137) * functions, user-defined, library of: Library Functions. (line 6) * functions, user-defined, next/nextfile statements and <1>: Nextfile Statement. (line 47) @@ -31395,6 +31512,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, ARGIND variable in: Other Arguments. (line 12) * gawk, awk and <1>: This Manual. (line 14) * gawk, awk and: Preface. (line 23) @@ -31403,7 +31521,7 @@ Index * gawk, built-in variables and: Built-in Variables. (line 14) * gawk, character classes and: Bracket Expressions. (line 90) * gawk, coding style in: Adding Code. (line 38) -* gawk, command-line options: GNU Regexp Operators. +* gawk, command-line options, and regular expressions: GNU Regexp Operators. (line 70) * gawk, comparison operators and: Comparison Operators. (line 50) @@ -31437,7 +31555,7 @@ Index * gawk, hexadecimal numbers and: Nondecimal-numbers. (line 42) * gawk, IGNORECASE variable in <1>: Array Sorting Functions. (line 83) -* gawk, IGNORECASE variable in <2>: String Functions. (line 32) +* gawk, IGNORECASE variable in <2>: String Functions. (line 48) * gawk, IGNORECASE variable in <3>: Array Intro. (line 91) * gawk, IGNORECASE variable in <4>: User-modified. (line 82) * gawk, IGNORECASE variable in: Case-sensitivity. (line 26) @@ -31472,9 +31590,7 @@ Index (line 6) * gawk, regular expressions, precedence: Regexp Operators. (line 161) * gawk, RT variable in <1>: Auto-set. (line 266) -* gawk, RT variable in <2>: Getline/Variable/File. - (line 10) -* gawk, RT variable in <3>: Multiple Line. (line 129) +* 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) @@ -31488,10 +31604,12 @@ Index * gawk, VMS version of: VMS Installation. (line 6) * gawk, word-boundary operator: GNU Regexp Operators. (line 63) +* gawkextlib: gawkextlib. (line 6) * gawkextlib project: gawkextlib. (line 6) * General Public License (GPL): Glossary. (line 306) * General Public License, See GPL: Manual History. (line 11) -* gensub() function (gawk) <1>: String Functions. (line 81) +* generate time values: Time Functions. (line 25) +* gensub() function (gawk) <1>: String Functions. (line 82) * gensub() function (gawk): Using Constant Regexps. (line 43) * gensub() function (gawk), escape processing: Gory Details. (line 6) @@ -31517,6 +31635,8 @@ Index * getline command, FILENAME variable and: Getline Notes. (line 19) * getline command, return values: Getline. (line 19) * getline command, variants: Getline Summary. (line 6) +* getline from a file: Getline/File. (line 6) +* getline into a variable: Getline/Variable. (line 6) * getline statement, BEGINFILE/ENDFILE patterns and: BEGINFILE/ENDFILE. (line 54) * getlocaltime() user-defined function: Getlocaltime Function. @@ -31540,8 +31660,7 @@ Index * git utility <3>: Other Versions. (line 29) * git utility: gawkextlib. (line 29) * git, use of for gawk source code: Derived Files. (line 6) -* GMP: Arbitrary Precision Arithmetic. - (line 6) +* GMP: Gawk and MPFR. (line 6) * GNITS mailing list: Acknowledgments. (line 52) * GNU awk, See gawk: Preface. (line 49) * GNU Free Documentation License: GNU Free Documentation License. @@ -31564,11 +31683,12 @@ 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) * groups, information about: Group Functions. (line 6) -* gsub() function <1>: String Functions. (line 134) +* gsub() function <1>: String Functions. (line 135) * gsub() function: Using Constant Regexps. (line 43) -* gsub() function, arguments of: String Functions. (line 459) +* gsub() function, arguments of: String Functions. (line 460) * gsub() function, escape processing: Gory Details. (line 6) * h debugger command (alias for help): Miscellaneous Debugger Commands. (line 66) @@ -31582,9 +31702,10 @@ Index (line 66) * hexadecimal numbers: Nondecimal-numbers. (line 6) * hexadecimal values, enabling interpretation of: Options. (line 207) +* history expansion, in debugger: Readline Support. (line 6) * histsort.awk program: History Sorting. (line 25) * Hughes, Phil: Acknowledgments. (line 43) -* HUP signal: Profiling. (line 211) +* HUP signal, for dynamic profiling: Profiling. (line 211) * hyphen (-), - operator: Precedence. (line 52) * hyphen (-), -- operator <1>: Precedence. (line 46) * hyphen (-), -- operator: Increment Ops. (line 48) @@ -31597,38 +31718,37 @@ Index * id.awk program: Id Program. (line 30) * IEEE-754 format: Floating-point Representation. (line 6) -* if statement <1>: If Statement. (line 6) -* if statement: Regexp Usage. (line 19) +* if statement: If Statement. (line 6) * if statement, actions, changing: Ranges. (line 25) +* if statement, use of regexps in: Regexp Usage. (line 19) * igawk.sh program: Igawk Program. (line 124) +* ignore breakpoint: Breakpoint Control. (line 87) * ignore debugger command: Breakpoint Control. (line 87) -* IGNORECASE variable <1>: Array Sorting Functions. - (line 83) -* IGNORECASE variable <2>: String Functions. (line 32) -* IGNORECASE variable <3>: Array Intro. (line 91) -* IGNORECASE variable <4>: User-modified. (line 82) -* IGNORECASE variable: Case-sensitivity. (line 26) -* IGNORECASE variable, array sorting and: Array Sorting Functions. +* IGNORECASE variable: User-modified. (line 82) +* IGNORECASE variable, and array indices: Array Intro. (line 91) +* IGNORECASE variable, and array sorting functions: Array Sorting Functions. (line 83) -* IGNORECASE variable, array subscripts and: Array Intro. (line 91) * IGNORECASE variable, in example programs: Library Functions. (line 53) +* IGNORECASE variable, ~ and !~ operators: Case-sensitivity. (line 26) * Illumos: Other Versions. (line 104) * Illumos, POSIX-compliant awk: Other Versions. (line 104) * implementation issues, gawk: Notes. (line 6) * implementation issues, gawk, debugging: Compatibility Mode. (line 6) * implementation issues, gawk, limits <1>: Redirection. (line 135) * implementation issues, gawk, limits: Getline Notes. (line 14) -* in operator <1>: Id Program. (line 93) -* in operator <2>: Scanning an Array. (line 17) -* in operator <3>: Reference to Elements. - (line 37) -* in operator <4>: For Statement. (line 75) -* in operator <5>: Precedence. (line 83) +* in operator <1>: For Statement. (line 75) +* in operator <2>: Precedence. (line 83) * in operator: Comparison Operators. (line 11) +* in operator, index existence in multidimensional arrays: Multidimensional. + (line 43) +* in operator, order of array access: Scanning an Array. (line 48) +* in operator, testing if array element exists: Reference to Elements. + (line 37) +* in operator, use in loops: Scanning an Array. (line 17) * increment operators: Increment Ops. (line 6) -* index() function: String Functions. (line 150) +* index() function: String Functions. (line 151) * indexing arrays: Array Intro. (line 49) * indirect function calls: Indirect Calls. (line 6) * infinite precision: Arbitrary Precision Arithmetic. @@ -31646,6 +31766,7 @@ Index * input files, running awk without: Read Terminal. (line 6) * input files, variable assignments and: Other Arguments. (line 19) * input pipeline: Getline/Pipe. (line 9) +* input record, length of: String Functions. (line 171) * input redirection: Getline/File. (line 6) * input, data, nondecimal: Nondecimal Data. (line 6) * input, explicit: Getline. (line 6) @@ -31654,14 +31775,18 @@ Index * input, splitting into records: Records. (line 6) * input, standard <1>: Special FD. (line 6) * input, standard: Read Terminal. (line 6) +* input/output functions: I/O Functions. (line 6) * input/output, binary: User-modified. (line 10) * input/output, from BEGIN and END: I/O And BEGIN/END. (line 6) * input/output, two-way: Two-way I/O. (line 44) * insomnia, cure for: Alarm Program. (line 6) * installation, VMS: VMS Installation. (line 6) * installing gawk: Installation. (line 6) +* instruction tracing, in debugger: Debugger Info. (line 89) * INT signal (MS-Windows): Profiling. (line 214) * int() function: Numeric Functions. (line 23) +* integer array indices: Numeric Array Subscripts. + (line 31) * integers: General Arithmetic. (line 6) * integers, arbitrary precision: Arbitrary Precision Integers. (line 6) @@ -31685,8 +31810,9 @@ Index * internationalizing a program: Explaining gettext. (line 6) * interpreted programs <1>: Glossary. (line 357) * interpreted programs: Basic High Level. (line 15) -* interval expressions: Regexp Operators. (line 116) +* interval expressions, regexp operator: Regexp Operators. (line 116) * inventory-shipped file: Sample Data Files. (line 32) +* invoke shell command: I/O Functions. (line 72) * isarray() function (gawk): Type Functions. (line 11) * ISO: Glossary. (line 368) * ISO 8859-1: Glossary. (line 133) @@ -31741,9 +31867,12 @@ Index * left angle bracket (<), <= operator <1>: Precedence. (line 65) * left angle bracket (<), <= operator: Comparison Operators. (line 11) +* left shift: Bitwise Functions. (line 46) * left shift, bitwise: Bitwise Functions. (line 32) * leftmost longest match: Multiple Line. (line 26) -* length() function: String Functions. (line 163) +* length of input record: String Functions. (line 171) +* length of string: String Functions. (line 164) +* length() function: String Functions. (line 164) * Lesser General Public License (LGPL): Glossary. (line 397) * LGPL (Lesser General Public License): Glossary. (line 397) * libmawk: Other Versions. (line 120) @@ -31793,10 +31922,12 @@ Index * Linux <1>: Glossary. (line 616) * Linux <2>: I18N Example. (line 55) * Linux: Manual History. (line 28) +* list all global variables, in debugger: Debugger Info. (line 48) * list debugger command: Miscellaneous Debugger Commands. (line 72) +* list function definitions, in debugger: Debugger Info. (line 30) * loading, library: Options. (line 173) -* local variables: Variable Scope. (line 6) +* local variables, in a function: Variable Scope. (line 6) * locale categories: Explaining gettext. (line 80) * locale decimal point character: Options. (line 263) * locale, definition of: Locales. (line 6) @@ -31805,6 +31936,7 @@ Index (line 6) * log files, timestamps in: Time Functions. (line 6) * log() function: Numeric Functions. (line 30) +* logarithm: Numeric Functions. (line 30) * logical false/true: Truth Values. (line 6) * logical operators, See Boolean expressions: Boolean Ops. (line 6) * login information: Passwd Functions. (line 16) @@ -31812,7 +31944,7 @@ Index * loops: While Statement. (line 6) * loops, break statement and: Break Statement. (line 6) * loops, continue statements and: For Statement. (line 64) -* loops, count for header: Profiling. (line 131) +* loops, count for header, in a profile: Profiling. (line 131) * loops, do-while: Do Statement. (line 6) * loops, exiting: Break Statement. (line 6) * loops, for, array scanning: Scanning an Array. (line 6) @@ -31832,9 +31964,10 @@ Index (line 6) * marked strings, extracting: String Extraction. (line 6) * Marx, Groucho: Increment Ops. (line 60) -* match() function: String Functions. (line 203) +* match regexp in string: String Functions. (line 204) +* match() function: String Functions. (line 204) * match() function, RSTART/RLENGTH variables: String Functions. - (line 220) + (line 221) * matching, expressions, See comparison expressions: Typing and Comparison. (line 9) * matching, leftmost longest: Multiple Line. (line 26) @@ -31844,6 +31977,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) * McPhee, Patrick: Contributors. (line 100) * message object files: Explaining gettext. (line 41) * message object files, converting from portable object files: I18N Example. @@ -31852,15 +31986,18 @@ Index (line 47) * message object files, specifying directory of: Explaining gettext. (line 53) +* 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) * mktime() function (gawk): Time Functions. (line 25) * modifiers, in format specifiers: Format Modifiers. (line 6) * monetary information, localization: Explaining gettext. (line 103) -* MPFR: Arbitrary Precision Arithmetic. - (line 6) +* MPFR: Gawk and MPFR. (line 6) * msgfmt utility: I18N Example. (line 62) * multiple precision: Arbitrary Precision Arithmetic. (line 6) +* multiple-line records: Multiple Line. (line 6) * n debugger command (alias for next): Debugger Execution Control. (line 43) * names, arrays/variables <1>: Library Names. (line 6) @@ -31911,6 +32048,8 @@ Index * ni debugger command (alias for nexti): Debugger Execution Control. (line 49) * noassign.awk program: Ignoring Assigns. (line 15) +* 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: Records. (line 6) @@ -31920,12 +32059,14 @@ Index * null strings <3>: Regexp Field Splitting. (line 43) * null strings: Records. (line 122) -* null strings, array elements and: Delete. (line 27) +* null strings in gawk arguments, quoting and: Quoting. (line 62) +* null strings, and deleting array elements: Delete. (line 27) * null strings, as array subscripts: Uninitialized Subscripts. (line 43) * null strings, converting numbers to strings: Conversion. (line 21) * null strings, matching: Gory Details. (line 164) -* null strings, quoting and: Quoting. (line 62) +* number as string of bits: Bitwise Functions. (line 109) +* number of array elements: String Functions. (line 194) * number sign (#), #! (executable scripts): Executable Scripts. (line 6) * number sign (#), commenting: Comments. (line 6) @@ -31940,9 +32081,9 @@ Index * numbers, floating-point: General Arithmetic. (line 6) * numbers, hexadecimal: Nondecimal-numbers. (line 6) * numbers, octal: Nondecimal-numbers. (line 6) -* numbers, random: Numeric Functions. (line 64) * numbers, rounding: Round Function. (line 6) -* numeric, constants: Scalar Constants. (line 6) +* numeric constants: Scalar Constants. (line 6) +* numeric functions: Numeric Functions. (line 6) * numeric, output format: OFMT. (line 6) * numeric, strings: Variable Typing. (line 6) * o debugger command (alias for option): Debugger Info. (line 57) @@ -31992,10 +32133,7 @@ Index * operators, word-boundary (gawk): GNU Regexp Operators. (line 63) * option debugger command: Debugger Info. (line 57) -* options, command-line <1>: Command Line Field Separator. - (line 6) -* options, command-line <2>: Options. (line 6) -* options, command-line: Long. (line 12) +* options, command-line: Options. (line 6) * options, command-line, end of: Options. (line 54) * options, command-line, invoking awk: Command Line. (line 6) * options, command-line, processing: Getopt Function. (line 6) @@ -32016,6 +32154,7 @@ Index * output record separator, See ORS variable: Output Separators. (line 20) * output redirection: Redirection. (line 6) +* output wrapper: Output Wrappers. (line 6) * output, buffering: I/O Functions. (line 29) * output, duplicating into files: Tee Program. (line 6) * output, files, closing: Close Files And Pipes. @@ -32029,14 +32168,15 @@ Index * p debugger command (alias for print): Viewing And Changing Data. (line 36) * P1003.1 POSIX standard: Glossary. (line 454) -* parentheses () <1>: Profiling. (line 146) +* parent process id of gawk process: Auto-set. (line 186) * parentheses (): Regexp Operators. (line 79) +* parentheses (), in a profile: Profiling. (line 146) * password file: Passwd Functions. (line 16) -* patsplit() function (gawk): String Functions. (line 290) +* patsplit() function (gawk): String Functions. (line 291) * patterns: Patterns and Actions. (line 6) * patterns, comparison expressions as: Expression Patterns. (line 14) -* patterns, counts: Profiling. (line 118) +* patterns, counts, in a profile: Profiling. (line 118) * patterns, default: Very Simple. (line 34) * patterns, empty: Empty. (line 6) * patterns, expressions as: Regexp Patterns. (line 6) @@ -32051,17 +32191,18 @@ Index * percent sign (%), % operator: Precedence. (line 55) * percent sign (%), %= operator <1>: Precedence. (line 95) * percent sign (%), %= operator: Assignment Ops. (line 129) -* period (.): Regexp Operators. (line 43) +* period (.), regexp operator: Regexp Operators. (line 43) * Perl: Future Extensions. (line 6) * Peters, Arno: Contributors. (line 85) * Peterson, Hal: Contributors. (line 39) -* pipes, closing: Close Files And Pipes. +* pipe, closing: Close Files And Pipes. (line 6) -* pipes, input: Getline/Pipe. (line 9) -* pipes, output: Redirection. (line 57) +* pipe, input: Getline/Pipe. (line 9) +* pipe, output: Redirection. (line 57) * Pitts, Dave <1>: Bugs. (line 73) * Pitts, Dave: Acknowledgments. (line 60) * Plauger, P.J.: Library Functions. (line 12) +* plug-in: Extension Intro. (line 6) * plus sign (+), + operator: Precedence. (line 52) * plus sign (+), ++ operator <1>: Precedence. (line 46) * plus sign (+), ++ operator: Increment Ops. (line 11) @@ -32086,7 +32227,7 @@ Index * portability, gawk: New Ports. (line 6) * portability, gettext library and: Explaining gettext. (line 10) * portability, internationalization and: I18N Portability. (line 6) -* portability, length() function: String Functions. (line 172) +* portability, length() function: String Functions. (line 173) * portability, new awk vs. old awk: Conversion. (line 55) * portability, next statement in user-defined functions: Pass By Value/Reference. (line 91) @@ -32094,7 +32235,7 @@ Index * portability, operators: Increment Ops. (line 60) * portability, operators, not in POSIX awk: Precedence. (line 98) * portability, POSIXLY_CORRECT environment variable: Options. (line 353) -* portability, substr() function: String Functions. (line 509) +* portability, substr() function: String Functions. (line 510) * portable object files <1>: Translator i18n. (line 6) * portable object files: Explaining gettext. (line 36) * portable object files, converting to message object files: I18N Example. @@ -32131,7 +32272,7 @@ Index * POSIX awk, FS variable and: User-modified. (line 66) * POSIX awk, function keyword in: Definition Syntax. (line 83) * POSIX awk, functions and, gsub()/sub(): Gory Details. (line 54) -* POSIX awk, functions and, length(): String Functions. (line 172) +* POSIX awk, functions and, length(): String Functions. (line 173) * POSIX awk, GNU long options and: Options. (line 15) * POSIX awk, interval expressions in: Regexp Operators. (line 135) * POSIX awk, next/nextfile statements and: Next Statement. (line 45) @@ -32164,6 +32305,8 @@ Index * print statement, See Also redirection, of output: Redirection. (line 17) * print statement, sprintf() function and: Round Function. (line 6) +* print variables, in debugger: Viewing And Changing Data. + (line 36) * printf debugger command: Viewing And Changing Data. (line 54) * printf statement <1>: Printf. (line 6) @@ -32183,22 +32326,30 @@ Index * printf statement, sprintf() function and: Round Function. (line 6) * printf statement, syntax of: Basic Printf. (line 6) * printing: Printing. (line 6) +* printing messages from extensions: Printing Messages. (line 6) * printing, list of options: Options. (line 154) * printing, mailing labels: Labels Program. (line 6) * printing, unduplicated lines of text: Uniq Program. (line 6) * printing, user information: Id Program. (line 6) * private variables: Library Names. (line 11) +* process group id of gawk process: Auto-set. (line 180) +* process id of gawk process: Auto-set. (line 183) * processes, two-way communications with: Two-way I/O. (line 23) * processing data: Basic High Level. (line 6) -* PROCINFO array <1>: Two-way I/O. (line 116) -* PROCINFO array <2>: Id Program. (line 15) -* PROCINFO array <3>: Group Functions. (line 6) -* PROCINFO array <4>: Passwd Functions. (line 6) -* PROCINFO array <5>: Time Functions. (line 47) -* PROCINFO array <6>: Auto-set. (line 133) -* PROCINFO array: Obsolete. (line 11) +* PROCINFO array <1>: Passwd Functions. (line 6) +* PROCINFO array <2>: Time Functions. (line 47) +* PROCINFO array: Auto-set. (line 133) +* 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, 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, definition of: Getting Started. (line 21) * programmers, attractiveness of: Two-way I/O. (line 6) * programming conventions, --non-decimal-data option: Nondecimal Data. @@ -32235,11 +32386,9 @@ Index * quit debugger command: Miscellaneous Debugger Commands. (line 99) * QUIT signal (MS-Windows): Profiling. (line 214) -* quoting <1>: Comments. (line 27) -* quoting <2>: Long. (line 26) -* quoting: Read Terminal. (line 25) -* quoting, rules for: Quoting. (line 6) -* quoting, tricks for: Quoting. (line 71) +* quoting in gawk command lines: Long. (line 26) +* quoting in gawk command lines, tricks for: Quoting. (line 71) +* quoting, for small awk programs: Comments. (line 27) * r debugger command (alias for run): Debugger Execution Control. (line 62) * Rakitzis, Byron: History Sorting. (line 25) @@ -32267,6 +32416,7 @@ Index * readfile() extension function: Extension Sample Readfile. (line 11) * readfile() user-defined function: Readfile Function. (line 30) +* reading input files: Reading Files. (line 6) * recipe for a programming language: History. (line 6) * record separators <1>: User-modified. (line 143) * record separators: Records. (line 14) @@ -32281,10 +32431,12 @@ Index * records, terminating: Records. (line 132) * records, treating files as: Records. (line 219) * recursive functions: Definition Syntax. (line 73) +* redirect gawk output, in debugger: Debugger Info. (line 72) * redirection of input: Getline/File. (line 6) * redirection of output: Redirection. (line 6) * reference counting, sorting arrays: Array Sorting Functions. (line 77) +* regexp: Regexp. (line 6) * regexp constants <1>: Comparison Operators. (line 102) * regexp constants <2>: Regexp Constants. (line 6) @@ -32295,7 +32447,8 @@ Index (line 28) * regexp constants, slashes vs. quotes: Computed Regexps. (line 28) * regexp constants, vs. string constants: Computed Regexps. (line 38) -* regexp, See regular expressions: Regexp. (line 6) +* register extension: Registration Functions. + (line 6) * regular expressions: Regexp. (line 6) * regular expressions as field separators: Field Separators. (line 51) * regular expressions, anchors in: Regexp Operators. (line 22) @@ -32330,6 +32483,7 @@ Index * regular expressions, searching for: Egrep Program. (line 6) * relational operators, See comparison operators: Typing and Comparison. (line 9) +* replace in string: String Functions. (line 406) * return debugger command: Debugger Execution Control. (line 54) * return statement, user-defined functions: Return Statement. (line 6) @@ -32350,10 +32504,11 @@ Index (line 11) * right angle bracket (>), >> operator (I/O) <1>: Precedence. (line 65) * right angle bracket (>), >> operator (I/O): Redirection. (line 50) +* 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, match() function and: String Functions. (line 220) +* RLENGTH variable, match() function and: String Functions. (line 221) * Robbins, Arnold <1>: Future Extensions. (line 6) * Robbins, Arnold <2>: Bugs. (line 32) * Robbins, Arnold <3>: Contributors. (line 139) @@ -32370,6 +32525,7 @@ Index * Robbins, Miriam <2>: Getline/Pipe. (line 39) * Robbins, Miriam: Acknowledgments. (line 78) * Rommel, Kai Uwe: Contributors. (line 42) +* round to nearest integer: Numeric Functions. (line 23) * round() user-defined function: Round Function. (line 16) * rounding mode, floating-point: Rounding Mode. (line 6) * rounding numbers: Round Function. (line 6) @@ -32381,11 +32537,9 @@ Index * RS variable, multiline records and: Multiple Line. (line 17) * rshift() function (gawk): Bitwise Functions. (line 52) * RSTART variable: Auto-set. (line 259) -* RSTART variable, match() function and: String Functions. (line 220) +* RSTART variable, match() function and: String Functions. (line 221) * RT variable <1>: Auto-set. (line 266) -* RT variable <2>: Getline/Variable/File. - (line 10) -* RT variable <3>: Multiple Line. (line 129) +* RT variable <2>: Multiple Line. (line 129) * RT variable: Records. (line 132) * Rubin, Paul <1>: Contributors. (line 15) * Rubin, Paul: History. (line 30) @@ -32395,29 +32549,35 @@ Index * rvalues/lvalues: Assignment Ops. (line 32) * s debugger command (alias for step): Debugger Execution Control. (line 68) +* sample debugging session: Sample Debugging Session. + (line 6) * sandbox mode: Options. (line 279) +* save debugger options: Debugger Info. (line 84) +* scalar or array: Type Functions. (line 11) * scalar values: Basic Data Typing. (line 13) +* scanning arrays: Scanning an Array. (line 6) +* scanning multidimensional arrays: Multiscanning. (line 11) * Schorr, Andrew <1>: Contributors. (line 131) * Schorr, Andrew: Acknowledgments. (line 60) * Schreiber, Bert: Acknowledgments. (line 38) * Schreiber, Rita: Acknowledgments. (line 38) +* search and replace in strings: String Functions. (line 82) +* search in string: String Functions. (line 151) * search paths <1>: VMS Running. (line 58) * search paths <2>: PC Using. (line 10) -* search paths <3>: Igawk Program. (line 368) -* search paths <4>: AWKLIBPATH Variable. (line 6) -* search paths: AWKPATH Variable. (line 6) +* search paths: Igawk Program. (line 368) * search paths, for shared libraries: AWKLIBPATH Variable. (line 6) * search paths, for source files <1>: VMS Running. (line 58) * search paths, for source files <2>: PC Using. (line 10) * search paths, for source files <3>: Igawk Program. (line 368) * search paths, for source files: AWKPATH Variable. (line 6) -* searching: String Functions. (line 150) * searching, files for regular expressions: Egrep Program. (line 6) * searching, for words: Dupword Program. (line 6) * sed utility <1>: Glossary. (line 12) * sed utility <2>: Simple Sed. (line 6) * sed utility: Field Splitting Summary. (line 46) +* seeding random number generator: Numeric Functions. (line 64) * semicolon (;), AWKPATH variable and: PC Using. (line 10) * semicolon (;), separating statements in actions <1>: Statements. (line 10) @@ -32434,8 +32594,18 @@ Index * separators, for records, regular expressions as: Records. (line 132) * separators, for statements in actions: Action Overview. (line 19) * separators, subscript: User-modified. (line 156) +* set breakpoint: Breakpoint Control. (line 11) * set debugger command: Viewing And Changing Data. (line 59) +* set directory of message catalogs: I18N Functions. (line 12) +* set watchpoint: Viewing And Changing Data. + (line 67) +* setting rounding mode: Setting Rounding Mode. + (line 6) +* setting working precision: Setting Precision. (line 6) +* shadowing of variable values: Definition Syntax. (line 61) +* shell quoting, double quote: Read Terminal. (line 25) +* shell quoting, rules for: Quoting. (line 6) * shells, piping commands into: Redirection. (line 142) * shells, quoting: Using Shell Variables. (line 12) @@ -32446,6 +32616,13 @@ Index (line 6) * shift, bitwise: Bitwise Functions. (line 32) * short-circuit operators: Boolean Ops. (line 57) +* show all source files, in debugger: Debugger Info. (line 45) +* show breakpoints: Debugger Info. (line 21) +* show function arguments, in debugger: Debugger Info. (line 18) +* show local variables, in debugger: Debugger Info. (line 34) +* show name of current source file, in debugger: Debugger Info. + (line 37) +* show watchpoints: Debugger Info. (line 51) * si debugger command (alias for stepi): Debugger Execution Control. (line 76) * side effects <1>: Increment Ops. (line 11) @@ -32491,31 +32668,36 @@ Index (line 56) * sidebar, Using close()'s Return Value: Close Files And Pipes. (line 128) -* SIGHUP signal: Profiling. (line 211) +* SIGHUP signal, for dynamic profiling: Profiling. (line 211) * SIGINT signal (MS-Windows): Profiling. (line 214) -* signals, HUP/SIGHUP: Profiling. (line 211) +* signals, HUP/SIGHUP, for profiling: Profiling. (line 211) * signals, INT/SIGINT (MS-Windows): Profiling. (line 214) * signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 214) -* signals, USR1/SIGUSR1: Profiling. (line 188) +* signals, USR1/SIGUSR1, for profiling: Profiling. (line 188) * signature program: Signature Program. (line 6) * SIGQUIT signal (MS-Windows): Profiling. (line 214) -* SIGUSR1 signal: Profiling. (line 188) +* SIGUSR1 signal, for dynamic profiling: Profiling. (line 188) * silent debugger command: Debugger Execution Control. (line 10) * sin() function: Numeric Functions. (line 75) +* sine: Numeric Functions. (line 75) * single precision floating-point: General Arithmetic. (line 21) -* single quote (') <1>: Quoting. (line 31) -* single quote (') <2>: Long. (line 33) * single quote ('): One-shot. (line 15) +* single quote (') in gawk command lines: Long. (line 33) +* single quote ('), in shell commands: Quoting. (line 31) * single quote ('), vs. apostrophe: Comments. (line 27) * single quote ('), with double quotes: Quoting. (line 53) * single-character fields: Single Character Fields. (line 6) +* single-step execution, in the debugger: Debugger Execution Control. + (line 43) * Skywalker, Luke: Undocumented. (line 6) * sleep utility: Alarm Program. (line 111) * sleep() extension function: Extension Sample Time. (line 23) * Solaris, POSIX-compliant awk: Other Versions. (line 96) +* sort array: String Functions. (line 32) +* sort array indices: String Functions. (line 32) * sort function, arrays, sorting: Array Sorting Functions. (line 6) * sort utility: Word Sorting. (line 50) @@ -32539,18 +32721,21 @@ Index * source files, search path for: Igawk Program. (line 368) * sparse arrays: Array Intro. (line 70) * Spencer, Henry: Glossary. (line 12) +* split string into array: String Functions. (line 291) * split utility: Split Program. (line 6) -* split() function: String Functions. (line 312) +* split() function: String Functions. (line 313) * split() function, array elements, deleting: Delete. (line 61) * split.awk program: Split Program. (line 30) -* sprintf() function <1>: String Functions. (line 377) +* sprintf() function <1>: String Functions. (line 378) * sprintf() function: OFMT. (line 15) * sprintf() function, OFMT variable and: User-modified. (line 124) * sprintf() function, print/printf statements and: Round Function. (line 6) * sqrt() function: Numeric Functions. (line 78) -* square brackets ([]): Regexp Operators. (line 55) +* square brackets ([]), regexp operator: Regexp Operators. (line 55) +* square root: Numeric Functions. (line 78) * srand() function: Numeric Functions. (line 82) +* stack frame: Debugging Terms. (line 10) * Stallman, Richard <1>: Glossary. (line 297) * Stallman, Richard <2>: Contributors. (line 23) * Stallman, Richard <3>: Acknowledgments. (line 18) @@ -32559,6 +32744,7 @@ Index * standard input <1>: Special FD. (line 6) * standard input: Read Terminal. (line 6) * standard output: Special FD. (line 6) +* starting the debugger: Debugger Invocation. (line 6) * stat() extension function: Extension Sample File Functions. (line 18) * statements, compound, control statements and: Statements. (line 10) @@ -32568,6 +32754,8 @@ Index (line 68) * stepi debugger command: Debugger Execution Control. (line 76) +* stop automatic display, in debugger: Viewing And Changing Data. + (line 80) * stream editors <1>: Simple Sed. (line 6) * stream editors: Field Splitting Summary. (line 46) @@ -32576,27 +32764,32 @@ Index * string constants, vs. regexp constants: Computed Regexps. (line 38) * string extraction (internationalization): String Extraction. (line 6) +* string length: String Functions. (line 164) * string operators: Concatenation. (line 8) +* string, regular expression match: String Functions. (line 204) +* string-manipulation functions: String Functions. (line 6) * string-matching operators: Regexp Usage. (line 19) +* string-translation functions: I18N Functions. (line 6) +* strings splitting, example: String Functions. (line 333) * strings, converting <1>: Bitwise Functions. (line 109) * strings, converting: Conversion. (line 6) +* strings, converting letter case: String Functions. (line 520) * strings, converting, numbers to: User-modified. (line 28) * strings, empty, See null strings: Records. (line 122) * strings, extracting: String Extraction. (line 6) * strings, for localization: Programmer i18n. (line 14) -* strings, length of: Scalar Constants. (line 20) +* strings, length limitations: Scalar Constants. (line 20) * strings, merging arrays into: Join Function. (line 6) * strings, null: Regexp Field Splitting. (line 43) * strings, numeric: Variable Typing. (line 6) -* strings, splitting: String Functions. (line 332) -* strtonum() function (gawk): String Functions. (line 384) +* strtonum() function (gawk): String Functions. (line 385) * strtonum() function (gawk), --non-decimal-data option and: Nondecimal Data. (line 36) -* sub() function <1>: String Functions. (line 405) +* sub() function <1>: String Functions. (line 406) * sub() function: Using Constant Regexps. (line 43) -* sub() function, arguments of: String Functions. (line 459) +* sub() function, arguments of: String Functions. (line 460) * sub() function, escape processing: Gory Details. (line 6) * subscript separators: User-modified. (line 156) * subscripts in arrays, multidimensional: Multidimensional. (line 10) @@ -32607,9 +32800,13 @@ Index * subscripts in arrays, uninitialized variables as: Uninitialized Subscripts. (line 6) * SUBSEP variable: User-modified. (line 156) -* SUBSEP variable, multidimensional arrays: Multidimensional. (line 16) -* substr() function: String Functions. (line 478) +* SUBSEP variable, and multidimensional arrays: Multidimensional. + (line 16) +* substitute in string: String Functions. (line 82) +* substr() function: String Functions. (line 479) +* substring: String Functions. (line 479) * Sumner, Andrew: Other Versions. (line 64) +* supplementary groups of gawk process: Auto-set. (line 234) * switch statement: Switch Statement. (line 6) * SYMTAB array: Auto-set. (line 274) * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops. @@ -32623,6 +32820,7 @@ Index * TCP/IP, support for: Special Network. (line 6) * tee utility: Tee Program. (line 6) * tee.awk program: Tee Program. (line 26) +* temporary breakpoint: Breakpoint Control. (line 90) * terminating records: Records. (line 132) * testbits.awk program: Bitwise Functions. (line 70) * testext extension: Extension Sample API Tests. @@ -32652,6 +32850,7 @@ Index * tilde (~), ~ operator <5>: Computed Regexps. (line 6) * tilde (~), ~ operator <6>: Case-sensitivity. (line 26) * tilde (~), ~ operator: Regexp Usage. (line 19) +* time functions: Time Functions. (line 6) * time, alarm clock example program: Alarm Program. (line 11) * time, localization and: Explaining gettext. (line 115) * time, managing: Getlocaltime Function. @@ -32662,12 +32861,15 @@ Index * timestamps, converting dates to: Time Functions. (line 75) * timestamps, formatted: Getlocaltime Function. (line 6) -* tolower() function: String Functions. (line 520) -* toupper() function: String Functions. (line 526) +* tolower() function: String Functions. (line 521) +* toupper() function: String Functions. (line 527) * tr utility: Translate Program. (line 6) * trace debugger command: Miscellaneous Debugger Commands. (line 108) +* traceback, display in debugger: Execution Stack. (line 13) +* translate string: I18N Functions. (line 22) * translate.awk program: Translate Program. (line 55) +* treating files, as single records: Records. (line 219) * troubleshooting, --non-decimal-data option: Options. (line 207) * troubleshooting, == operator: Comparison Operators. (line 37) @@ -32686,9 +32888,9 @@ Index * troubleshooting, gawk, fatal errors, function arguments: Calling Built-in. (line 16) * troubleshooting, getline function: File Checking. (line 25) -* troubleshooting, gsub()/sub() functions: String Functions. (line 469) -* troubleshooting, match() function: String Functions. (line 285) -* troubleshooting, patsplit() function: String Functions. (line 308) +* troubleshooting, gsub()/sub() functions: String Functions. (line 470) +* troubleshooting, match() function: String Functions. (line 286) +* troubleshooting, patsplit() function: String Functions. (line 309) * troubleshooting, print statement, omitting commas: Print Examples. (line 31) * troubleshooting, printing: Redirection. (line 118) @@ -32697,7 +32899,7 @@ Index * troubleshooting, regexp constants vs. string constants: Computed Regexps. (line 38) * troubleshooting, string concatenation: Concatenation. (line 26) -* troubleshooting, substr() function: String Functions. (line 496) +* troubleshooting, substr() function: String Functions. (line 497) * troubleshooting, system() function: I/O Functions. (line 94) * troubleshooting, typographical errors, global variables: Options. (line 98) @@ -32710,6 +32912,8 @@ Index * type conversion: Conversion. (line 21) * u debugger command (alias for until): Debugger Execution Control. (line 83) +* unassigned array elements: Reference to Elements. + (line 18) * undefined functions: Pass By Value/Reference. (line 71) * underscore (_), C macro: Explaining gettext. (line 70) @@ -32742,15 +32946,16 @@ Index (line 84) * up debugger command: Execution Stack. (line 33) * user database, reading: Passwd Functions. (line 6) -* user-defined, functions: User-defined. (line 6) -* user-defined, functions, counts: Profiling. (line 137) +* user-defined functions: User-defined. (line 6) +* user-defined, functions, counts, in a profile: Profiling. (line 137) * user-defined, variables: Variables. (line 6) * user-modifiable variables: User-modified. (line 6) * users, information about, printing: Id Program. (line 6) * users, information about, retrieving: Passwd Functions. (line 16) -* USR1 signal: Profiling. (line 188) +* USR1 signal, for dynamic profiling: Profiling. (line 188) * values, numeric: Basic Data Typing. (line 13) * values, string: Basic Data Typing. (line 13) +* variable assignments and input files: Other Arguments. (line 19) * variable typing: Typing and Comparison. (line 9) * variables <1>: Basic Data Typing. (line 6) @@ -32771,7 +32976,7 @@ Index * variables, global, for library functions: Library Names. (line 11) * variables, global, printing list of: Options. (line 93) * variables, initializing: Using Variables. (line 20) -* variables, local: Variable Scope. (line 6) +* 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) @@ -32782,6 +32987,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) * vertical bar (|): Regexp Operators. (line 69) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 65) * vertical bar (|), | operator (I/O): Getline/Pipe. (line 9) @@ -32805,12 +33014,13 @@ Index * warnings, issuing: Options. (line 182) * watch debugger command: Viewing And Changing Data. (line 67) +* watchpoint: Debugging Terms. (line 42) * wc utility: Wc Program. (line 6) * wc.awk program: Wc Program. (line 46) * Weinberger, Peter <1>: Contributors. (line 11) * Weinberger, Peter: History. (line 17) -* while statement <1>: While Statement. (line 6) -* while statement: Regexp Usage. (line 19) +* while statement: While Statement. (line 6) +* while statement, use of regexps in: Regexp Usage. (line 19) * whitespace, as field separators: Default Field Splitting. (line 6) * whitespace, functions, calling: Calling Built-in. (line 10) @@ -32908,488 +33118,489 @@ Node: When105754 Node: Invoking Gawk107901 Node: Command Line109364 Node: Options110147 -Ref: Options-Footnote-1125542 -Node: Other Arguments125567 -Node: Naming Standard Input128225 -Node: Environment Variables129319 -Node: AWKPATH Variable129877 -Ref: AWKPATH Variable-Footnote-1132635 -Node: AWKLIBPATH Variable132895 -Node: Other Environment Variables133613 -Node: Exit Status136576 -Node: Include Files137251 -Node: Loading Shared Libraries140820 -Node: Obsolete142184 -Node: Undocumented142881 -Node: Regexp143123 -Node: Regexp Usage144512 -Node: Escape Sequences146537 -Node: Regexp Operators152206 -Ref: Regexp Operators-Footnote-1159586 -Ref: Regexp Operators-Footnote-2159733 -Node: Bracket Expressions159831 -Ref: table-char-classes161721 -Node: GNU Regexp Operators164244 -Node: Case-sensitivity167967 -Ref: Case-sensitivity-Footnote-1170935 -Ref: Case-sensitivity-Footnote-2171170 -Node: Leftmost Longest171278 -Node: Computed Regexps172479 -Node: Reading Files175816 -Node: Records177818 -Ref: Records-Footnote-1187341 -Node: Fields187378 -Ref: Fields-Footnote-1190334 -Node: Nonconstant Fields190420 -Node: Changing Fields192626 -Node: Field Separators198585 -Node: Default Field Splitting201287 -Node: Regexp Field Splitting202404 -Node: Single Character Fields205746 -Node: Command Line Field Separator206805 -Node: Full Line Fields210147 -Ref: Full Line Fields-Footnote-1210655 -Node: Field Splitting Summary210701 -Ref: Field Splitting Summary-Footnote-1213800 -Node: Constant Size213901 -Node: Splitting By Content218508 -Ref: Splitting By Content-Footnote-1222257 -Node: Multiple Line222297 -Ref: Multiple Line-Footnote-1228144 -Node: Getline228323 -Node: Plain Getline230539 -Node: Getline/Variable232634 -Node: Getline/File233781 -Node: Getline/Variable/File235122 -Ref: Getline/Variable/File-Footnote-1236721 -Node: Getline/Pipe236808 -Node: Getline/Variable/Pipe239507 -Node: Getline/Coprocess240614 -Node: Getline/Variable/Coprocess241866 -Node: Getline Notes242603 -Node: Getline Summary245390 -Ref: table-getline-variants245798 -Node: Read Timeout246710 -Ref: Read Timeout-Footnote-1250451 -Node: Command line directories250508 -Node: Printing251138 -Node: Print252769 -Node: Print Examples254106 -Node: Output Separators256890 -Node: OFMT258906 -Node: Printf260264 -Node: Basic Printf261170 -Node: Control Letters262709 -Node: Format Modifiers266521 -Node: Printf Examples272530 -Node: Redirection275242 -Node: Special Files282216 -Node: Special FD282749 -Ref: Special FD-Footnote-1286374 -Node: Special Network286448 -Node: Special Caveats287298 -Node: Close Files And Pipes288094 -Ref: Close Files And Pipes-Footnote-1295077 -Ref: Close Files And Pipes-Footnote-2295225 -Node: Expressions295375 -Node: Values296507 -Node: Constants297183 -Node: Scalar Constants297863 -Ref: Scalar Constants-Footnote-1298722 -Node: Nondecimal-numbers298904 -Node: Regexp Constants301904 -Node: Using Constant Regexps302379 -Node: Variables305434 -Node: Using Variables306089 -Node: Assignment Options307813 -Node: Conversion309688 -Ref: table-locale-affects315188 -Ref: Conversion-Footnote-1315812 -Node: All Operators315921 -Node: Arithmetic Ops316551 -Node: Concatenation319056 -Ref: Concatenation-Footnote-1321844 -Node: Assignment Ops321964 -Ref: table-assign-ops326952 -Node: Increment Ops328283 -Node: Truth Values and Conditions331717 -Node: Truth Values332800 -Node: Typing and Comparison333849 -Node: Variable Typing334642 -Ref: Variable Typing-Footnote-1338539 -Node: Comparison Operators338661 -Ref: table-relational-ops339071 -Node: POSIX String Comparison342619 -Ref: POSIX String Comparison-Footnote-1343575 -Node: Boolean Ops343713 -Ref: Boolean Ops-Footnote-1347783 -Node: Conditional Exp347874 -Node: Function Calls349606 -Node: Precedence353200 -Node: Locales356869 -Node: Patterns and Actions357958 -Node: Pattern Overview359012 -Node: Regexp Patterns360681 -Node: Expression Patterns361224 -Node: Ranges365005 -Node: BEGIN/END368109 -Node: Using BEGIN/END368871 -Ref: Using BEGIN/END-Footnote-1371607 -Node: I/O And BEGIN/END371713 -Node: BEGINFILE/ENDFILE373995 -Node: Empty376909 -Node: Using Shell Variables377226 -Node: Action Overview379511 -Node: Statements381868 -Node: If Statement383722 -Node: While Statement385221 -Node: Do Statement387265 -Node: For Statement388421 -Node: Switch Statement391573 -Node: Break Statement393727 -Node: Continue Statement395717 -Node: Next Statement397510 -Node: Nextfile Statement399900 -Node: Exit Statement402555 -Node: Built-in Variables404971 -Node: User-modified406066 -Ref: User-modified-Footnote-1414424 -Node: Auto-set414486 -Ref: Auto-set-Footnote-1427567 -Ref: Auto-set-Footnote-2427772 -Node: ARGC and ARGV427828 -Node: Arrays431682 -Node: Array Basics433187 -Node: Array Intro434013 -Node: Reference to Elements438330 -Node: Assigning Elements440600 -Node: Array Example441091 -Node: Scanning an Array442823 -Node: Controlling Scanning445137 -Ref: Controlling Scanning-Footnote-1450224 -Node: Delete450540 -Ref: Delete-Footnote-1453305 -Node: Numeric Array Subscripts453362 -Node: Uninitialized Subscripts455545 -Node: Multidimensional457172 -Node: Multiscanning460265 -Node: Arrays of Arrays461854 -Node: Functions466494 -Node: Built-in467313 -Node: Calling Built-in468391 -Node: Numeric Functions470379 -Ref: Numeric Functions-Footnote-1474211 -Ref: Numeric Functions-Footnote-2474568 -Ref: Numeric Functions-Footnote-3474616 -Node: String Functions474885 -Ref: String Functions-Footnote-1497805 -Ref: String Functions-Footnote-2497934 -Ref: String Functions-Footnote-3498182 -Node: Gory Details498269 -Ref: table-sub-escapes499948 -Ref: table-sub-posix-92501302 -Ref: table-sub-proposed502653 -Ref: table-posix-sub504007 -Ref: table-gensub-escapes505552 -Ref: Gory Details-Footnote-1506728 -Ref: Gory Details-Footnote-2506779 -Node: I/O Functions506930 -Ref: I/O Functions-Footnote-1513920 -Node: Time Functions514067 -Ref: Time Functions-Footnote-1525000 -Ref: Time Functions-Footnote-2525068 -Ref: Time Functions-Footnote-3525226 -Ref: Time Functions-Footnote-4525337 -Ref: Time Functions-Footnote-5525449 -Ref: Time Functions-Footnote-6525676 -Node: Bitwise Functions525942 -Ref: table-bitwise-ops526504 -Ref: Bitwise Functions-Footnote-1530725 -Node: Type Functions530909 -Node: I18N Functions532060 -Node: User-defined533687 -Node: Definition Syntax534491 -Ref: Definition Syntax-Footnote-1539405 -Node: Function Example539474 -Ref: Function Example-Footnote-1542123 -Node: Function Caveats542145 -Node: Calling A Function542663 -Node: Variable Scope543618 -Node: Pass By Value/Reference546581 -Node: Return Statement550089 -Node: Dynamic Typing553070 -Node: Indirect Calls554001 -Node: Library Functions563688 -Ref: Library Functions-Footnote-1567201 -Ref: Library Functions-Footnote-2567344 -Node: Library Names567515 -Ref: Library Names-Footnote-1570988 -Ref: Library Names-Footnote-2571208 -Node: General Functions571294 -Node: Strtonum Function572322 -Node: Assert Function575252 -Node: Round Function578578 -Node: Cliff Random Function580119 -Node: Ordinal Functions581135 -Ref: Ordinal Functions-Footnote-1584212 -Ref: Ordinal Functions-Footnote-2584464 -Node: Join Function584675 -Ref: Join Function-Footnote-1586446 -Node: Getlocaltime Function586646 -Node: Readfile Function590387 -Node: Data File Management592226 -Node: Filetrans Function592858 -Node: Rewind Function596927 -Node: File Checking598314 -Node: Empty Files599408 -Node: Ignoring Assigns601638 -Node: Getopt Function603192 -Ref: Getopt Function-Footnote-1614495 -Node: Passwd Functions614698 -Ref: Passwd Functions-Footnote-1623676 -Node: Group Functions623764 -Node: Walking Arrays631848 -Node: Sample Programs633984 -Node: Running Examples634658 -Node: Clones635386 -Node: Cut Program636610 -Node: Egrep Program646461 -Ref: Egrep Program-Footnote-1654234 -Node: Id Program654344 -Node: Split Program657960 -Ref: Split Program-Footnote-1661479 -Node: Tee Program661607 -Node: Uniq Program664410 -Node: Wc Program671839 -Ref: Wc Program-Footnote-1676105 -Ref: Wc Program-Footnote-2676305 -Node: Miscellaneous Programs676397 -Node: Dupword Program677585 -Node: Alarm Program679616 -Node: Translate Program684423 -Ref: Translate Program-Footnote-1688810 -Ref: Translate Program-Footnote-2689058 -Node: Labels Program689192 -Ref: Labels Program-Footnote-1692563 -Node: Word Sorting692647 -Node: History Sorting696531 -Node: Extract Program698370 -Ref: Extract Program-Footnote-1705873 -Node: Simple Sed706001 -Node: Igawk Program709063 -Ref: Igawk Program-Footnote-1724220 -Ref: Igawk Program-Footnote-2724421 -Node: Anagram Program724559 -Node: Signature Program727627 -Node: Advanced Features728727 -Node: Nondecimal Data730613 -Node: Array Sorting732196 -Node: Controlling Array Traversal732893 -Node: Array Sorting Functions741177 -Ref: Array Sorting Functions-Footnote-1745046 -Node: Two-way I/O745240 -Ref: Two-way I/O-Footnote-1750672 -Node: TCP/IP Networking750754 -Node: Profiling753598 -Node: Internationalization761101 -Node: I18N and L10N762526 -Node: Explaining gettext763212 -Ref: Explaining gettext-Footnote-1768280 -Ref: Explaining gettext-Footnote-2768464 -Node: Programmer i18n768629 -Node: Translator i18n772831 -Node: String Extraction773625 -Ref: String Extraction-Footnote-1774586 -Node: Printf Ordering774672 -Ref: Printf Ordering-Footnote-1777454 -Node: I18N Portability777518 -Ref: I18N Portability-Footnote-1779967 -Node: I18N Example780030 -Ref: I18N Example-Footnote-1782668 -Node: Gawk I18N782740 -Node: Debugger783361 -Node: Debugging784332 -Node: Debugging Concepts784765 -Node: Debugging Terms786621 -Node: Awk Debugging789218 -Node: Sample Debugging Session790110 -Node: Debugger Invocation790630 -Node: Finding The Bug791963 -Node: List of Debugger Commands798450 -Node: Breakpoint Control799784 -Node: Debugger Execution Control803448 -Node: Viewing And Changing Data806808 -Node: Execution Stack810164 -Node: Debugger Info811631 -Node: Miscellaneous Debugger Commands815613 -Node: Readline Support820789 -Node: Limitations821620 -Node: Arbitrary Precision Arithmetic823872 -Ref: Arbitrary Precision Arithmetic-Footnote-1825521 -Node: General Arithmetic825669 -Node: Floating Point Issues827389 -Node: String Conversion Precision828270 -Ref: String Conversion Precision-Footnote-1829975 -Node: Unexpected Results830084 -Node: POSIX Floating Point Problems832237 -Ref: POSIX Floating Point Problems-Footnote-1836062 -Node: Integer Programming836100 -Node: Floating-point Programming837839 -Ref: Floating-point Programming-Footnote-1844170 -Ref: Floating-point Programming-Footnote-2844440 -Node: Floating-point Representation844704 -Node: Floating-point Context845869 -Ref: table-ieee-formats846708 -Node: Rounding Mode848092 -Ref: table-rounding-modes848571 -Ref: Rounding Mode-Footnote-1851586 -Node: Gawk and MPFR851765 -Node: Arbitrary Precision Floats853020 -Ref: Arbitrary Precision Floats-Footnote-1855463 -Node: Setting Precision855779 -Ref: table-predefined-precision-strings856465 -Node: Setting Rounding Mode858610 -Ref: table-gawk-rounding-modes859014 -Node: Floating-point Constants860201 -Node: Changing Precision861630 -Ref: Changing Precision-Footnote-1863027 -Node: Exact Arithmetic863201 -Node: Arbitrary Precision Integers866339 -Ref: Arbitrary Precision Integers-Footnote-1869354 -Node: Dynamic Extensions869501 -Node: Extension Intro870959 -Node: Plugin License872224 -Node: Extension Mechanism Outline872909 -Ref: load-extension873326 -Ref: load-new-function874804 -Ref: call-new-function875799 -Node: Extension API Description877814 -Node: Extension API Functions Introduction879101 -Node: General Data Types884028 -Ref: General Data Types-Footnote-1889723 -Node: Requesting Values890022 -Ref: table-value-types-returned890759 -Node: Memory Allocation Functions891713 -Ref: Memory Allocation Functions-Footnote-1894459 -Node: Constructor Functions894555 -Node: Registration Functions896313 -Node: Extension Functions896998 -Node: Exit Callback Functions899300 -Node: Extension Version String900549 -Node: Input Parsers901199 -Node: Output Wrappers910956 -Node: Two-way processors915466 -Node: Printing Messages917674 -Ref: Printing Messages-Footnote-1918751 -Node: Updating `ERRNO'918903 -Node: Accessing Parameters919642 -Node: Symbol Table Access920872 -Node: Symbol table by name921386 -Node: Symbol table by cookie923135 -Ref: Symbol table by cookie-Footnote-1927267 -Node: Cached values927330 -Ref: Cached values-Footnote-1930820 -Node: Array Manipulation930911 -Ref: Array Manipulation-Footnote-1932009 -Node: Array Data Types932048 -Ref: Array Data Types-Footnote-1934751 -Node: Array Functions934843 -Node: Flattening Arrays938679 -Node: Creating Arrays945531 -Node: Extension API Variables950256 -Node: Extension Versioning950892 -Node: Extension API Informational Variables952793 -Node: Extension API Boilerplate953879 -Node: Finding Extensions957683 -Node: Extension Example958243 -Node: Internal File Description958973 -Node: Internal File Ops963064 -Ref: Internal File Ops-Footnote-1974573 -Node: Using Internal File Ops974713 -Ref: Using Internal File Ops-Footnote-1977066 -Node: Extension Samples977332 -Node: Extension Sample File Functions978856 -Node: Extension Sample Fnmatch987341 -Node: Extension Sample Fork989110 -Node: Extension Sample Inplace990323 -Node: Extension Sample Ord992101 -Node: Extension Sample Readdir992937 -Node: Extension Sample Revout994469 -Node: Extension Sample Rev2way995062 -Node: Extension Sample Read write array995752 -Node: Extension Sample Readfile997635 -Node: Extension Sample API Tests998453 -Node: Extension Sample Time998978 -Node: gawkextlib1000342 -Node: Language History1003123 -Node: V7/SVR3.11004716 -Node: SVR41007036 -Node: POSIX1008478 -Node: BTL1009864 -Node: POSIX/GNU1010598 -Node: Feature History1016197 -Node: Common Extensions1029173 -Node: Ranges and Locales1030485 -Ref: Ranges and Locales-Footnote-11035102 -Ref: Ranges and Locales-Footnote-21035129 -Ref: Ranges and Locales-Footnote-31035363 -Node: Contributors1035584 -Node: Installation1040965 -Node: Gawk Distribution1041859 -Node: Getting1042343 -Node: Extracting1043169 -Node: Distribution contents1044861 -Node: Unix Installation1050566 -Node: Quick Installation1051183 -Node: Additional Configuration Options1053629 -Node: Configuration Philosophy1055365 -Node: Non-Unix Installation1057719 -Node: PC Installation1058177 -Node: PC Binary Installation1059476 -Node: PC Compiling1061324 -Node: PC Testing1064268 -Node: PC Using1065444 -Node: Cygwin1069612 -Node: MSYS1070421 -Node: VMS Installation1070935 -Node: VMS Compilation1071699 -Ref: VMS Compilation-Footnote-11072951 -Node: VMS Dynamic Extensions1073009 -Node: VMS Installation Details1074382 -Node: VMS Running1076633 -Node: VMS GNV1079467 -Node: VMS Old Gawk1080190 -Node: Bugs1080660 -Node: Other Versions1084578 -Node: Notes1090662 -Node: Compatibility Mode1091462 -Node: Additions1092245 -Node: Accessing The Source1093172 -Node: Adding Code1094612 -Node: New Ports1100657 -Node: Derived Files1104792 -Ref: Derived Files-Footnote-11110113 -Ref: Derived Files-Footnote-21110147 -Ref: Derived Files-Footnote-31110747 -Node: Future Extensions1110845 -Node: Implementation Limitations1111428 -Node: Extension Design1112680 -Node: Old Extension Problems1113834 -Ref: Old Extension Problems-Footnote-11115342 -Node: Extension New Mechanism Goals1115399 -Ref: Extension New Mechanism Goals-Footnote-11118764 -Node: Extension Other Design Decisions1118950 -Node: Extension Future Growth1121056 -Node: Old Extension Mechanism1121892 -Node: Basic Concepts1123632 -Node: Basic High Level1124313 -Ref: figure-general-flow1124584 -Ref: figure-process-flow1125183 -Ref: Basic High Level-Footnote-11128412 -Node: Basic Data Typing1128597 -Node: Glossary1131952 -Node: Copying1157181 -Node: GNU Free Documentation License1194738 -Node: Index1219875 +Ref: Options-Footnote-1125525 +Node: Other Arguments125550 +Node: Naming Standard Input128208 +Node: Environment Variables129302 +Node: AWKPATH Variable129860 +Ref: AWKPATH Variable-Footnote-1132641 +Ref: AWKPATH Variable-Footnote-2132686 +Node: AWKLIBPATH Variable132946 +Node: Other Environment Variables133664 +Node: Exit Status136627 +Node: Include Files137302 +Node: Loading Shared Libraries140871 +Node: Obsolete142235 +Node: Undocumented142932 +Node: Regexp143174 +Node: Regexp Usage144563 +Node: Escape Sequences146588 +Node: Regexp Operators152257 +Ref: Regexp Operators-Footnote-1159637 +Ref: Regexp Operators-Footnote-2159784 +Node: Bracket Expressions159882 +Ref: table-char-classes161772 +Node: GNU Regexp Operators164295 +Node: Case-sensitivity168018 +Ref: Case-sensitivity-Footnote-1170986 +Ref: Case-sensitivity-Footnote-2171221 +Node: Leftmost Longest171329 +Node: Computed Regexps172530 +Node: Reading Files175867 +Node: Records177869 +Ref: Records-Footnote-1187392 +Node: Fields187429 +Ref: Fields-Footnote-1190385 +Node: Nonconstant Fields190471 +Node: Changing Fields192677 +Node: Field Separators198636 +Node: Default Field Splitting201338 +Node: Regexp Field Splitting202455 +Node: Single Character Fields205797 +Node: Command Line Field Separator206856 +Node: Full Line Fields210198 +Ref: Full Line Fields-Footnote-1210706 +Node: Field Splitting Summary210752 +Ref: Field Splitting Summary-Footnote-1213851 +Node: Constant Size213952 +Node: Splitting By Content218559 +Ref: Splitting By Content-Footnote-1222308 +Node: Multiple Line222348 +Ref: Multiple Line-Footnote-1228195 +Node: Getline228374 +Node: Plain Getline230590 +Node: Getline/Variable232685 +Node: Getline/File233832 +Node: Getline/Variable/File235173 +Ref: Getline/Variable/File-Footnote-1236772 +Node: Getline/Pipe236859 +Node: Getline/Variable/Pipe239558 +Node: Getline/Coprocess240665 +Node: Getline/Variable/Coprocess241917 +Node: Getline Notes242654 +Node: Getline Summary245441 +Ref: table-getline-variants245849 +Node: Read Timeout246761 +Ref: Read Timeout-Footnote-1250502 +Node: Command line directories250559 +Node: Printing251189 +Node: Print252820 +Node: Print Examples254157 +Node: Output Separators256941 +Node: OFMT258957 +Node: Printf260315 +Node: Basic Printf261221 +Node: Control Letters262760 +Node: Format Modifiers266572 +Node: Printf Examples272581 +Node: Redirection275293 +Node: Special Files282267 +Node: Special FD282800 +Ref: Special FD-Footnote-1286425 +Node: Special Network286499 +Node: Special Caveats287349 +Node: Close Files And Pipes288145 +Ref: Close Files And Pipes-Footnote-1295128 +Ref: Close Files And Pipes-Footnote-2295276 +Node: Expressions295426 +Node: Values296558 +Node: Constants297234 +Node: Scalar Constants297914 +Ref: Scalar Constants-Footnote-1298773 +Node: Nondecimal-numbers298955 +Node: Regexp Constants301955 +Node: Using Constant Regexps302430 +Node: Variables305485 +Node: Using Variables306140 +Node: Assignment Options307864 +Node: Conversion309739 +Ref: table-locale-affects315239 +Ref: Conversion-Footnote-1315863 +Node: All Operators315972 +Node: Arithmetic Ops316602 +Node: Concatenation319107 +Ref: Concatenation-Footnote-1321895 +Node: Assignment Ops322015 +Ref: table-assign-ops327003 +Node: Increment Ops328334 +Node: Truth Values and Conditions331768 +Node: Truth Values332851 +Node: Typing and Comparison333900 +Node: Variable Typing334693 +Ref: Variable Typing-Footnote-1338590 +Node: Comparison Operators338712 +Ref: table-relational-ops339122 +Node: POSIX String Comparison342670 +Ref: POSIX String Comparison-Footnote-1343626 +Node: Boolean Ops343764 +Ref: Boolean Ops-Footnote-1347834 +Node: Conditional Exp347925 +Node: Function Calls349657 +Node: Precedence353251 +Node: Locales356920 +Node: Patterns and Actions358009 +Node: Pattern Overview359063 +Node: Regexp Patterns360732 +Node: Expression Patterns361275 +Node: Ranges365056 +Node: BEGIN/END368160 +Node: Using BEGIN/END368922 +Ref: Using BEGIN/END-Footnote-1371658 +Node: I/O And BEGIN/END371764 +Node: BEGINFILE/ENDFILE374046 +Node: Empty376960 +Node: Using Shell Variables377277 +Node: Action Overview379562 +Node: Statements381919 +Node: If Statement383773 +Node: While Statement385272 +Node: Do Statement387316 +Node: For Statement388472 +Node: Switch Statement391624 +Node: Break Statement393778 +Node: Continue Statement395768 +Node: Next Statement397561 +Node: Nextfile Statement399951 +Node: Exit Statement402606 +Node: Built-in Variables405022 +Node: User-modified406117 +Ref: User-modified-Footnote-1414475 +Node: Auto-set414537 +Ref: Auto-set-Footnote-1427601 +Ref: Auto-set-Footnote-2427806 +Node: ARGC and ARGV427862 +Node: Arrays431716 +Node: Array Basics433221 +Node: Array Intro434047 +Node: Reference to Elements438364 +Node: Assigning Elements440634 +Node: Array Example441125 +Node: Scanning an Array442857 +Node: Controlling Scanning445171 +Ref: Controlling Scanning-Footnote-1450258 +Node: Delete450574 +Ref: Delete-Footnote-1453339 +Node: Numeric Array Subscripts453396 +Node: Uninitialized Subscripts455579 +Node: Multidimensional457206 +Node: Multiscanning460299 +Node: Arrays of Arrays461888 +Node: Functions466528 +Node: Built-in467347 +Node: Calling Built-in468425 +Node: Numeric Functions470413 +Ref: Numeric Functions-Footnote-1474245 +Ref: Numeric Functions-Footnote-2474602 +Ref: Numeric Functions-Footnote-3474650 +Node: String Functions474919 +Ref: String Functions-Footnote-1497877 +Ref: String Functions-Footnote-2498006 +Ref: String Functions-Footnote-3498254 +Node: Gory Details498341 +Ref: table-sub-escapes500020 +Ref: table-sub-posix-92501374 +Ref: table-sub-proposed502725 +Ref: table-posix-sub504079 +Ref: table-gensub-escapes505624 +Ref: Gory Details-Footnote-1506800 +Ref: Gory Details-Footnote-2506851 +Node: I/O Functions507002 +Ref: I/O Functions-Footnote-1513992 +Node: Time Functions514139 +Ref: Time Functions-Footnote-1525072 +Ref: Time Functions-Footnote-2525140 +Ref: Time Functions-Footnote-3525298 +Ref: Time Functions-Footnote-4525409 +Ref: Time Functions-Footnote-5525521 +Ref: Time Functions-Footnote-6525748 +Node: Bitwise Functions526014 +Ref: table-bitwise-ops526576 +Ref: Bitwise Functions-Footnote-1530797 +Node: Type Functions530981 +Node: I18N Functions532132 +Node: User-defined533759 +Node: Definition Syntax534563 +Ref: Definition Syntax-Footnote-1539477 +Node: Function Example539546 +Ref: Function Example-Footnote-1542195 +Node: Function Caveats542217 +Node: Calling A Function542735 +Node: Variable Scope543690 +Node: Pass By Value/Reference546653 +Node: Return Statement550161 +Node: Dynamic Typing553142 +Node: Indirect Calls554073 +Node: Library Functions563760 +Ref: Library Functions-Footnote-1567273 +Ref: Library Functions-Footnote-2567416 +Node: Library Names567587 +Ref: Library Names-Footnote-1571060 +Ref: Library Names-Footnote-2571280 +Node: General Functions571366 +Node: Strtonum Function572394 +Node: Assert Function575324 +Node: Round Function578650 +Node: Cliff Random Function580191 +Node: Ordinal Functions581207 +Ref: Ordinal Functions-Footnote-1584284 +Ref: Ordinal Functions-Footnote-2584536 +Node: Join Function584747 +Ref: Join Function-Footnote-1586518 +Node: Getlocaltime Function586718 +Node: Readfile Function590459 +Node: Data File Management592298 +Node: Filetrans Function592930 +Node: Rewind Function596999 +Node: File Checking598386 +Node: Empty Files599480 +Node: Ignoring Assigns601710 +Node: Getopt Function603264 +Ref: Getopt Function-Footnote-1614567 +Node: Passwd Functions614770 +Ref: Passwd Functions-Footnote-1623748 +Node: Group Functions623836 +Node: Walking Arrays631920 +Node: Sample Programs634056 +Node: Running Examples634730 +Node: Clones635458 +Node: Cut Program636682 +Node: Egrep Program646533 +Ref: Egrep Program-Footnote-1654306 +Node: Id Program654416 +Node: Split Program658065 +Ref: Split Program-Footnote-1661584 +Node: Tee Program661712 +Node: Uniq Program664515 +Node: Wc Program671944 +Ref: Wc Program-Footnote-1676210 +Ref: Wc Program-Footnote-2676410 +Node: Miscellaneous Programs676502 +Node: Dupword Program677690 +Node: Alarm Program679721 +Node: Translate Program684528 +Ref: Translate Program-Footnote-1688915 +Ref: Translate Program-Footnote-2689163 +Node: Labels Program689297 +Ref: Labels Program-Footnote-1692668 +Node: Word Sorting692752 +Node: History Sorting696636 +Node: Extract Program698475 +Ref: Extract Program-Footnote-1705978 +Node: Simple Sed706106 +Node: Igawk Program709168 +Ref: Igawk Program-Footnote-1724325 +Ref: Igawk Program-Footnote-2724526 +Node: Anagram Program724664 +Node: Signature Program727732 +Node: Advanced Features728832 +Node: Nondecimal Data730718 +Node: Array Sorting732301 +Node: Controlling Array Traversal732998 +Node: Array Sorting Functions741282 +Ref: Array Sorting Functions-Footnote-1745151 +Node: Two-way I/O745345 +Ref: Two-way I/O-Footnote-1750777 +Node: TCP/IP Networking750859 +Node: Profiling753703 +Node: Internationalization761206 +Node: I18N and L10N762631 +Node: Explaining gettext763317 +Ref: Explaining gettext-Footnote-1768385 +Ref: Explaining gettext-Footnote-2768569 +Node: Programmer i18n768734 +Node: Translator i18n772936 +Node: String Extraction773730 +Ref: String Extraction-Footnote-1774691 +Node: Printf Ordering774777 +Ref: Printf Ordering-Footnote-1777559 +Node: I18N Portability777623 +Ref: I18N Portability-Footnote-1780072 +Node: I18N Example780135 +Ref: I18N Example-Footnote-1782773 +Node: Gawk I18N782845 +Node: Debugger783466 +Node: Debugging784437 +Node: Debugging Concepts784870 +Node: Debugging Terms786726 +Node: Awk Debugging789323 +Node: Sample Debugging Session790215 +Node: Debugger Invocation790735 +Node: Finding The Bug792068 +Node: List of Debugger Commands798555 +Node: Breakpoint Control799889 +Node: Debugger Execution Control803553 +Node: Viewing And Changing Data806913 +Node: Execution Stack810269 +Node: Debugger Info811736 +Node: Miscellaneous Debugger Commands815718 +Node: Readline Support820894 +Node: Limitations821725 +Node: Arbitrary Precision Arithmetic823977 +Ref: Arbitrary Precision Arithmetic-Footnote-1825626 +Node: General Arithmetic825774 +Node: Floating Point Issues827494 +Node: String Conversion Precision828375 +Ref: String Conversion Precision-Footnote-1830080 +Node: Unexpected Results830189 +Node: POSIX Floating Point Problems832342 +Ref: POSIX Floating Point Problems-Footnote-1836167 +Node: Integer Programming836205 +Node: Floating-point Programming837944 +Ref: Floating-point Programming-Footnote-1844275 +Ref: Floating-point Programming-Footnote-2844545 +Node: Floating-point Representation844809 +Node: Floating-point Context845974 +Ref: table-ieee-formats846813 +Node: Rounding Mode848197 +Ref: table-rounding-modes848676 +Ref: Rounding Mode-Footnote-1851691 +Node: Gawk and MPFR851870 +Node: Arbitrary Precision Floats853125 +Ref: Arbitrary Precision Floats-Footnote-1855568 +Node: Setting Precision855884 +Ref: table-predefined-precision-strings856570 +Node: Setting Rounding Mode858715 +Ref: table-gawk-rounding-modes859119 +Node: Floating-point Constants860306 +Node: Changing Precision861735 +Ref: Changing Precision-Footnote-1863132 +Node: Exact Arithmetic863306 +Node: Arbitrary Precision Integers866444 +Ref: Arbitrary Precision Integers-Footnote-1869459 +Node: Dynamic Extensions869606 +Node: Extension Intro871064 +Node: Plugin License872329 +Node: Extension Mechanism Outline873014 +Ref: load-extension873431 +Ref: load-new-function874909 +Ref: call-new-function875904 +Node: Extension API Description877919 +Node: Extension API Functions Introduction879206 +Node: General Data Types884133 +Ref: General Data Types-Footnote-1889828 +Node: Requesting Values890127 +Ref: table-value-types-returned890864 +Node: Memory Allocation Functions891818 +Ref: Memory Allocation Functions-Footnote-1894564 +Node: Constructor Functions894660 +Node: Registration Functions896418 +Node: Extension Functions897103 +Node: Exit Callback Functions899405 +Node: Extension Version String900654 +Node: Input Parsers901304 +Node: Output Wrappers911061 +Node: Two-way processors915571 +Node: Printing Messages917779 +Ref: Printing Messages-Footnote-1918856 +Node: Updating `ERRNO'919008 +Node: Accessing Parameters919747 +Node: Symbol Table Access920977 +Node: Symbol table by name921491 +Node: Symbol table by cookie923240 +Ref: Symbol table by cookie-Footnote-1927372 +Node: Cached values927435 +Ref: Cached values-Footnote-1930925 +Node: Array Manipulation931016 +Ref: Array Manipulation-Footnote-1932114 +Node: Array Data Types932153 +Ref: Array Data Types-Footnote-1934856 +Node: Array Functions934948 +Node: Flattening Arrays938784 +Node: Creating Arrays945636 +Node: Extension API Variables950361 +Node: Extension Versioning950997 +Node: Extension API Informational Variables952898 +Node: Extension API Boilerplate953984 +Node: Finding Extensions957788 +Node: Extension Example958348 +Node: Internal File Description959078 +Node: Internal File Ops963169 +Ref: Internal File Ops-Footnote-1974678 +Node: Using Internal File Ops974818 +Ref: Using Internal File Ops-Footnote-1977171 +Node: Extension Samples977437 +Node: Extension Sample File Functions978961 +Node: Extension Sample Fnmatch987446 +Node: Extension Sample Fork989215 +Node: Extension Sample Inplace990428 +Node: Extension Sample Ord992206 +Node: Extension Sample Readdir993042 +Node: Extension Sample Revout994574 +Node: Extension Sample Rev2way995167 +Node: Extension Sample Read write array995857 +Node: Extension Sample Readfile997740 +Node: Extension Sample API Tests998558 +Node: Extension Sample Time999083 +Node: gawkextlib1000447 +Node: Language History1003228 +Node: V7/SVR3.11004821 +Node: SVR41007141 +Node: POSIX1008583 +Node: BTL1009969 +Node: POSIX/GNU1010703 +Node: Feature History1016302 +Node: Common Extensions1029278 +Node: Ranges and Locales1030590 +Ref: Ranges and Locales-Footnote-11035207 +Ref: Ranges and Locales-Footnote-21035234 +Ref: Ranges and Locales-Footnote-31035468 +Node: Contributors1035689 +Node: Installation1041070 +Node: Gawk Distribution1041964 +Node: Getting1042448 +Node: Extracting1043274 +Node: Distribution contents1044966 +Node: Unix Installation1050671 +Node: Quick Installation1051288 +Node: Additional Configuration Options1053734 +Node: Configuration Philosophy1055470 +Node: Non-Unix Installation1057824 +Node: PC Installation1058282 +Node: PC Binary Installation1059581 +Node: PC Compiling1061429 +Node: PC Testing1064373 +Node: PC Using1065549 +Node: Cygwin1069717 +Node: MSYS1070526 +Node: VMS Installation1071040 +Node: VMS Compilation1071804 +Ref: VMS Compilation-Footnote-11073056 +Node: VMS Dynamic Extensions1073114 +Node: VMS Installation Details1074487 +Node: VMS Running1076738 +Node: VMS GNV1079572 +Node: VMS Old Gawk1080295 +Node: Bugs1080765 +Node: Other Versions1084683 +Node: Notes1090767 +Node: Compatibility Mode1091567 +Node: Additions1092350 +Node: Accessing The Source1093277 +Node: Adding Code1094717 +Node: New Ports1100762 +Node: Derived Files1104897 +Ref: Derived Files-Footnote-11110218 +Ref: Derived Files-Footnote-21110252 +Ref: Derived Files-Footnote-31110852 +Node: Future Extensions1110950 +Node: Implementation Limitations1111533 +Node: Extension Design1112785 +Node: Old Extension Problems1113939 +Ref: Old Extension Problems-Footnote-11115447 +Node: Extension New Mechanism Goals1115504 +Ref: Extension New Mechanism Goals-Footnote-11118869 +Node: Extension Other Design Decisions1119055 +Node: Extension Future Growth1121161 +Node: Old Extension Mechanism1121997 +Node: Basic Concepts1123737 +Node: Basic High Level1124418 +Ref: figure-general-flow1124689 +Ref: figure-process-flow1125288 +Ref: Basic High Level-Footnote-11128517 +Node: Basic Data Typing1128702 +Node: Glossary1132057 +Node: Copying1157286 +Node: GNU Free Documentation License1194843 +Node: Index1219980 End Tag Table |