[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, master, updated. gawk-4.1.0-3874-gc0dfb92
|
From: |
Arnold Robbins |
|
Subject: |
[SCM] gawk branch, master, updated. gawk-4.1.0-3874-gc0dfb92 |
|
Date: |
Fri, 24 Jan 2020 02:37:19 -0500 (EST) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, master has been updated
via c0dfb9269380ff5a90dbf6606f64989848304527 (commit)
from 1ef484e65a03a8360434c404c9a3006671bab2f7 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=c0dfb9269380ff5a90dbf6606f64989848304527
commit c0dfb9269380ff5a90dbf6606f64989848304527
Author: Arnold D. Robbins <address@hidden>
Date: Fri Jan 24 09:36:43 2020 +0200
Fix assertion error in sorted loops for SYMTAB/FUNCTAB.
diff --git a/ChangeLog b/ChangeLog
index aa2d9a7..48d1f64 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2020-01-23 Arnold D. Robbins <address@hidden>
+
+ * array.c (sort_up_value_type): Handle other types of nodes,
+ in case someone applies PROCINFO["sorted_in"] to SYMTAB or
+ FUNCTAB. This threw an assertion error if assertions were
+ enabled.
+ (asort_actual): Disallow SYMTAB and FUNCTAB as first arguments.
+ * TODO: Note that we should should eventually allow SYMTAB/FUNCTAB
+ passed to asort/asaorti if a destination array is provided. (The
+ current code breaks right now.)
+
2020-01-19 Arnold D. Robbins <address@hidden>
* profile.c (pp_top): New macro.
diff --git a/TODO b/TODO
index 59b57a2..c6aae80 100644
--- a/TODO
+++ b/TODO
@@ -1,4 +1,4 @@
-Tue Jul 16 20:33:19 IDT 2019
+Thu Jan 23 11:15:44 IST 2020
============================
There were too many files tracking different thoughts and ideas for
@@ -15,6 +15,9 @@ TODO
Minor Cleanups and Code Improvements
------------------------------------
+ Allow SYMTAB and FUNCTAB as arguments to asort/asorti if a
+ destination array is provided.
+
API:
??? #if !defined(GAWK) && !defined(GAWK_OMIT_CONVENIENCE_MACROS)
diff --git a/array.c b/array.c
index 43f8471..4f89457 100644
--- a/array.c
+++ b/array.c
@@ -832,6 +832,14 @@ asort_actual(int nargs, sort_context_t ctxt)
_("asort: first argument not an array") :
_("asorti: first argument not an array"));
}
+ else if (array == symbol_table)
+ fatal(ctxt == ASORT ?
+ _("asort: first argument cannot be SYMTAB") :
+ _("asorti: first argument cannot be SYMTAB"));
+ else if (array == func_table)
+ fatal(ctxt == ASORT ?
+ _("asort: first argument cannot be FUNCTAB") :
+ _("asorti: first argument cannot be FUNCTAB"));
if (dest != NULL) {
for (r = dest->parent_array; r != NULL; r = r->parent_array) {
@@ -1145,20 +1153,47 @@ static int
sort_up_value_type(const void *p1, const void *p2)
{
NODE *n1, *n2;
+ int n1_pos, n2_pos, i;
+
+ static const NODETYPE element_types[] = {
+ Node_builtin_func,
+ Node_func,
+ Node_ext_func,
+ Node_var_new,
+ Node_var,
+ Node_var_array,
+ Node_val,
+ Node_illegal
+ };
/* we want to compare the element values */
n1 = *((NODE *const *) p1 + 1);
n2 = *((NODE *const *) p2 + 1);
- /* 1. Arrays vs. scalar, scalar is less than array */
+ /* 1. Arrays vs. everything else, everything else is less than array */
if (n1->type == Node_var_array) {
/* return 0 if n2 is a sub-array too, else return 1 */
return (n2->type != Node_var_array);
}
if (n2->type == Node_var_array) {
- return -1; /* n1 (scalar) < n2 (sub-array) */
+ return -1; /* n1 (non-array) < n2 (sub-array) */
}
+ /* 2. Non scalars */
+ n1_pos = n2_pos = -1;
+ for (i = 0; element_types[i] != Node_illegal; i++) {
+ if (n1->type == element_types[i])
+ n1_pos = i;
+
+ if (n2->type == element_types[i])
+ n2_pos = i;
+ }
+
+ assert(n1_pos != -1 && n2_pos != -1);
+
+ if (n1->type != Node_val || n2->type != Node_val)
+ return (n1_pos - n2_pos);
+
/* two scalars */
(void) fixtype(n1);
(void) fixtype(n2);
diff --git a/doc/ChangeLog b/doc/ChangeLog
index d1a976d..c826543 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2020-01-23 Arnold D. Robbins <address@hidden>
+
+ * gawktexi.in: Document arry sorting by value for FUNCTAB.
+ Document that SYMTAB and FUNCTAB cannot be used with
+ asort() or asorti().
+
2020-01-19 Arnold D. Robbins <address@hidden>
* gawktexi.in (Escape Sequences): Stronger wording for \/
diff --git a/doc/gawk.info b/doc/gawk.info
index c9bf229..999ee49 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -11969,6 +11969,12 @@ available:
string values, which in turn come before all subarrays. (Subarrays
have not been described yet; *note Arrays of Arrays::.)
+ If you choose to use this feature in traversing 'FUNCTAB' (*note
+ Auto-set::), then the order is built-in functions first (*note
+ Built-in::), then user-defined functions (*note User-defined::)
+ next, and finally functions loaded from an extension (*note Dynamic
+ Extensions::).
+
'"@val_str_asc"'
Order by element values in ascending order (rather than by
indices). Scalar values are compared as strings. Subarrays, if
@@ -12849,6 +12855,12 @@ Options::):
a[2] = "last"
a[3] = "middle"
+ NOTE: Due to implementation limitations, you may not use
+ either 'SYMTAB' or 'FUNCTAB' as arguments to these functions,
+ even if providing a second array to use for the actual
+ sorting. Attempting to do so produces a fatal error. This
+ restriction may be lifted in the future.
+
'gensub(REGEXP, REPLACEMENT, HOW' [', TARGET']') #'
Search the target string TARGET for matches of the regular
expression REGEXP. If HOW is a string beginning with 'g' or 'G'
@@ -33729,7 +33741,7 @@ Index
* * (asterisk), *= operator <1>: Precedence. (line 94)
* * (asterisk), **= operator <1>: Precedence. (line 94)
* * (asterisk), * operator, null strings, matching: String Functions.
- (line 542)
+ (line 548)
* + (plus sign), regexp operator: Regexp Operator Details.
(line 107)
* + (plus sign), += operator: Assignment Ops. (line 81)
@@ -34107,7 +34119,7 @@ Index
* arrays, multidimensional, scanning: Multiscanning. (line 11)
* arrays, arrays of arrays: Arrays of Arrays. (line 6)
* arrays, elements, retrieving number of: String Functions. (line 42)
-* arrays, number of elements: String Functions. (line 201)
+* arrays, number of elements: String Functions. (line 207)
* arrays, as parameters to functions: Pass By Value/Reference.
(line 44)
* arrays, associative, library functions and: Library Names. (line 58)
@@ -34166,7 +34178,7 @@ Index
* asterisk (*), *= operator <1>: Precedence. (line 94)
* asterisk (*), **= operator <1>: Precedence. (line 94)
* asterisk (*), * operator, null strings, matching: String Functions.
- (line 542)
+ (line 548)
* at-sign (@), @include directive: Include Files. (line 8)
* at-sign (@), @load directive: Loading Shared Libraries.
(line 8)
@@ -34411,7 +34423,7 @@ Index
* Brian Kernighan's awk <9>: Continue Statement. (line 44)
* Brian Kernighan's awk <10>: Nextfile Statement. (line 47)
* Brian Kernighan's awk <11>: Delete. (line 51)
-* Brian Kernighan's awk <12>: String Functions. (line 498)
+* Brian Kernighan's awk <12>: String Functions. (line 504)
* Brian Kernighan's awk <13>: Gory Details. (line 19)
* Brian Kernighan's awk <14>: I/O Functions. (line 43)
* Brian Kernighan's awk, extensions: BTL. (line 6)
@@ -34474,7 +34486,7 @@ Index
* case sensitivity, string comparisons and: User-modified. (line 79)
* case sensitivity, regexps and <1>: User-modified. (line 79)
* case sensitivity, array indices and: Array Intro. (line 100)
-* case sensitivity, converting case: String Functions. (line 528)
+* case sensitivity, converting case: String Functions. (line 534)
* case sensitivity, example programs: Library Functions. (line 53)
* CGI, awk scripts for: Options. (line 147)
* character sets (machine character encodings): Ordinal Functions.
@@ -34552,7 +34564,7 @@ Index
* common extensions, **= operator: Assignment Ops. (line 138)
* common extensions, delete to delete entire arrays: Delete. (line 39)
* common extensions, length() applied to an array: String Functions.
- (line 201)
+ (line 207)
* common extensions, func keyword: Definition Syntax. (line 99)
* common extensions, BINMODE variable: PC Using. (line 20)
* comp.lang.awk newsgroup: Usenet. (line 11)
@@ -34610,9 +34622,9 @@ Index
* converting, numbers to strings: Strings And Numbers. (line 6)
* converting, integer array subscripts to strings: Numeric Array Subscripts.
(line 31)
-* converting, string to numbers <1>: String Functions. (line 396)
-* converting, string to lower case: String Functions. (line 529)
-* converting, string to upper case: String Functions. (line 535)
+* converting, string to numbers <1>: String Functions. (line 402)
+* converting, string to lower case: String Functions. (line 535)
+* converting, string to upper case: String Functions. (line 541)
* converting, dates to timestamps: Time Functions. (line 78)
* converting, string to numbers <2>: Bitwise Functions. (line 109)
* converting, numbers to strings <1>: Bitwise Functions. (line 109)
@@ -34695,9 +34707,9 @@ Index
* dark corner, array subscripts: Uninitialized Subscripts.
(line 43)
* dark corner, regexp as second argument to index(): String Functions.
- (line 165)
-* dark corner, length() function: String Functions. (line 187)
-* dark corner, split() function: String Functions. (line 366)
+ (line 171)
+* dark corner, length() function: String Functions. (line 193)
+* dark corner, split() function: String Functions. (line 372)
* dark corner <1>: Glossary. (line 266)
* data, fixed-width: Constant Size. (line 6)
* data-driven languages: Basic High Level. (line 74)
@@ -34945,11 +34957,11 @@ Index
* differences in awk and gawk, function arguments: Calling Built-in.
(line 16)
* differences in awk and gawk, length() function: String Functions.
- (line 201)
+ (line 207)
* differences in awk and gawk, match() function: String Functions.
- (line 263)
+ (line 269)
* differences in awk and gawk, split() function: String Functions.
- (line 351)
+ (line 357)
* differences in awk and gawk, indirect function calls: Indirect Calls.
(line 6)
* differences in awk and gawk, BINMODE variable <1>: PC Using.
@@ -35146,7 +35158,7 @@ Index
* extensions, common, **= operator: Assignment Ops. (line 138)
* extensions, common, delete to delete entire arrays: Delete. (line 39)
* extensions, common, length() applied to an array: String Functions.
- (line 201)
+ (line 207)
* extensions, common, fflush() function: I/O Functions. (line 43)
* extensions, common, func keyword: Definition Syntax. (line 99)
* extensions, loadable, allocating memory: Memory Allocation Functions.
@@ -35278,7 +35290,7 @@ Index
(line 80)
* files, message object, converting from portable object files: I18N Example.
(line 80)
-* find substring in string: String Functions. (line 156)
+* find substring in string: String Functions. (line 162)
* finding extensions: Finding Extensions. (line 6)
* finish debugger command: Debugger Execution Control.
(line 39)
@@ -35315,7 +35327,7 @@ Index
* format time string: Time Functions. (line 50)
* formats, numeric output: OFMT. (line 6)
* formatting, output: Printf. (line 6)
-* formatting, strings: String Functions. (line 389)
+* formatting, strings: String Functions. (line 395)
* forward slash (/), to enclose regular expressions: Regexp. (line 10)
* forward slash (/), /= operator: Assignment Ops. (line 129)
* forward slash (/), /= operator, vs. /=.../ regexp constant: Assignment Ops.
@@ -35515,7 +35527,7 @@ Index
* generate time values: Time Functions. (line 25)
* gensub: Standard Regexp Constants.
(line 43)
-* gensub <1>: String Functions. (line 89)
+* gensub <1>: String Functions. (line 95)
* gensub() function (gawk), escape processing: Gory Details. (line 6)
* getaddrinfo() function (C library): TCP/IP Networking. (line 39)
* getgrent() function (C library): Group Functions. (line 6)
@@ -35597,8 +35609,8 @@ Index
* groups, information about: Group Functions. (line 6)
* gsub: Standard Regexp Constants.
(line 43)
-* gsub <1>: String Functions. (line 140)
-* gsub() function, arguments of: String Functions. (line 468)
+* gsub <1>: String Functions. (line 146)
+* gsub() function, arguments of: String Functions. (line 474)
* gsub() function, escape processing: Gory Details. (line 6)
* Guerrero, Juan Manuel: Acknowledgments. (line 60)
* Guerrero, Juan Manuel <1>: Contributors. (line 150)
@@ -35665,7 +35677,7 @@ Index
* @include directive: Include Files. (line 8)
* including files, @include directive: Include Files. (line 8)
* increment operators: Increment Ops. (line 6)
-* index: String Functions. (line 156)
+* index: String Functions. (line 162)
* indexing arrays: Array Intro. (line 48)
* indirect function calls: Indirect Calls. (line 6)
* indirect function calls, @-notation: Indirect Calls. (line 47)
@@ -35691,7 +35703,7 @@ Index
(line 6)
* input files, counting elements in: Wc Program. (line 6)
* input pipeline: Getline/Pipe. (line 10)
-* input record, length of: String Functions. (line 178)
+* input record, length of: String Functions. (line 184)
* input redirection: Getline/File. (line 6)
* input/output, from BEGIN and END: I/O And BEGIN/END. (line 6)
* input/output, binary: User-modified. (line 15)
@@ -35799,9 +35811,9 @@ Index
* left angle bracket (<), <= operator <1>: Precedence. (line 64)
* left shift, bitwise: Bitwise Functions. (line 32)
* leftmost longest match: Multiple Line. (line 26)
-* length: String Functions. (line 171)
-* length of input record: String Functions. (line 178)
-* length of string: String Functions. (line 171)
+* length: String Functions. (line 177)
+* length of input record: String Functions. (line 184)
+* length of string: String Functions. (line 177)
* Lesser General Public License (LGPL): Glossary. (line 489)
* LGPL (Lesser General Public License): Glossary. (line 489)
* libmawk: Other Versions. (line 129)
@@ -35890,15 +35902,15 @@ Index
* marked string extraction (internationalization): String Extraction.
(line 6)
* Marx, Groucho: Increment Ops. (line 60)
-* match: String Functions. (line 211)
-* match regexp in string: String Functions. (line 211)
+* match: String Functions. (line 217)
+* match regexp in string: String Functions. (line 217)
* match() function, RSTART/RLENGTH variables: String Functions.
- (line 228)
-* match() function, side effects: String Functions. (line 228)
+ (line 234)
+* match() function, side effects: String Functions. (line 234)
* matching, leftmost longest: Multiple Line. (line 26)
* matching, expressions: Typing and Comparison.
(line 9)
-* matching, null strings: String Functions. (line 542)
+* matching, null strings: String Functions. (line 548)
* mawk utility: Escape Sequences. (line 121)
* mawk utility <1>: Getline/Pipe. (line 62)
* mawk utility <2>: Concatenation. (line 36)
@@ -36020,9 +36032,9 @@ Index
* null strings, as array subscripts: Uninitialized Subscripts.
(line 43)
* null strings, deleting array elements and: Delete. (line 27)
-* null strings, matching: String Functions. (line 542)
+* null strings, matching: String Functions. (line 548)
* null strings <3>: Basic Data Typing. (line 26)
-* number of array elements: String Functions. (line 201)
+* number of array elements: String Functions. (line 207)
* number sign (#), #! (executable scripts): Executable Scripts.
(line 6)
* number sign (#), commenting: Comments. (line 6)
@@ -36130,7 +36142,7 @@ Index
(line 77)
* parentheses (), in a profile: Profiling. (line 146)
* password file: Passwd Functions. (line 16)
-* patsplit: String Functions. (line 297)
+* patsplit: String Functions. (line 303)
* patterns, default: Very Simple. (line 35)
* patterns, regexp constants as: Regexp Usage. (line 6)
* patterns: Patterns and Actions.
@@ -36194,8 +36206,8 @@ Index
* portability, operators: Increment Ops. (line 60)
* portability, operators, not in POSIX awk: Precedence. (line 97)
* portability, deleting array elements: Delete. (line 56)
-* portability, length() function: String Functions. (line 180)
-* portability, substr() function: String Functions. (line 518)
+* portability, length() function: String Functions. (line 186)
+* portability, substr() function: String Functions. (line 524)
* portability, functions, defining: Definition Syntax. (line 114)
* portability, next statement in user-defined functions: Function Caveats.
(line 26)
@@ -36249,7 +36261,7 @@ Index
* POSIX awk, continue statement and: Continue Statement. (line 44)
* POSIX awk, next/nextfile statements and: Next Statement. (line 44)
* POSIX awk, CONVFMT variable and: User-modified. (line 30)
-* POSIX awk, functions and, length(): String Functions. (line 180)
+* POSIX awk, functions and, length(): String Functions. (line 186)
* POSIX awk, functions and, gsub()/sub(): Gory Details. (line 90)
* POSIX awk, timestamps and: Time Functions. (line 6)
* POSIX awk, date utility and: Time Functions. (line 255)
@@ -36270,7 +36282,7 @@ Index
(line 12)
* POSIX mode <9>: POSIX String Comparison.
(line 34)
-* POSIX mode <10>: String Functions. (line 385)
+* POSIX mode <10>: String Functions. (line 391)
* POSIX mode <11>: Controlling Array Traversal.
(line 226)
* POSIX mode <12>: POSIX Floating Point Problems.
@@ -36484,7 +36496,7 @@ Index
* regular expressions, as patterns <1>: Regexp Patterns. (line 6)
* regular expressions, case sensitivity <1>: User-modified. (line 79)
* regular expressions, searching for: Egrep Program. (line 6)
-* replace in string: String Functions. (line 414)
+* replace in string: String Functions. (line 420)
* retrying input: Retrying Input. (line 6)
* return debugger command: Debugger Execution Control.
(line 54)
@@ -36509,7 +36521,7 @@ Index
* right shift, bitwise: Bitwise Functions. (line 32)
* Ritchie, Dennis: Basic Data Typing. (line 54)
* RLENGTH variable: Auto-set. (line 335)
-* RLENGTH variable, match() function and: String Functions. (line 228)
+* RLENGTH variable, match() function and: String Functions. (line 234)
* Robbins, Miriam: Acknowledgments. (line 94)
* Robbins, Jean: Acknowledgments. (line 94)
* Robbins, Harry: Acknowledgments. (line 94)
@@ -36537,7 +36549,7 @@ Index
* RS variable <1>: User-modified. (line 136)
* rshift: Bitwise Functions. (line 54)
* RSTART variable: Auto-set. (line 341)
-* RSTART variable, match() function and: String Functions. (line 228)
+* RSTART variable, match() function and: String Functions. (line 234)
* RT variable: awk split records. (line 131)
* RT variable <1>: gawk split records. (line 58)
* RT variable <2>: Multiple Line. (line 139)
@@ -36563,8 +36575,8 @@ Index
* Schorr, Andrew <2>: Contributors. (line 136)
* Schreiber, Bert: Acknowledgments. (line 38)
* Schreiber, Rita: Acknowledgments. (line 38)
-* search and replace in strings: String Functions. (line 89)
-* search for substring: String Functions. (line 156)
+* search and replace in strings: String Functions. (line 95)
+* search for substring: String Functions. (line 162)
* search paths, for source files: AWKPATH Variable. (line 6)
* search paths, for loadable extensions: AWKLIBPATH Variable. (line 6)
* search paths: Programs Exercises. (line 70)
@@ -36645,9 +36657,9 @@ Index
* side effects, statements: Action Overview. (line 32)
* side effects, array indexing: Reference to Elements.
(line 43)
-* side effects, match() function: String Functions. (line 228)
-* side effects, sub() function: String Functions. (line 468)
-* side effects, gsub() function: String Functions. (line 468)
+* side effects, match() function: String Functions. (line 234)
+* side effects, sub() function: String Functions. (line 474)
+* side effects, gsub() function: String Functions. (line 474)
* side effects, asort() function: Array Sorting Functions.
(line 24)
* side effects, asorti() function: Array Sorting Functions.
@@ -36677,7 +36689,7 @@ Index
(line 147)
* sidebar, Operator Evaluation Order: Increment Ops. (line 58)
* sidebar, Changing NR and FNR: Auto-set. (line 407)
-* sidebar, Matching the Null String: String Functions. (line 540)
+* sidebar, Matching the Null String: String Functions. (line 546)
* sidebar, Interactive Versus Noninteractive Buffering: I/O Functions.
(line 74)
* sidebar, Controlling Output Buffering with system(): I/O Functions.
@@ -36745,13 +36757,13 @@ Index
* source files, search path for: Programs Exercises. (line 70)
* sparse arrays: Array Intro. (line 76)
* Spencer, Henry: Glossary. (line 16)
-* split: String Functions. (line 318)
-* split string into array: String Functions. (line 297)
+* split: String Functions. (line 324)
+* split string into array: String Functions. (line 303)
* split utility: Split Program. (line 6)
* split() function, array elements, deleting: Delete. (line 61)
* split.awk program: Split Program. (line 30)
* sprintf: OFMT. (line 15)
-* sprintf <1>: String Functions. (line 389)
+* sprintf <1>: String Functions. (line 395)
* sprintf() function, print/printf statements and: Round Function.
(line 6)
* sqrt: Numeric Functions. (line 78)
@@ -36786,8 +36798,8 @@ Index
* string, constants, vs. regexp constants: Computed Regexps. (line 40)
* string, constants: Scalar Constants. (line 15)
* string, operators: Concatenation. (line 9)
-* string, length: String Functions. (line 171)
-* string, regular expression match of: String Functions. (line 211)
+* string, length: String Functions. (line 177)
+* string, regular expression match of: String Functions. (line 217)
* string, extraction (internationalization): String Extraction.
(line 6)
* string-manipulation functions: String Functions. (line 6)
@@ -36802,19 +36814,19 @@ Index
* strings, numeric: Variable Typing. (line 67)
* strings, converting, numbers to: User-modified. (line 30)
* strings, converting, numbers to <1>: User-modified. (line 107)
-* strings, splitting, example: String Functions. (line 337)
-* strings, converting letter case: String Functions. (line 528)
+* strings, splitting, example: String Functions. (line 343)
+* strings, converting letter case: String Functions. (line 534)
* strings, converting <1>: Bitwise Functions. (line 109)
* strings, merging arrays into: Join Function. (line 6)
* strings, for localization: Programmer i18n. (line 13)
* strings, extracting: String Extraction. (line 6)
-* strtonum: String Functions. (line 396)
+* strtonum: String Functions. (line 402)
* strtonum() function (gawk), --non-decimal-data option and: Nondecimal Data.
(line 35)
* sub: Standard Regexp Constants.
(line 43)
-* sub <1>: String Functions. (line 414)
-* sub() function, arguments of: String Functions. (line 468)
+* sub <1>: String Functions. (line 420)
+* sub() function, arguments of: String Functions. (line 474)
* sub() function, escape processing: Gory Details. (line 6)
* subscript separators: User-modified. (line 149)
* subscripts in arrays, numbers as: Numeric Array Subscripts.
@@ -36827,9 +36839,9 @@ Index
* SUBSEP variable: User-modified. (line 149)
* SUBSEP variable, multidimensional arrays and: Multidimensional.
(line 16)
-* substitute in string: String Functions. (line 89)
-* substr: String Functions. (line 487)
-* substring: String Functions. (line 487)
+* substitute in string: String Functions. (line 95)
+* substr: String Functions. (line 493)
+* substring: String Functions. (line 493)
* Sumner, Andrew: Other Versions. (line 64)
* supplementary groups of gawk process: Auto-set. (line 292)
* switch statement: Switch Statement. (line 6)
@@ -36890,8 +36902,8 @@ Index
* timestamps, converting dates to: Time Functions. (line 78)
* timestamps, formatted: Getlocaltime Function.
(line 6)
-* tolower: String Functions. (line 529)
-* toupper: String Functions. (line 535)
+* tolower: String Functions. (line 535)
+* toupper: String Functions. (line 541)
* tr utility: Translate Program. (line 6)
* trace debugger command: Miscellaneous Debugger Commands.
(line 108)
@@ -36922,9 +36934,9 @@ Index
* troubleshooting, function call syntax: Function Calls. (line 30)
* troubleshooting, gawk, fatal errors, function arguments: Calling Built-in.
(line 16)
-* troubleshooting, match() function: String Functions. (line 292)
-* troubleshooting, gsub()/sub() functions: String Functions. (line 478)
-* troubleshooting, substr() function: String Functions. (line 505)
+* troubleshooting, match() function: String Functions. (line 298)
+* troubleshooting, gsub()/sub() functions: String Functions. (line 484)
+* troubleshooting, substr() function: String Functions. (line 511)
* troubleshooting, fflush() function: I/O Functions. (line 63)
* troubleshooting, system() function: I/O Functions. (line 128)
* troubleshooting, readable data files: File Checking. (line 6)
@@ -37348,371 +37360,371 @@ Node: Assigning Elements503938
Node: Array Example504429
Node: Scanning an Array506188
Node: Controlling Scanning509210
-Ref: Controlling Scanning-Footnote-1514609
-Node: Numeric Array Subscripts514925
-Node: Uninitialized Subscripts517109
-Node: Delete518728
-Ref: Delete-Footnote-1521480
-Node: Multidimensional521537
-Node: Multiscanning524632
-Node: Arrays of Arrays526223
-Node: Arrays Summary530991
-Node: Functions533084
-Node: Built-in534122
-Node: Calling Built-in535203
-Node: Numeric Functions537199
-Ref: Numeric Functions-Footnote-1541227
-Ref: Numeric Functions-Footnote-2541875
-Ref: Numeric Functions-Footnote-3541923
-Node: String Functions542195
-Ref: String Functions-Footnote-1566053
-Ref: String Functions-Footnote-2566181
-Ref: String Functions-Footnote-3566429
-Node: Gory Details566516
-Ref: table-sub-escapes568307
-Ref: table-sub-proposed569826
-Ref: table-posix-sub571189
-Ref: table-gensub-escapes572730
-Ref: Gory Details-Footnote-1573553
-Node: I/O Functions573707
-Ref: table-system-return-values580175
-Ref: I/O Functions-Footnote-1582255
-Ref: I/O Functions-Footnote-2582403
-Node: Time Functions582523
-Ref: Time Functions-Footnote-1593194
-Ref: Time Functions-Footnote-2593262
-Ref: Time Functions-Footnote-3593420
-Ref: Time Functions-Footnote-4593531
-Ref: Time Functions-Footnote-5593643
-Ref: Time Functions-Footnote-6593870
-Node: Bitwise Functions594136
-Ref: table-bitwise-ops594730
-Ref: Bitwise Functions-Footnote-1600793
-Ref: Bitwise Functions-Footnote-2600966
-Node: Type Functions601157
-Node: I18N Functions604020
-Node: User-defined605671
-Node: Definition Syntax606483
-Ref: Definition Syntax-Footnote-1612170
-Node: Function Example612241
-Ref: Function Example-Footnote-1615163
-Node: Function Calling615185
-Node: Calling A Function615773
-Node: Variable Scope616731
-Node: Pass By Value/Reference619725
-Node: Function Caveats622369
-Ref: Function Caveats-Footnote-1624416
-Node: Return Statement624536
-Node: Dynamic Typing627515
-Node: Indirect Calls628445
-Ref: Indirect Calls-Footnote-1638697
-Node: Functions Summary638825
-Node: Library Functions641530
-Ref: Library Functions-Footnote-1645137
-Ref: Library Functions-Footnote-2645280
-Node: Library Names645451
-Ref: Library Names-Footnote-1649118
-Ref: Library Names-Footnote-2649341
-Node: General Functions649427
-Node: Strtonum Function650530
-Node: Assert Function653552
-Node: Round Function656878
-Node: Cliff Random Function658418
-Node: Ordinal Functions659434
-Ref: Ordinal Functions-Footnote-1662497
-Ref: Ordinal Functions-Footnote-2662749
-Node: Join Function662959
-Ref: Join Function-Footnote-1664729
-Node: Getlocaltime Function664929
-Node: Readfile Function668671
-Node: Shell Quoting670648
-Node: Data File Management672049
-Node: Filetrans Function672681
-Node: Rewind Function676777
-Node: File Checking678686
-Ref: File Checking-Footnote-1680020
-Node: Empty Files680221
-Node: Ignoring Assigns682200
-Node: Getopt Function683750
-Ref: Getopt Function-Footnote-1695219
-Node: Passwd Functions695419
-Ref: Passwd Functions-Footnote-1704258
-Node: Group Functions704346
-Ref: Group Functions-Footnote-1712244
-Node: Walking Arrays712451
-Node: Library Functions Summary715459
-Node: Library Exercises716865
-Node: Sample Programs717330
-Node: Running Examples718100
-Node: Clones718828
-Node: Cut Program720052
-Node: Egrep Program729981
-Ref: Egrep Program-Footnote-1737493
-Node: Id Program737603
-Node: Split Program741283
-Ref: Split Program-Footnote-1744741
-Node: Tee Program744870
-Node: Uniq Program747660
-Node: Wc Program755281
-Ref: Wc Program-Footnote-1759536
-Node: Miscellaneous Programs759630
-Node: Dupword Program760843
-Node: Alarm Program762873
-Node: Translate Program767728
-Ref: Translate Program-Footnote-1772293
-Node: Labels Program772563
-Ref: Labels Program-Footnote-1775914
-Node: Word Sorting775998
-Node: History Sorting780070
-Node: Extract Program782295
-Node: Simple Sed790349
-Node: Igawk Program793423
-Ref: Igawk Program-Footnote-1807754
-Ref: Igawk Program-Footnote-2807956
-Ref: Igawk Program-Footnote-3808078
-Node: Anagram Program808193
-Node: Signature Program811255
-Node: Programs Summary812502
-Node: Programs Exercises813716
-Ref: Programs Exercises-Footnote-1817845
-Node: Advanced Features817936
-Node: Nondecimal Data819926
-Node: Array Sorting821517
-Node: Controlling Array Traversal822217
-Ref: Controlling Array Traversal-Footnote-1830585
-Node: Array Sorting Functions830703
-Ref: Array Sorting Functions-Footnote-1835794
-Node: Two-way I/O835990
-Ref: Two-way I/O-Footnote-1843711
-Ref: Two-way I/O-Footnote-2843898
-Node: TCP/IP Networking843980
-Node: Profiling847098
-Node: Advanced Features Summary856113
-Node: Internationalization857957
-Node: I18N and L10N859437
-Node: Explaining gettext860124
-Ref: Explaining gettext-Footnote-1866016
-Ref: Explaining gettext-Footnote-2866201
-Node: Programmer i18n866366
-Ref: Programmer i18n-Footnote-1871315
-Node: Translator i18n871364
-Node: String Extraction872158
-Ref: String Extraction-Footnote-1873290
-Node: Printf Ordering873376
-Ref: Printf Ordering-Footnote-1876162
-Node: I18N Portability876226
-Ref: I18N Portability-Footnote-1878682
-Node: I18N Example878745
-Ref: I18N Example-Footnote-1882020
-Ref: I18N Example-Footnote-2882093
-Node: Gawk I18N882202
-Node: I18N Summary882851
-Node: Debugger884192
-Node: Debugging885192
-Node: Debugging Concepts885633
-Node: Debugging Terms887442
-Node: Awk Debugging890017
-Ref: Awk Debugging-Footnote-1890962
-Node: Sample Debugging Session891094
-Node: Debugger Invocation891628
-Node: Finding The Bug893014
-Node: List of Debugger Commands899488
-Node: Breakpoint Control900821
-Node: Debugger Execution Control904515
-Node: Viewing And Changing Data907877
-Node: Execution Stack911418
-Node: Debugger Info913055
-Node: Miscellaneous Debugger Commands917126
-Node: Readline Support922188
-Node: Limitations923084
-Node: Debugging Summary925638
-Node: Namespaces926917
-Node: Global Namespace928028
-Node: Qualified Names929426
-Node: Default Namespace930425
-Node: Changing The Namespace931166
-Node: Naming Rules932780
-Node: Internal Name Management934628
-Node: Namespace Example935670
-Node: Namespace And Features938232
-Node: Namespace Summary939667
-Node: Arbitrary Precision Arithmetic941144
-Node: Computer Arithmetic942631
-Ref: table-numeric-ranges946397
-Ref: table-floating-point-ranges946890
-Ref: Computer Arithmetic-Footnote-1947548
-Node: Math Definitions947605
-Ref: table-ieee-formats950921
-Ref: Math Definitions-Footnote-1951524
-Node: MPFR features951629
-Node: FP Math Caution953347
-Ref: FP Math Caution-Footnote-1954419
-Node: Inexactness of computations954788
-Node: Inexact representation955748
-Node: Comparing FP Values957108
-Node: Errors accumulate958349
-Node: Getting Accuracy959782
-Node: Try To Round962492
-Node: Setting precision963391
-Ref: table-predefined-precision-strings964088
-Node: Setting the rounding mode965918
-Ref: table-gawk-rounding-modes966292
-Ref: Setting the rounding mode-Footnote-1970223
-Node: Arbitrary Precision Integers970402
-Ref: Arbitrary Precision Integers-Footnote-1973577
-Node: Checking for MPFR973726
-Node: POSIX Floating Point Problems975200
-Ref: POSIX Floating Point Problems-Footnote-1979485
-Node: Floating point summary979523
-Node: Dynamic Extensions981713
-Node: Extension Intro983266
-Node: Plugin License984532
-Node: Extension Mechanism Outline985329
-Ref: figure-load-extension985768
-Ref: figure-register-new-function987333
-Ref: figure-call-new-function988425
-Node: Extension API Description990487
-Node: Extension API Functions Introduction992129
-Ref: table-api-std-headers993965
-Node: General Data Types997830
-Ref: General Data Types-Footnote-11006191
-Node: Memory Allocation Functions1006490
-Ref: Memory Allocation Functions-Footnote-11010700
-Node: Constructor Functions1010799
-Node: Registration Functions1014385
-Node: Extension Functions1015070
-Node: Exit Callback Functions1020392
-Node: Extension Version String1021642
-Node: Input Parsers1022305
-Node: Output Wrappers1035026
-Node: Two-way processors1039538
-Node: Printing Messages1041803
-Ref: Printing Messages-Footnote-11042974
-Node: Updating ERRNO1043127
-Node: Requesting Values1043866
-Ref: table-value-types-returned1044603
-Node: Accessing Parameters1045539
-Node: Symbol Table Access1046774
-Node: Symbol table by name1047286
-Ref: Symbol table by name-Footnote-11050310
-Node: Symbol table by cookie1050438
-Ref: Symbol table by cookie-Footnote-11054623
-Node: Cached values1054687
-Ref: Cached values-Footnote-11058223
-Node: Array Manipulation1058376
-Ref: Array Manipulation-Footnote-11059467
-Node: Array Data Types1059504
-Ref: Array Data Types-Footnote-11062162
-Node: Array Functions1062254
-Node: Flattening Arrays1066752
-Node: Creating Arrays1073728
-Node: Redirection API1078495
-Node: Extension API Variables1081328
-Node: Extension Versioning1082039
-Ref: gawk-api-version1082468
-Node: Extension GMP/MPFR Versioning1084199
-Node: Extension API Informational Variables1085827
-Node: Extension API Boilerplate1086900
-Node: Changes from API V11090874
-Node: Finding Extensions1092446
-Node: Extension Example1093005
-Node: Internal File Description1093803
-Node: Internal File Ops1097883
-Ref: Internal File Ops-Footnote-11109233
-Node: Using Internal File Ops1109373
-Ref: Using Internal File Ops-Footnote-11111756
-Node: Extension Samples1112030
-Node: Extension Sample File Functions1113559
-Node: Extension Sample Fnmatch1121208
-Node: Extension Sample Fork1122695
-Node: Extension Sample Inplace1123913
-Node: Extension Sample Ord1127538
-Node: Extension Sample Readdir1128374
-Ref: table-readdir-file-types1129263
-Node: Extension Sample Revout1130330
-Node: Extension Sample Rev2way1130919
-Node: Extension Sample Read write array1131659
-Node: Extension Sample Readfile1133601
-Node: Extension Sample Time1134696
-Node: Extension Sample API Tests1136448
-Node: gawkextlib1136940
-Node: Extension summary1139858
-Node: Extension Exercises1143560
-Node: Language History1144802
-Node: V7/SVR3.11146458
-Node: SVR41148610
-Node: POSIX1150044
-Node: BTL1151424
-Node: POSIX/GNU1152153
-Node: Feature History1157931
-Node: Common Extensions1174124
-Node: Ranges and Locales1175407
-Ref: Ranges and Locales-Footnote-11180023
-Ref: Ranges and Locales-Footnote-21180050
-Ref: Ranges and Locales-Footnote-31180285
-Node: Contributors1180506
-Node: History summary1186459
-Node: Installation1187839
-Node: Gawk Distribution1188783
-Node: Getting1189267
-Node: Extracting1190230
-Node: Distribution contents1191868
-Node: Unix Installation1198348
-Node: Quick Installation1199030
-Node: Shell Startup Files1201444
-Node: Additional Configuration Options1202533
-Node: Configuration Philosophy1204848
-Node: Non-Unix Installation1207217
-Node: PC Installation1207677
-Node: PC Binary Installation1208515
-Node: PC Compiling1208950
-Node: PC Using1210067
-Node: Cygwin1213620
-Node: MSYS1214844
-Node: VMS Installation1215345
-Node: VMS Compilation1216136
-Ref: VMS Compilation-Footnote-11217365
-Node: VMS Dynamic Extensions1217423
-Node: VMS Installation Details1219108
-Node: VMS Running1221361
-Node: VMS GNV1225640
-Node: VMS Old Gawk1226375
-Node: Bugs1226846
-Node: Bug address1227509
-Node: Usenet1230491
-Node: Maintainers1231495
-Node: Other Versions1232756
-Node: Installation summary1239844
-Node: Notes1241046
-Node: Compatibility Mode1241840
-Node: Additions1242622
-Node: Accessing The Source1243547
-Node: Adding Code1244984
-Node: New Ports1251203
-Node: Derived Files1255578
-Ref: Derived Files-Footnote-11261238
-Ref: Derived Files-Footnote-21261273
-Ref: Derived Files-Footnote-31261871
-Node: Future Extensions1261985
-Node: Implementation Limitations1262643
-Node: Extension Design1263826
-Node: Old Extension Problems1264970
-Ref: Old Extension Problems-Footnote-11266488
-Node: Extension New Mechanism Goals1266545
-Ref: Extension New Mechanism Goals-Footnote-11269909
-Node: Extension Other Design Decisions1270098
-Node: Extension Future Growth1272211
-Node: Notes summary1273047
-Node: Basic Concepts1274205
-Node: Basic High Level1274886
-Ref: figure-general-flow1275168
-Ref: figure-process-flow1275853
-Ref: Basic High Level-Footnote-11279154
-Node: Basic Data Typing1279339
-Node: Glossary1282667
-Node: Copying1314505
-Node: GNU Free Documentation License1352048
-Node: Index1377168
+Ref: Controlling Scanning-Footnote-1514910
+Node: Numeric Array Subscripts515226
+Node: Uninitialized Subscripts517410
+Node: Delete519029
+Ref: Delete-Footnote-1521781
+Node: Multidimensional521838
+Node: Multiscanning524933
+Node: Arrays of Arrays526524
+Node: Arrays Summary531292
+Node: Functions533385
+Node: Built-in534423
+Node: Calling Built-in535504
+Node: Numeric Functions537500
+Ref: Numeric Functions-Footnote-1541528
+Ref: Numeric Functions-Footnote-2542176
+Ref: Numeric Functions-Footnote-3542224
+Node: String Functions542496
+Ref: String Functions-Footnote-1566680
+Ref: String Functions-Footnote-2566808
+Ref: String Functions-Footnote-3567056
+Node: Gory Details567143
+Ref: table-sub-escapes568934
+Ref: table-sub-proposed570453
+Ref: table-posix-sub571816
+Ref: table-gensub-escapes573357
+Ref: Gory Details-Footnote-1574180
+Node: I/O Functions574334
+Ref: table-system-return-values580802
+Ref: I/O Functions-Footnote-1582882
+Ref: I/O Functions-Footnote-2583030
+Node: Time Functions583150
+Ref: Time Functions-Footnote-1593821
+Ref: Time Functions-Footnote-2593889
+Ref: Time Functions-Footnote-3594047
+Ref: Time Functions-Footnote-4594158
+Ref: Time Functions-Footnote-5594270
+Ref: Time Functions-Footnote-6594497
+Node: Bitwise Functions594763
+Ref: table-bitwise-ops595357
+Ref: Bitwise Functions-Footnote-1601420
+Ref: Bitwise Functions-Footnote-2601593
+Node: Type Functions601784
+Node: I18N Functions604647
+Node: User-defined606298
+Node: Definition Syntax607110
+Ref: Definition Syntax-Footnote-1612797
+Node: Function Example612868
+Ref: Function Example-Footnote-1615790
+Node: Function Calling615812
+Node: Calling A Function616400
+Node: Variable Scope617358
+Node: Pass By Value/Reference620352
+Node: Function Caveats622996
+Ref: Function Caveats-Footnote-1625043
+Node: Return Statement625163
+Node: Dynamic Typing628142
+Node: Indirect Calls629072
+Ref: Indirect Calls-Footnote-1639324
+Node: Functions Summary639452
+Node: Library Functions642157
+Ref: Library Functions-Footnote-1645764
+Ref: Library Functions-Footnote-2645907
+Node: Library Names646078
+Ref: Library Names-Footnote-1649745
+Ref: Library Names-Footnote-2649968
+Node: General Functions650054
+Node: Strtonum Function651157
+Node: Assert Function654179
+Node: Round Function657505
+Node: Cliff Random Function659045
+Node: Ordinal Functions660061
+Ref: Ordinal Functions-Footnote-1663124
+Ref: Ordinal Functions-Footnote-2663376
+Node: Join Function663586
+Ref: Join Function-Footnote-1665356
+Node: Getlocaltime Function665556
+Node: Readfile Function669298
+Node: Shell Quoting671275
+Node: Data File Management672676
+Node: Filetrans Function673308
+Node: Rewind Function677404
+Node: File Checking679313
+Ref: File Checking-Footnote-1680647
+Node: Empty Files680848
+Node: Ignoring Assigns682827
+Node: Getopt Function684377
+Ref: Getopt Function-Footnote-1695846
+Node: Passwd Functions696046
+Ref: Passwd Functions-Footnote-1704885
+Node: Group Functions704973
+Ref: Group Functions-Footnote-1712871
+Node: Walking Arrays713078
+Node: Library Functions Summary716086
+Node: Library Exercises717492
+Node: Sample Programs717957
+Node: Running Examples718727
+Node: Clones719455
+Node: Cut Program720679
+Node: Egrep Program730608
+Ref: Egrep Program-Footnote-1738120
+Node: Id Program738230
+Node: Split Program741910
+Ref: Split Program-Footnote-1745368
+Node: Tee Program745497
+Node: Uniq Program748287
+Node: Wc Program755908
+Ref: Wc Program-Footnote-1760163
+Node: Miscellaneous Programs760257
+Node: Dupword Program761470
+Node: Alarm Program763500
+Node: Translate Program768355
+Ref: Translate Program-Footnote-1772920
+Node: Labels Program773190
+Ref: Labels Program-Footnote-1776541
+Node: Word Sorting776625
+Node: History Sorting780697
+Node: Extract Program782922
+Node: Simple Sed790976
+Node: Igawk Program794050
+Ref: Igawk Program-Footnote-1808381
+Ref: Igawk Program-Footnote-2808583
+Ref: Igawk Program-Footnote-3808705
+Node: Anagram Program808820
+Node: Signature Program811882
+Node: Programs Summary813129
+Node: Programs Exercises814343
+Ref: Programs Exercises-Footnote-1818472
+Node: Advanced Features818563
+Node: Nondecimal Data820553
+Node: Array Sorting822144
+Node: Controlling Array Traversal822844
+Ref: Controlling Array Traversal-Footnote-1831212
+Node: Array Sorting Functions831330
+Ref: Array Sorting Functions-Footnote-1836421
+Node: Two-way I/O836617
+Ref: Two-way I/O-Footnote-1844338
+Ref: Two-way I/O-Footnote-2844525
+Node: TCP/IP Networking844607
+Node: Profiling847725
+Node: Advanced Features Summary856740
+Node: Internationalization858584
+Node: I18N and L10N860064
+Node: Explaining gettext860751
+Ref: Explaining gettext-Footnote-1866643
+Ref: Explaining gettext-Footnote-2866828
+Node: Programmer i18n866993
+Ref: Programmer i18n-Footnote-1871942
+Node: Translator i18n871991
+Node: String Extraction872785
+Ref: String Extraction-Footnote-1873917
+Node: Printf Ordering874003
+Ref: Printf Ordering-Footnote-1876789
+Node: I18N Portability876853
+Ref: I18N Portability-Footnote-1879309
+Node: I18N Example879372
+Ref: I18N Example-Footnote-1882647
+Ref: I18N Example-Footnote-2882720
+Node: Gawk I18N882829
+Node: I18N Summary883478
+Node: Debugger884819
+Node: Debugging885819
+Node: Debugging Concepts886260
+Node: Debugging Terms888069
+Node: Awk Debugging890644
+Ref: Awk Debugging-Footnote-1891589
+Node: Sample Debugging Session891721
+Node: Debugger Invocation892255
+Node: Finding The Bug893641
+Node: List of Debugger Commands900115
+Node: Breakpoint Control901448
+Node: Debugger Execution Control905142
+Node: Viewing And Changing Data908504
+Node: Execution Stack912045
+Node: Debugger Info913682
+Node: Miscellaneous Debugger Commands917753
+Node: Readline Support922815
+Node: Limitations923711
+Node: Debugging Summary926265
+Node: Namespaces927544
+Node: Global Namespace928655
+Node: Qualified Names930053
+Node: Default Namespace931052
+Node: Changing The Namespace931793
+Node: Naming Rules933407
+Node: Internal Name Management935255
+Node: Namespace Example936297
+Node: Namespace And Features938859
+Node: Namespace Summary940294
+Node: Arbitrary Precision Arithmetic941771
+Node: Computer Arithmetic943258
+Ref: table-numeric-ranges947024
+Ref: table-floating-point-ranges947517
+Ref: Computer Arithmetic-Footnote-1948175
+Node: Math Definitions948232
+Ref: table-ieee-formats951548
+Ref: Math Definitions-Footnote-1952151
+Node: MPFR features952256
+Node: FP Math Caution953974
+Ref: FP Math Caution-Footnote-1955046
+Node: Inexactness of computations955415
+Node: Inexact representation956375
+Node: Comparing FP Values957735
+Node: Errors accumulate958976
+Node: Getting Accuracy960409
+Node: Try To Round963119
+Node: Setting precision964018
+Ref: table-predefined-precision-strings964715
+Node: Setting the rounding mode966545
+Ref: table-gawk-rounding-modes966919
+Ref: Setting the rounding mode-Footnote-1970850
+Node: Arbitrary Precision Integers971029
+Ref: Arbitrary Precision Integers-Footnote-1974204
+Node: Checking for MPFR974353
+Node: POSIX Floating Point Problems975827
+Ref: POSIX Floating Point Problems-Footnote-1980112
+Node: Floating point summary980150
+Node: Dynamic Extensions982340
+Node: Extension Intro983893
+Node: Plugin License985159
+Node: Extension Mechanism Outline985956
+Ref: figure-load-extension986395
+Ref: figure-register-new-function987960
+Ref: figure-call-new-function989052
+Node: Extension API Description991114
+Node: Extension API Functions Introduction992756
+Ref: table-api-std-headers994592
+Node: General Data Types998457
+Ref: General Data Types-Footnote-11006818
+Node: Memory Allocation Functions1007117
+Ref: Memory Allocation Functions-Footnote-11011327
+Node: Constructor Functions1011426
+Node: Registration Functions1015012
+Node: Extension Functions1015697
+Node: Exit Callback Functions1021019
+Node: Extension Version String1022269
+Node: Input Parsers1022932
+Node: Output Wrappers1035653
+Node: Two-way processors1040165
+Node: Printing Messages1042430
+Ref: Printing Messages-Footnote-11043601
+Node: Updating ERRNO1043754
+Node: Requesting Values1044493
+Ref: table-value-types-returned1045230
+Node: Accessing Parameters1046166
+Node: Symbol Table Access1047401
+Node: Symbol table by name1047913
+Ref: Symbol table by name-Footnote-11050937
+Node: Symbol table by cookie1051065
+Ref: Symbol table by cookie-Footnote-11055250
+Node: Cached values1055314
+Ref: Cached values-Footnote-11058850
+Node: Array Manipulation1059003
+Ref: Array Manipulation-Footnote-11060094
+Node: Array Data Types1060131
+Ref: Array Data Types-Footnote-11062789
+Node: Array Functions1062881
+Node: Flattening Arrays1067379
+Node: Creating Arrays1074355
+Node: Redirection API1079122
+Node: Extension API Variables1081955
+Node: Extension Versioning1082666
+Ref: gawk-api-version1083095
+Node: Extension GMP/MPFR Versioning1084826
+Node: Extension API Informational Variables1086454
+Node: Extension API Boilerplate1087527
+Node: Changes from API V11091501
+Node: Finding Extensions1093073
+Node: Extension Example1093632
+Node: Internal File Description1094430
+Node: Internal File Ops1098510
+Ref: Internal File Ops-Footnote-11109860
+Node: Using Internal File Ops1110000
+Ref: Using Internal File Ops-Footnote-11112383
+Node: Extension Samples1112657
+Node: Extension Sample File Functions1114186
+Node: Extension Sample Fnmatch1121835
+Node: Extension Sample Fork1123322
+Node: Extension Sample Inplace1124540
+Node: Extension Sample Ord1128165
+Node: Extension Sample Readdir1129001
+Ref: table-readdir-file-types1129890
+Node: Extension Sample Revout1130957
+Node: Extension Sample Rev2way1131546
+Node: Extension Sample Read write array1132286
+Node: Extension Sample Readfile1134228
+Node: Extension Sample Time1135323
+Node: Extension Sample API Tests1137075
+Node: gawkextlib1137567
+Node: Extension summary1140485
+Node: Extension Exercises1144187
+Node: Language History1145429
+Node: V7/SVR3.11147085
+Node: SVR41149237
+Node: POSIX1150671
+Node: BTL1152051
+Node: POSIX/GNU1152780
+Node: Feature History1158558
+Node: Common Extensions1174751
+Node: Ranges and Locales1176034
+Ref: Ranges and Locales-Footnote-11180650
+Ref: Ranges and Locales-Footnote-21180677
+Ref: Ranges and Locales-Footnote-31180912
+Node: Contributors1181133
+Node: History summary1187086
+Node: Installation1188466
+Node: Gawk Distribution1189410
+Node: Getting1189894
+Node: Extracting1190857
+Node: Distribution contents1192495
+Node: Unix Installation1198975
+Node: Quick Installation1199657
+Node: Shell Startup Files1202071
+Node: Additional Configuration Options1203160
+Node: Configuration Philosophy1205475
+Node: Non-Unix Installation1207844
+Node: PC Installation1208304
+Node: PC Binary Installation1209142
+Node: PC Compiling1209577
+Node: PC Using1210694
+Node: Cygwin1214247
+Node: MSYS1215471
+Node: VMS Installation1215972
+Node: VMS Compilation1216763
+Ref: VMS Compilation-Footnote-11217992
+Node: VMS Dynamic Extensions1218050
+Node: VMS Installation Details1219735
+Node: VMS Running1221988
+Node: VMS GNV1226267
+Node: VMS Old Gawk1227002
+Node: Bugs1227473
+Node: Bug address1228136
+Node: Usenet1231118
+Node: Maintainers1232122
+Node: Other Versions1233383
+Node: Installation summary1240471
+Node: Notes1241673
+Node: Compatibility Mode1242467
+Node: Additions1243249
+Node: Accessing The Source1244174
+Node: Adding Code1245611
+Node: New Ports1251830
+Node: Derived Files1256205
+Ref: Derived Files-Footnote-11261865
+Ref: Derived Files-Footnote-21261900
+Ref: Derived Files-Footnote-31262498
+Node: Future Extensions1262612
+Node: Implementation Limitations1263270
+Node: Extension Design1264453
+Node: Old Extension Problems1265597
+Ref: Old Extension Problems-Footnote-11267115
+Node: Extension New Mechanism Goals1267172
+Ref: Extension New Mechanism Goals-Footnote-11270536
+Node: Extension Other Design Decisions1270725
+Node: Extension Future Growth1272838
+Node: Notes summary1273674
+Node: Basic Concepts1274832
+Node: Basic High Level1275513
+Ref: figure-general-flow1275795
+Ref: figure-process-flow1276480
+Ref: Basic High Level-Footnote-11279781
+Node: Basic Data Typing1279966
+Node: Glossary1283294
+Node: Copying1315132
+Node: GNU Free Documentation License1352675
+Node: Index1377795
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5e344e5..1a41f88 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -17183,6 +17183,12 @@ which in turn come before all subarrays.
(Subarrays have not been described yet;
@pxref{Arrays of Arrays}.)
+If you choose to use this feature in traversing @code{FUNCTAB}
+(@pxref{Auto-set}), then the order is built-in functions first
+(@pxref{Built-in}), then user-defined functions (@pxref{User-defined})
+next, and finally functions loaded from an extension
+(@pxref{Dynamic Extensions}).
+
@item "@@val_str_asc"
Order by element values in ascending order (rather than by indices). Scalar
values are
compared as strings. Subarrays, if present, come out last.
@@ -18303,6 +18309,13 @@ a[2] = "last"
a[3] = "middle"
@end example
+@quotation NOTE
+Due to implementation limitations, you may not use either @code{SYMTAB}
+or @code{FUNCTAB} as arguments to these functions, even if providing a
+second array to use for the actual sorting. Attempting to do so produces
+a fatal error. This restriction may be lifted in the future.
+@end quotation
+
@item @code{gensub(@var{regexp}, @var{replacement}, @var{how}} [@code{,
@var{target}}]@code{) #}
@cindexgawkfunc{gensub}
@cindex search and replace in strings
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index f2be74c..fe2cc17 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -16452,6 +16452,12 @@ which in turn come before all subarrays.
(Subarrays have not been described yet;
@pxref{Arrays of Arrays}.)
+If you choose to use this feature in traversing @code{FUNCTAB}
+(@pxref{Auto-set}), then the order is built-in functions first
+(@pxref{Built-in}), then user-defined functions (@pxref{User-defined})
+next, and finally functions loaded from an extension
+(@pxref{Dynamic Extensions}).
+
@item "@@val_str_asc"
Order by element values in ascending order (rather than by indices). Scalar
values are
compared as strings. Subarrays, if present, come out last.
@@ -17572,6 +17578,13 @@ a[2] = "last"
a[3] = "middle"
@end example
+@quotation NOTE
+Due to implementation limitations, you may not use either @code{SYMTAB}
+or @code{FUNCTAB} as arguments to these functions, even if providing a
+second array to use for the actual sorting. Attempting to do so produces
+a fatal error. This restriction may be lifted in the future.
+@end quotation
+
@item @code{gensub(@var{regexp}, @var{replacement}, @var{how}} [@code{,
@var{target}}]@code{) #}
@cindexgawkfunc{gensub}
@cindex search and replace in strings
diff --git a/test/ChangeLog b/test/ChangeLog
index c188931..b4ba26f 100644
--- a/test/ChangeLog
+++ b/test/ChangeLog
@@ -1,3 +1,8 @@
+2020-01-23 Arnold D. Robbins <address@hidden>
+
+ * Makefile.am (EXTRA_DIST): New test, symtab11.
+ * symtab11.awk, symtab11.ok: New files.
+
2020-01-19 Arnold D. Robbins <address@hidden>
* Makefile.am (EXTRA_DIST): New test, profile13.
diff --git a/test/Makefile.am b/test/Makefile.am
index bf77ea3..677b755 100644
--- a/test/Makefile.am
+++ b/test/Makefile.am
@@ -1,7 +1,7 @@
#
# test/Makefile.am --- automake input file for gawk
#
-# Copyright (C) 1988-2019 the Free Software Foundation, Inc.
+# Copyright (C) 1988-2020 the Free Software Foundation, Inc.
#
# This file is part of GAWK, the GNU implementation of the
# AWK Programming Language.
@@ -1226,6 +1226,8 @@ EXTRA_DIST = \
symtab10.awk \
symtab10.in \
symtab10.ok \
+ symtab11.awk \
+ symtab11.ok \
synerr1.awk \
synerr1.ok \
synerr2.awk \
@@ -1402,8 +1404,8 @@ GAWK_EXT_TESTS = \
sourcesplit split_after_fpat \
splitarg4 strftfld strftime strtonum strtonum1 \
stupid1 stupid2 stupid3 stupid4 \
- switch2 symtab1 symtab2 \
- symtab3 symtab4 symtab5 symtab6 symtab7 symtab8 symtab9 symtab10 \
+ switch2 symtab1 symtab2 symtab3 symtab4 symtab5 symtab6 symtab7
+ symtab8 symtab9 symtab10 symtab11 \
timeout typedregex1 typedregex2 typedregex3 typedregex4 \
typedregex5 typedregex6 \
typeof1 typeof2 typeof3 typeof4 typeof5 \
diff --git a/test/Makefile.in b/test/Makefile.in
index 0794b3b..5543ea4 100644
--- a/test/Makefile.in
+++ b/test/Makefile.in
@@ -17,7 +17,7 @@
#
# test/Makefile.am --- automake input file for gawk
#
-# Copyright (C) 1988-2019 the Free Software Foundation, Inc.
+# Copyright (C) 1988-2020 the Free Software Foundation, Inc.
#
# This file is part of GAWK, the GNU implementation of the
# AWK Programming Language.
@@ -1485,6 +1485,8 @@ EXTRA_DIST = \
symtab10.awk \
symtab10.in \
symtab10.ok \
+ symtab11.awk \
+ symtab11.ok \
synerr1.awk \
synerr1.ok \
synerr2.awk \
@@ -1661,12 +1663,7 @@ GAWK_EXT_TESTS = \
sourcesplit split_after_fpat \
splitarg4 strftfld strftime strtonum strtonum1 \
stupid1 stupid2 stupid3 stupid4 \
- switch2 symtab1 symtab2 \
- symtab3 symtab4 symtab5 symtab6 symtab7 symtab8 symtab9 symtab10 \
- timeout typedregex1 typedregex2 typedregex3 typedregex4 \
- typedregex5 typedregex6 \
- typeof1 typeof2 typeof3 typeof4 typeof5 \
- watchpoint1
+ switch2 symtab1 symtab2 symtab3 symtab4 symtab5 symtab6 symtab7
ARRAYDEBUG_TESTS = arrdbg
EXTRA_TESTS = inftest regtest ignrcas3
@@ -2007,6 +2004,11 @@ uninstall-am:
.PRECIOUS: Makefile
+ symtab8 symtab9 symtab10 symtab11 \
+ timeout typedregex1 typedregex2 typedregex3 typedregex4 \
+ typedregex5 typedregex6 \
+ typeof1 typeof2 typeof3 typeof4 typeof5 \
+ watchpoint1
# Message stuff is to make it a little easier to follow.
# Make the pass-fail last and dependent on others to avoid
@@ -4820,66 +4822,6 @@ symtab7:
@AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
@-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-symtab10:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk --debug < "$(srcdir)"/$@.in >_$@
2>&1 || echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-timeout:
- @echo $@ $(ZOS_FAIL)
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex1:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex2:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex3:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex5:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex6:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof1:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof2:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof3:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof4:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof5:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
double1:
@echo $@ $(ZOS_FAIL)
@AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
diff --git a/test/Maketests b/test/Maketests
index d8c3299..8f3fbe4 100644
--- a/test/Maketests
+++ b/test/Maketests
@@ -1971,66 +1971,6 @@ symtab7:
@AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
@-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-symtab10:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk --debug < "$(srcdir)"/$@.in >_$@
2>&1 || echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-timeout:
- @echo $@ $(ZOS_FAIL)
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex1:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex2:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex3:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex5:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typedregex6:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof1:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof2:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof3:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof4:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
-typeof5:
- @echo $@
- @AWKPATH="$(srcdir)" $(AWK) -f $@.awk < "$(srcdir)"/$@.in >_$@ 2>&1 ||
echo EXIT CODE: $$? >>_$@
- @-$(CMP) "$(srcdir)"/$@.ok _$@ && rm -f _$@
-
double1:
@echo $@ $(ZOS_FAIL)
@AWKPATH="$(srcdir)" $(AWK) -f $@.awk >_$@ 2>&1 || echo EXIT CODE: $$?
>>_$@
diff --git a/test/symtab11.awk b/test/symtab11.awk
new file mode 100644
index 0000000..ec7f096
--- /dev/null
+++ b/test/symtab11.awk
@@ -0,0 +1,30 @@
+BEGIN {
+ PROCINFO["sorted_in"] = "@val_type_asc" # okay with PROCINFO commented
out, kaboom if not
+ IGNORECASE = 1 # yes
+
+ printf("BEGIN -- Symtab is next\n") > "/dev/stdout"
+ for (i in SYMTAB) {
+ printf "[%s]\n", i # else
{printf("[%s]\t(%s)\n",i,SYMTAB[i]);}
+ }
+ printf("BEGIN-- after Symtab loop\n") > "/dev/stdout" # never got here
+
+ printf("BEGIN -- Functab is next\n") > "/dev/stdout"
+ for (i in FUNCTAB) {
+ printf "[%s]\n", i # else
{printf("[%s]\t(%s)\n",i,FUNCTAB[i]);}
+ }
+ printf("BEGIN-- after Functab loop\n") > "/dev/stdout" # never got here
+ exit
+}
+
+function foo()
+{
+ print "foo called"
+}
+
+function bar()
+{
+ print "bar called"
+}
+
+# e-o-begin
+# --- No END, No Main ... ---
diff --git a/test/symtab11.ok b/test/symtab11.ok
new file mode 100644
index 0000000..c5e3e0f
--- /dev/null
+++ b/test/symtab11.ok
@@ -0,0 +1,76 @@
+BEGIN -- Symtab is next
+[i]
+[ROUNDMODE]
+[ORS]
+[OFS]
+[LINT]
+[FNR]
+[ERRNO]
+[NR]
+[IGNORECASE]
+[TEXTDOMAIN]
+[NF]
+[ARGIND]
+[ARGC]
+[FIELDWIDTHS]
+[CONVFMT]
+[SUBSEP]
+[PREC]
+[RS]
+[FPAT]
+[RT]
+[RLENGTH]
+[OFMT]
+[FS]
+[RSTART]
+[FILENAME]
+[BINMODE]
+[ARGV]
+[PROCINFO]
+[ENVIRON]
+BEGIN-- after Symtab loop
+BEGIN -- Functab is next
+[rand]
+[dcgettext]
+[gsub]
+[match]
+[int]
+[log]
+[sprintf]
+[systime]
+[strftime]
+[length]
+[and]
+[srand]
+[asort]
+[atan2]
+[cos]
+[split]
+[compl]
+[bindtextdomain]
+[exp]
+[or]
+[fflush]
+[gensub]
+[dcngettext]
+[index]
+[system]
+[sqrt]
+[rshift]
+[tolower]
+[sin]
+[asorti]
+[typeof]
+[close]
+[mktime]
+[isarray]
+[patsplit]
+[sub]
+[substr]
+[xor]
+[lshift]
+[strtonum]
+[toupper]
+[bar]
+[foo]
+BEGIN-- after Functab loop
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 11 +
TODO | 5 +-
array.c | 39 ++-
doc/ChangeLog | 6 +
doc/gawk.info | 872 +++++++++++++++++++++++++++---------------------------
doc/gawk.texi | 13 +
doc/gawktexi.in | 13 +
test/ChangeLog | 5 +
test/Makefile.am | 8 +-
test/Makefile.in | 76 +----
test/Maketests | 60 ----
test/symtab11.awk | 30 ++
test/symtab11.ok | 76 +++++
13 files changed, 651 insertions(+), 563 deletions(-)
create mode 100644 test/symtab11.awk
create mode 100644 test/symtab11.ok
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, master, updated. gawk-4.1.0-3874-gc0dfb92,
Arnold Robbins <=