aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawk.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gawk.texi')
-rw-r--r--doc/gawk.texi13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5e344e52..1a41f880 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