diff options
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/gawk.info | 990 | ||||
-rw-r--r-- | doc/gawk.texi | 11 | ||||
-rw-r--r-- | doc/gawktexi.in | 11 |
4 files changed, 526 insertions, 491 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 8c979068..43646426 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2014-07-04 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Bracket Expressions): Add a note about how to + match ASCII characters. Thanks to Hermann Peifer. + 2014-06-25 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Update permissions on copyright page per diff --git a/doc/gawk.info b/doc/gawk.info index 65ac7ab8..8b5e572f 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -3670,6 +3670,14 @@ set had other alphabetic characters in it, this would not match them. With the POSIX character classes, you can write `/[[:alnum:]]/' to match the alphabetic and numeric characters in your character set. + Some utilities that match regular expressions provide a non-standard +`[:ascii:]' character class; `awk' does not. However, you can simulate +such a construct using `[\x00-\x7F]'. This matches all values +numerically between zero and 127, which is the defined range of the +ASCII character set. Use a complemented character list +(`[^\x00-\x7F]') to match any single-byte characters that are not in +the ASCII range. + Two additional special sequences can appear in bracket expressions. These apply to non-ASCII character sets, which can have single symbols (called "collating elements") that are represented with more than one @@ -31475,13 +31483,13 @@ Index * bracket expressions, character classes: Bracket Expressions. (line 30) * bracket expressions, collating elements: Bracket Expressions. - (line 69) + (line 77) * bracket expressions, collating symbols: Bracket Expressions. - (line 76) + (line 84) * bracket expressions, complemented: Regexp Operators. (line 64) * bracket expressions, equivalence classes: Bracket Expressions. - (line 82) -* bracket expressions, non-ASCII: Bracket Expressions. (line 69) + (line 90) +* bracket expressions, non-ASCII: Bracket Expressions. (line 77) * bracket expressions, range expressions: Bracket Expressions. (line 6) * break debugger command: Breakpoint Control. (line 11) @@ -31599,8 +31607,8 @@ Index * Close, Diane <1>: Contributors. (line 20) * Close, Diane: Manual History. (line 41) * Collado, Manuel: Acknowledgments. (line 60) -* collating elements: Bracket Expressions. (line 69) -* collating symbols: Bracket Expressions. (line 76) +* collating elements: Bracket Expressions. (line 77) +* collating symbols: Bracket Expressions. (line 84) * Colombo, Antonio <1>: Contributors. (line 137) * Colombo, Antonio: Acknowledgments. (line 60) * columns, aligning: Print Examples. (line 70) @@ -32392,7 +32400,7 @@ Index * gawk, bitwise operations in: Bitwise Functions. (line 39) * gawk, break statement in: Break Statement. (line 51) * gawk, built-in variables and: Built-in Variables. (line 14) -* gawk, character classes and: Bracket Expressions. (line 90) +* gawk, character classes and: Bracket Expressions. (line 98) * gawk, coding style in: Adding Code. (line 39) * gawk, command-line options, and regular expressions: GNU Regexp Operators. (line 70) @@ -32668,7 +32676,7 @@ Index (line 13) * internationalization, localization: User-modified. (line 152) * internationalization, localization, character classes: Bracket Expressions. - (line 90) + (line 98) * internationalization, localization, gawk and: Internationalization. (line 13) * internationalization, localization, locale categories: Explaining gettext. @@ -34007,488 +34015,488 @@ Ref: Regexp Operators-Footnote-1165517 Ref: Regexp Operators-Footnote-2165664 Node: Bracket Expressions165762 Ref: table-char-classes167652 -Node: GNU Regexp Operators170175 -Node: Case-sensitivity173898 -Ref: Case-sensitivity-Footnote-1176790 -Ref: Case-sensitivity-Footnote-2177025 -Node: Leftmost Longest177133 -Node: Computed Regexps178334 -Node: Regexp Summary181706 -Node: Reading Files183177 -Node: Records185269 -Node: awk split records186012 -Node: gawk split records190870 -Ref: gawk split records-Footnote-1195391 -Node: Fields195428 -Ref: Fields-Footnote-1198392 -Node: Nonconstant Fields198478 -Ref: Nonconstant Fields-Footnote-1200708 -Node: Changing Fields200910 -Node: Field Separators206864 -Node: Default Field Splitting209566 -Node: Regexp Field Splitting210683 -Node: Single Character Fields214024 -Node: Command Line Field Separator215083 -Node: Full Line Fields218425 -Ref: Full Line Fields-Footnote-1218933 -Node: Field Splitting Summary218979 -Ref: Field Splitting Summary-Footnote-1222078 -Node: Constant Size222179 -Node: Splitting By Content226786 -Ref: Splitting By Content-Footnote-1230536 -Node: Multiple Line230576 -Ref: Multiple Line-Footnote-1236432 -Node: Getline236611 -Node: Plain Getline238827 -Node: Getline/Variable240922 -Node: Getline/File242069 -Node: Getline/Variable/File243453 -Ref: Getline/Variable/File-Footnote-1245052 -Node: Getline/Pipe245139 -Node: Getline/Variable/Pipe247838 -Node: Getline/Coprocess248945 -Node: Getline/Variable/Coprocess250197 -Node: Getline Notes250934 -Node: Getline Summary253738 -Ref: table-getline-variants254146 -Node: Read Timeout255058 -Ref: Read Timeout-Footnote-1258885 -Node: Command line directories258943 -Node: Input Summary259847 -Node: Input Exercises262984 -Node: Printing263717 -Node: Print265439 -Node: Print Examples266780 -Node: Output Separators269559 -Node: OFMT271575 -Node: Printf272933 -Node: Basic Printf273839 -Node: Control Letters275378 -Node: Format Modifiers279230 -Node: Printf Examples285257 -Node: Redirection287721 -Node: Special Files294693 -Node: Special FD295224 -Ref: Special FD-Footnote-1298848 -Node: Special Network298922 -Node: Special Caveats299772 -Node: Close Files And Pipes300568 -Ref: Close Files And Pipes-Footnote-1307729 -Ref: Close Files And Pipes-Footnote-2307877 -Node: Output Summary308027 -Node: Output exercises309024 -Node: Expressions309704 -Node: Values310889 -Node: Constants311565 -Node: Scalar Constants312245 -Ref: Scalar Constants-Footnote-1313104 -Node: Nondecimal-numbers313354 -Node: Regexp Constants316354 -Node: Using Constant Regexps316829 -Node: Variables319899 -Node: Using Variables320554 -Node: Assignment Options322278 -Node: Conversion324153 -Node: Strings And Numbers324677 -Ref: Strings And Numbers-Footnote-1327739 -Node: Locale influences conversions327848 -Ref: table-locale-affects330565 -Node: All Operators331153 -Node: Arithmetic Ops331783 -Node: Concatenation334288 -Ref: Concatenation-Footnote-1337084 -Node: Assignment Ops337204 -Ref: table-assign-ops342187 -Node: Increment Ops343504 -Node: Truth Values and Conditions346942 -Node: Truth Values348025 -Node: Typing and Comparison349074 -Node: Variable Typing349867 -Ref: Variable Typing-Footnote-1353767 -Node: Comparison Operators353889 -Ref: table-relational-ops354299 -Node: POSIX String Comparison357849 -Ref: POSIX String Comparison-Footnote-1358933 -Node: Boolean Ops359071 -Ref: Boolean Ops-Footnote-1363141 -Node: Conditional Exp363232 -Node: Function Calls364959 -Node: Precedence368839 -Node: Locales372508 -Node: Expressions Summary374139 -Node: Patterns and Actions376680 -Node: Pattern Overview377796 -Node: Regexp Patterns379473 -Node: Expression Patterns380016 -Node: Ranges383797 -Node: BEGIN/END386903 -Node: Using BEGIN/END387665 -Ref: Using BEGIN/END-Footnote-1390401 -Node: I/O And BEGIN/END390507 -Node: BEGINFILE/ENDFILE392792 -Node: Empty395723 -Node: Using Shell Variables396040 -Node: Action Overview398323 -Node: Statements400650 -Node: If Statement402498 -Node: While Statement403996 -Node: Do Statement406040 -Node: For Statement407196 -Node: Switch Statement410348 -Node: Break Statement412451 -Node: Continue Statement414506 -Node: Next Statement416299 -Node: Nextfile Statement418689 -Node: Exit Statement421344 -Node: Built-in Variables423748 -Node: User-modified424875 -Ref: User-modified-Footnote-1432564 -Node: Auto-set432626 -Ref: Auto-set-Footnote-1445208 -Ref: Auto-set-Footnote-2445413 -Node: ARGC and ARGV445469 -Node: Pattern Action Summary449323 -Node: Arrays451546 -Node: Array Basics453095 -Node: Array Intro453921 -Ref: figure-array-elements455894 -Node: Reference to Elements458301 -Node: Assigning Elements460574 -Node: Array Example461065 -Node: Scanning an Array462797 -Node: Controlling Scanning465812 -Ref: Controlling Scanning-Footnote-1470985 -Node: Delete471301 -Ref: Delete-Footnote-1474066 -Node: Numeric Array Subscripts474123 -Node: Uninitialized Subscripts476306 -Node: Multidimensional477931 -Node: Multiscanning481024 -Node: Arrays of Arrays482613 -Node: Arrays Summary487276 -Node: Functions489381 -Node: Built-in490254 -Node: Calling Built-in491332 -Node: Numeric Functions493320 -Ref: Numeric Functions-Footnote-1497154 -Ref: Numeric Functions-Footnote-2497511 -Ref: Numeric Functions-Footnote-3497559 -Node: String Functions497828 -Ref: String Functions-Footnote-1520839 -Ref: String Functions-Footnote-2520968 -Ref: String Functions-Footnote-3521216 -Node: Gory Details521303 -Ref: table-sub-escapes522972 -Ref: table-sub-posix-92524326 -Ref: table-sub-proposed525677 -Ref: table-posix-sub527031 -Ref: table-gensub-escapes528576 -Ref: Gory Details-Footnote-1529752 -Ref: Gory Details-Footnote-2529803 -Node: I/O Functions529954 -Ref: I/O Functions-Footnote-1537077 -Node: Time Functions537224 -Ref: Time Functions-Footnote-1547688 -Ref: Time Functions-Footnote-2547756 -Ref: Time Functions-Footnote-3547914 -Ref: Time Functions-Footnote-4548025 -Ref: Time Functions-Footnote-5548137 -Ref: Time Functions-Footnote-6548364 -Node: Bitwise Functions548630 -Ref: table-bitwise-ops549192 -Ref: Bitwise Functions-Footnote-1553437 -Node: Type Functions553621 -Node: I18N Functions554763 -Node: User-defined556408 -Node: Definition Syntax557212 -Ref: Definition Syntax-Footnote-1562391 -Node: Function Example562460 -Ref: Function Example-Footnote-1565104 -Node: Function Caveats565126 -Node: Calling A Function565644 -Node: Variable Scope566599 -Node: Pass By Value/Reference569587 -Node: Return Statement573095 -Node: Dynamic Typing576079 -Node: Indirect Calls577008 -Node: Functions Summary586721 -Node: Library Functions589260 -Ref: Library Functions-Footnote-1592878 -Ref: Library Functions-Footnote-2593021 -Node: Library Names593192 -Ref: Library Names-Footnote-1596665 -Ref: Library Names-Footnote-2596885 -Node: General Functions596971 -Node: Strtonum Function597999 -Node: Assert Function600779 -Node: Round Function604105 -Node: Cliff Random Function605646 -Node: Ordinal Functions606662 -Ref: Ordinal Functions-Footnote-1609739 -Ref: Ordinal Functions-Footnote-2609991 -Node: Join Function610202 -Ref: Join Function-Footnote-1611973 -Node: Getlocaltime Function612173 -Node: Readfile Function615909 -Node: Data File Management617748 -Node: Filetrans Function618380 -Node: Rewind Function622449 -Node: File Checking623836 -Ref: File Checking-Footnote-1624968 -Node: Empty Files625169 -Node: Ignoring Assigns627148 -Node: Getopt Function628702 -Ref: Getopt Function-Footnote-1640005 -Node: Passwd Functions640208 -Ref: Passwd Functions-Footnote-1649187 -Node: Group Functions649275 -Ref: Group Functions-Footnote-1657216 -Node: Walking Arrays657429 -Node: Library Functions Summary659032 -Node: Library exercises660420 -Node: Sample Programs661700 -Node: Running Examples662470 -Node: Clones663198 -Node: Cut Program664422 -Node: Egrep Program674290 -Ref: Egrep Program-Footnote-1682261 -Node: Id Program682371 -Node: Split Program686035 -Ref: Split Program-Footnote-1689573 -Node: Tee Program689701 -Node: Uniq Program692508 -Node: Wc Program699938 -Ref: Wc Program-Footnote-1704203 -Node: Miscellaneous Programs704295 -Node: Dupword Program705508 -Node: Alarm Program707539 -Node: Translate Program712353 -Ref: Translate Program-Footnote-1716744 -Ref: Translate Program-Footnote-2717014 -Node: Labels Program717148 -Ref: Labels Program-Footnote-1720519 -Node: Word Sorting720603 -Node: History Sorting724646 -Node: Extract Program726482 -Node: Simple Sed734018 -Node: Igawk Program737080 -Ref: Igawk Program-Footnote-1751391 -Ref: Igawk Program-Footnote-2751592 -Node: Anagram Program751730 -Node: Signature Program754798 -Node: Programs Summary756045 -Node: Programs Exercises757260 -Node: Advanced Features760911 -Node: Nondecimal Data762859 -Node: Array Sorting764436 -Node: Controlling Array Traversal765133 -Node: Array Sorting Functions773413 -Ref: Array Sorting Functions-Footnote-1777320 -Node: Two-way I/O777514 -Ref: Two-way I/O-Footnote-1783030 -Node: TCP/IP Networking783112 -Node: Profiling785956 -Node: Advanced Features Summary793498 -Node: Internationalization795362 -Node: I18N and L10N796842 -Node: Explaining gettext797528 -Ref: Explaining gettext-Footnote-1802668 -Ref: Explaining gettext-Footnote-2802852 -Node: Programmer i18n803017 -Node: Translator i18n807242 -Node: String Extraction808036 -Ref: String Extraction-Footnote-1808997 -Node: Printf Ordering809083 -Ref: Printf Ordering-Footnote-1811865 -Node: I18N Portability811929 -Ref: I18N Portability-Footnote-1814378 -Node: I18N Example814441 -Ref: I18N Example-Footnote-1817163 -Node: Gawk I18N817235 -Node: I18N Summary817873 -Node: Debugger819212 -Node: Debugging820234 -Node: Debugging Concepts820675 -Node: Debugging Terms822531 -Node: Awk Debugging825128 -Node: Sample Debugging Session826020 -Node: Debugger Invocation826540 -Node: Finding The Bug827873 -Node: List of Debugger Commands834355 -Node: Breakpoint Control835687 -Node: Debugger Execution Control839351 -Node: Viewing And Changing Data842711 -Node: Execution Stack846069 -Node: Debugger Info847582 -Node: Miscellaneous Debugger Commands851576 -Node: Readline Support856760 -Node: Limitations857652 -Node: Debugging Summary859926 -Node: Arbitrary Precision Arithmetic861090 -Node: Computer Arithmetic862419 -Ref: Computer Arithmetic-Footnote-1866806 -Node: Math Definitions866863 -Ref: table-ieee-formats869747 -Node: MPFR features870251 -Node: FP Math Caution871893 -Ref: FP Math Caution-Footnote-1872934 -Node: Inexactness of computations873303 -Node: Inexact representation874251 -Node: Comparing FP Values875606 -Node: Errors accumulate876570 -Node: Getting Accuracy878003 -Node: Try To Round880662 -Node: Setting precision881561 -Ref: table-predefined-precision-strings882243 -Node: Setting the rounding mode884036 -Ref: table-gawk-rounding-modes884400 -Ref: Setting the rounding mode-Footnote-1887854 -Node: Arbitrary Precision Integers888033 -Ref: Arbitrary Precision Integers-Footnote-1891036 -Node: POSIX Floating Point Problems891185 -Ref: POSIX Floating Point Problems-Footnote-1895061 -Node: Floating point summary895099 -Node: Dynamic Extensions897316 -Node: Extension Intro898868 -Node: Plugin License900133 -Node: Extension Mechanism Outline900818 -Ref: figure-load-extension901242 -Ref: figure-load-new-function902727 -Ref: figure-call-new-function903729 -Node: Extension API Description905713 -Node: Extension API Functions Introduction907163 -Node: General Data Types912028 -Ref: General Data Types-Footnote-1917721 -Node: Requesting Values918020 -Ref: table-value-types-returned918757 -Node: Memory Allocation Functions919715 -Ref: Memory Allocation Functions-Footnote-1922462 -Node: Constructor Functions922558 -Node: Registration Functions924316 -Node: Extension Functions925001 -Node: Exit Callback Functions927303 -Node: Extension Version String928552 -Node: Input Parsers929202 -Node: Output Wrappers939005 -Node: Two-way processors943521 -Node: Printing Messages945725 -Ref: Printing Messages-Footnote-1946802 -Node: Updating `ERRNO'946954 -Node: Accessing Parameters947693 -Node: Symbol Table Access948923 -Node: Symbol table by name949437 -Node: Symbol table by cookie951413 -Ref: Symbol table by cookie-Footnote-1955546 -Node: Cached values955609 -Ref: Cached values-Footnote-1959113 -Node: Array Manipulation959204 -Ref: Array Manipulation-Footnote-1960302 -Node: Array Data Types960341 -Ref: Array Data Types-Footnote-1963044 -Node: Array Functions963136 -Node: Flattening Arrays967010 -Node: Creating Arrays973862 -Node: Extension API Variables978593 -Node: Extension Versioning979229 -Node: Extension API Informational Variables981130 -Node: Extension API Boilerplate982216 -Node: Finding Extensions986020 -Node: Extension Example986580 -Node: Internal File Description987310 -Node: Internal File Ops991401 -Ref: Internal File Ops-Footnote-11002833 -Node: Using Internal File Ops1002973 -Ref: Using Internal File Ops-Footnote-11005320 -Node: Extension Samples1005588 -Node: Extension Sample File Functions1007112 -Node: Extension Sample Fnmatch1014680 -Node: Extension Sample Fork1016162 -Node: Extension Sample Inplace1017375 -Node: Extension Sample Ord1019050 -Node: Extension Sample Readdir1019886 -Ref: table-readdir-file-types1020742 -Node: Extension Sample Revout1021541 -Node: Extension Sample Rev2way1022132 -Node: Extension Sample Read write array1022873 -Node: Extension Sample Readfile1024752 -Node: Extension Sample API Tests1025852 -Node: Extension Sample Time1026377 -Node: gawkextlib1027692 -Node: Extension summary1030505 -Node: Extension Exercises1034198 -Node: Language History1034920 -Node: V7/SVR3.11036563 -Node: SVR41038883 -Node: POSIX1040325 -Node: BTL1041711 -Node: POSIX/GNU1042445 -Node: Feature History1048044 -Node: Common Extensions1061174 -Node: Ranges and Locales1062486 -Ref: Ranges and Locales-Footnote-11067103 -Ref: Ranges and Locales-Footnote-21067130 -Ref: Ranges and Locales-Footnote-31067364 -Node: Contributors1067585 -Node: History summary1073010 -Node: Installation1074379 -Node: Gawk Distribution1075330 -Node: Getting1075814 -Node: Extracting1076638 -Node: Distribution contents1078280 -Node: Unix Installation1083997 -Node: Quick Installation1084614 -Node: Additional Configuration Options1087056 -Node: Configuration Philosophy1088794 -Node: Non-Unix Installation1091145 -Node: PC Installation1091603 -Node: PC Binary Installation1092914 -Node: PC Compiling1094762 -Ref: PC Compiling-Footnote-11097761 -Node: PC Testing1097866 -Node: PC Using1099042 -Node: Cygwin1103200 -Node: MSYS1104009 -Node: VMS Installation1104523 -Node: VMS Compilation1105319 -Ref: VMS Compilation-Footnote-11106541 -Node: VMS Dynamic Extensions1106599 -Node: VMS Installation Details1107972 -Node: VMS Running1110224 -Node: VMS GNV1113058 -Node: VMS Old Gawk1113781 -Node: Bugs1114251 -Node: Other Versions1118255 -Node: Installation summary1124510 -Node: Notes1125566 -Node: Compatibility Mode1126431 -Node: Additions1127213 -Node: Accessing The Source1128138 -Node: Adding Code1129574 -Node: New Ports1135752 -Node: Derived Files1140233 -Ref: Derived Files-Footnote-11145314 -Ref: Derived Files-Footnote-21145348 -Ref: Derived Files-Footnote-31145944 -Node: Future Extensions1146058 -Node: Implementation Limitations1146664 -Node: Extension Design1147912 -Node: Old Extension Problems1149066 -Ref: Old Extension Problems-Footnote-11150583 -Node: Extension New Mechanism Goals1150640 -Ref: Extension New Mechanism Goals-Footnote-11154000 -Node: Extension Other Design Decisions1154189 -Node: Extension Future Growth1156295 -Node: Old Extension Mechanism1157131 -Node: Notes summary1158893 -Node: Basic Concepts1160079 -Node: Basic High Level1160760 -Ref: figure-general-flow1161032 -Ref: figure-process-flow1161631 -Ref: Basic High Level-Footnote-11164860 -Node: Basic Data Typing1165045 -Node: Glossary1168373 -Node: Copying1193525 -Node: GNU Free Documentation License1231081 -Node: Index1256217 +Node: GNU Regexp Operators170592 +Node: Case-sensitivity174315 +Ref: Case-sensitivity-Footnote-1177207 +Ref: Case-sensitivity-Footnote-2177442 +Node: Leftmost Longest177550 +Node: Computed Regexps178751 +Node: Regexp Summary182123 +Node: Reading Files183594 +Node: Records185686 +Node: awk split records186429 +Node: gawk split records191287 +Ref: gawk split records-Footnote-1195808 +Node: Fields195845 +Ref: Fields-Footnote-1198809 +Node: Nonconstant Fields198895 +Ref: Nonconstant Fields-Footnote-1201125 +Node: Changing Fields201327 +Node: Field Separators207281 +Node: Default Field Splitting209983 +Node: Regexp Field Splitting211100 +Node: Single Character Fields214441 +Node: Command Line Field Separator215500 +Node: Full Line Fields218842 +Ref: Full Line Fields-Footnote-1219350 +Node: Field Splitting Summary219396 +Ref: Field Splitting Summary-Footnote-1222495 +Node: Constant Size222596 +Node: Splitting By Content227203 +Ref: Splitting By Content-Footnote-1230953 +Node: Multiple Line230993 +Ref: Multiple Line-Footnote-1236849 +Node: Getline237028 +Node: Plain Getline239244 +Node: Getline/Variable241339 +Node: Getline/File242486 +Node: Getline/Variable/File243870 +Ref: Getline/Variable/File-Footnote-1245469 +Node: Getline/Pipe245556 +Node: Getline/Variable/Pipe248255 +Node: Getline/Coprocess249362 +Node: Getline/Variable/Coprocess250614 +Node: Getline Notes251351 +Node: Getline Summary254155 +Ref: table-getline-variants254563 +Node: Read Timeout255475 +Ref: Read Timeout-Footnote-1259302 +Node: Command line directories259360 +Node: Input Summary260264 +Node: Input Exercises263401 +Node: Printing264134 +Node: Print265856 +Node: Print Examples267197 +Node: Output Separators269976 +Node: OFMT271992 +Node: Printf273350 +Node: Basic Printf274256 +Node: Control Letters275795 +Node: Format Modifiers279647 +Node: Printf Examples285674 +Node: Redirection288138 +Node: Special Files295110 +Node: Special FD295641 +Ref: Special FD-Footnote-1299265 +Node: Special Network299339 +Node: Special Caveats300189 +Node: Close Files And Pipes300985 +Ref: Close Files And Pipes-Footnote-1308146 +Ref: Close Files And Pipes-Footnote-2308294 +Node: Output Summary308444 +Node: Output exercises309441 +Node: Expressions310121 +Node: Values311306 +Node: Constants311982 +Node: Scalar Constants312662 +Ref: Scalar Constants-Footnote-1313521 +Node: Nondecimal-numbers313771 +Node: Regexp Constants316771 +Node: Using Constant Regexps317246 +Node: Variables320316 +Node: Using Variables320971 +Node: Assignment Options322695 +Node: Conversion324570 +Node: Strings And Numbers325094 +Ref: Strings And Numbers-Footnote-1328156 +Node: Locale influences conversions328265 +Ref: table-locale-affects330982 +Node: All Operators331570 +Node: Arithmetic Ops332200 +Node: Concatenation334705 +Ref: Concatenation-Footnote-1337501 +Node: Assignment Ops337621 +Ref: table-assign-ops342604 +Node: Increment Ops343921 +Node: Truth Values and Conditions347359 +Node: Truth Values348442 +Node: Typing and Comparison349491 +Node: Variable Typing350284 +Ref: Variable Typing-Footnote-1354184 +Node: Comparison Operators354306 +Ref: table-relational-ops354716 +Node: POSIX String Comparison358266 +Ref: POSIX String Comparison-Footnote-1359350 +Node: Boolean Ops359488 +Ref: Boolean Ops-Footnote-1363558 +Node: Conditional Exp363649 +Node: Function Calls365376 +Node: Precedence369256 +Node: Locales372925 +Node: Expressions Summary374556 +Node: Patterns and Actions377097 +Node: Pattern Overview378213 +Node: Regexp Patterns379890 +Node: Expression Patterns380433 +Node: Ranges384214 +Node: BEGIN/END387320 +Node: Using BEGIN/END388082 +Ref: Using BEGIN/END-Footnote-1390818 +Node: I/O And BEGIN/END390924 +Node: BEGINFILE/ENDFILE393209 +Node: Empty396140 +Node: Using Shell Variables396457 +Node: Action Overview398740 +Node: Statements401067 +Node: If Statement402915 +Node: While Statement404413 +Node: Do Statement406457 +Node: For Statement407613 +Node: Switch Statement410765 +Node: Break Statement412868 +Node: Continue Statement414923 +Node: Next Statement416716 +Node: Nextfile Statement419106 +Node: Exit Statement421761 +Node: Built-in Variables424165 +Node: User-modified425292 +Ref: User-modified-Footnote-1432981 +Node: Auto-set433043 +Ref: Auto-set-Footnote-1445625 +Ref: Auto-set-Footnote-2445830 +Node: ARGC and ARGV445886 +Node: Pattern Action Summary449740 +Node: Arrays451963 +Node: Array Basics453512 +Node: Array Intro454338 +Ref: figure-array-elements456311 +Node: Reference to Elements458718 +Node: Assigning Elements460991 +Node: Array Example461482 +Node: Scanning an Array463214 +Node: Controlling Scanning466229 +Ref: Controlling Scanning-Footnote-1471402 +Node: Delete471718 +Ref: Delete-Footnote-1474483 +Node: Numeric Array Subscripts474540 +Node: Uninitialized Subscripts476723 +Node: Multidimensional478348 +Node: Multiscanning481441 +Node: Arrays of Arrays483030 +Node: Arrays Summary487693 +Node: Functions489798 +Node: Built-in490671 +Node: Calling Built-in491749 +Node: Numeric Functions493737 +Ref: Numeric Functions-Footnote-1497571 +Ref: Numeric Functions-Footnote-2497928 +Ref: Numeric Functions-Footnote-3497976 +Node: String Functions498245 +Ref: String Functions-Footnote-1521256 +Ref: String Functions-Footnote-2521385 +Ref: String Functions-Footnote-3521633 +Node: Gory Details521720 +Ref: table-sub-escapes523389 +Ref: table-sub-posix-92524743 +Ref: table-sub-proposed526094 +Ref: table-posix-sub527448 +Ref: table-gensub-escapes528993 +Ref: Gory Details-Footnote-1530169 +Ref: Gory Details-Footnote-2530220 +Node: I/O Functions530371 +Ref: I/O Functions-Footnote-1537494 +Node: Time Functions537641 +Ref: Time Functions-Footnote-1548105 +Ref: Time Functions-Footnote-2548173 +Ref: Time Functions-Footnote-3548331 +Ref: Time Functions-Footnote-4548442 +Ref: Time Functions-Footnote-5548554 +Ref: Time Functions-Footnote-6548781 +Node: Bitwise Functions549047 +Ref: table-bitwise-ops549609 +Ref: Bitwise Functions-Footnote-1553854 +Node: Type Functions554038 +Node: I18N Functions555180 +Node: User-defined556825 +Node: Definition Syntax557629 +Ref: Definition Syntax-Footnote-1562808 +Node: Function Example562877 +Ref: Function Example-Footnote-1565521 +Node: Function Caveats565543 +Node: Calling A Function566061 +Node: Variable Scope567016 +Node: Pass By Value/Reference570004 +Node: Return Statement573512 +Node: Dynamic Typing576496 +Node: Indirect Calls577425 +Node: Functions Summary587138 +Node: Library Functions589677 +Ref: Library Functions-Footnote-1593295 +Ref: Library Functions-Footnote-2593438 +Node: Library Names593609 +Ref: Library Names-Footnote-1597082 +Ref: Library Names-Footnote-2597302 +Node: General Functions597388 +Node: Strtonum Function598416 +Node: Assert Function601196 +Node: Round Function604522 +Node: Cliff Random Function606063 +Node: Ordinal Functions607079 +Ref: Ordinal Functions-Footnote-1610156 +Ref: Ordinal Functions-Footnote-2610408 +Node: Join Function610619 +Ref: Join Function-Footnote-1612390 +Node: Getlocaltime Function612590 +Node: Readfile Function616326 +Node: Data File Management618165 +Node: Filetrans Function618797 +Node: Rewind Function622866 +Node: File Checking624253 +Ref: File Checking-Footnote-1625385 +Node: Empty Files625586 +Node: Ignoring Assigns627565 +Node: Getopt Function629119 +Ref: Getopt Function-Footnote-1640422 +Node: Passwd Functions640625 +Ref: Passwd Functions-Footnote-1649604 +Node: Group Functions649692 +Ref: Group Functions-Footnote-1657633 +Node: Walking Arrays657846 +Node: Library Functions Summary659449 +Node: Library exercises660837 +Node: Sample Programs662117 +Node: Running Examples662887 +Node: Clones663615 +Node: Cut Program664839 +Node: Egrep Program674707 +Ref: Egrep Program-Footnote-1682678 +Node: Id Program682788 +Node: Split Program686452 +Ref: Split Program-Footnote-1689990 +Node: Tee Program690118 +Node: Uniq Program692925 +Node: Wc Program700355 +Ref: Wc Program-Footnote-1704620 +Node: Miscellaneous Programs704712 +Node: Dupword Program705925 +Node: Alarm Program707956 +Node: Translate Program712770 +Ref: Translate Program-Footnote-1717161 +Ref: Translate Program-Footnote-2717431 +Node: Labels Program717565 +Ref: Labels Program-Footnote-1720936 +Node: Word Sorting721020 +Node: History Sorting725063 +Node: Extract Program726899 +Node: Simple Sed734435 +Node: Igawk Program737497 +Ref: Igawk Program-Footnote-1751808 +Ref: Igawk Program-Footnote-2752009 +Node: Anagram Program752147 +Node: Signature Program755215 +Node: Programs Summary756462 +Node: Programs Exercises757677 +Node: Advanced Features761328 +Node: Nondecimal Data763276 +Node: Array Sorting764853 +Node: Controlling Array Traversal765550 +Node: Array Sorting Functions773830 +Ref: Array Sorting Functions-Footnote-1777737 +Node: Two-way I/O777931 +Ref: Two-way I/O-Footnote-1783447 +Node: TCP/IP Networking783529 +Node: Profiling786373 +Node: Advanced Features Summary793915 +Node: Internationalization795779 +Node: I18N and L10N797259 +Node: Explaining gettext797945 +Ref: Explaining gettext-Footnote-1803085 +Ref: Explaining gettext-Footnote-2803269 +Node: Programmer i18n803434 +Node: Translator i18n807659 +Node: String Extraction808453 +Ref: String Extraction-Footnote-1809414 +Node: Printf Ordering809500 +Ref: Printf Ordering-Footnote-1812282 +Node: I18N Portability812346 +Ref: I18N Portability-Footnote-1814795 +Node: I18N Example814858 +Ref: I18N Example-Footnote-1817580 +Node: Gawk I18N817652 +Node: I18N Summary818290 +Node: Debugger819629 +Node: Debugging820651 +Node: Debugging Concepts821092 +Node: Debugging Terms822948 +Node: Awk Debugging825545 +Node: Sample Debugging Session826437 +Node: Debugger Invocation826957 +Node: Finding The Bug828290 +Node: List of Debugger Commands834772 +Node: Breakpoint Control836104 +Node: Debugger Execution Control839768 +Node: Viewing And Changing Data843128 +Node: Execution Stack846486 +Node: Debugger Info847999 +Node: Miscellaneous Debugger Commands851993 +Node: Readline Support857177 +Node: Limitations858069 +Node: Debugging Summary860343 +Node: Arbitrary Precision Arithmetic861507 +Node: Computer Arithmetic862836 +Ref: Computer Arithmetic-Footnote-1867223 +Node: Math Definitions867280 +Ref: table-ieee-formats870164 +Node: MPFR features870668 +Node: FP Math Caution872310 +Ref: FP Math Caution-Footnote-1873351 +Node: Inexactness of computations873720 +Node: Inexact representation874668 +Node: Comparing FP Values876023 +Node: Errors accumulate876987 +Node: Getting Accuracy878420 +Node: Try To Round881079 +Node: Setting precision881978 +Ref: table-predefined-precision-strings882660 +Node: Setting the rounding mode884453 +Ref: table-gawk-rounding-modes884817 +Ref: Setting the rounding mode-Footnote-1888271 +Node: Arbitrary Precision Integers888450 +Ref: Arbitrary Precision Integers-Footnote-1891453 +Node: POSIX Floating Point Problems891602 +Ref: POSIX Floating Point Problems-Footnote-1895478 +Node: Floating point summary895516 +Node: Dynamic Extensions897733 +Node: Extension Intro899285 +Node: Plugin License900550 +Node: Extension Mechanism Outline901235 +Ref: figure-load-extension901659 +Ref: figure-load-new-function903144 +Ref: figure-call-new-function904146 +Node: Extension API Description906130 +Node: Extension API Functions Introduction907580 +Node: General Data Types912445 +Ref: General Data Types-Footnote-1918138 +Node: Requesting Values918437 +Ref: table-value-types-returned919174 +Node: Memory Allocation Functions920132 +Ref: Memory Allocation Functions-Footnote-1922879 +Node: Constructor Functions922975 +Node: Registration Functions924733 +Node: Extension Functions925418 +Node: Exit Callback Functions927720 +Node: Extension Version String928969 +Node: Input Parsers929619 +Node: Output Wrappers939422 +Node: Two-way processors943938 +Node: Printing Messages946142 +Ref: Printing Messages-Footnote-1947219 +Node: Updating `ERRNO'947371 +Node: Accessing Parameters948110 +Node: Symbol Table Access949340 +Node: Symbol table by name949854 +Node: Symbol table by cookie951830 +Ref: Symbol table by cookie-Footnote-1955963 +Node: Cached values956026 +Ref: Cached values-Footnote-1959530 +Node: Array Manipulation959621 +Ref: Array Manipulation-Footnote-1960719 +Node: Array Data Types960758 +Ref: Array Data Types-Footnote-1963461 +Node: Array Functions963553 +Node: Flattening Arrays967427 +Node: Creating Arrays974279 +Node: Extension API Variables979010 +Node: Extension Versioning979646 +Node: Extension API Informational Variables981547 +Node: Extension API Boilerplate982633 +Node: Finding Extensions986437 +Node: Extension Example986997 +Node: Internal File Description987727 +Node: Internal File Ops991818 +Ref: Internal File Ops-Footnote-11003250 +Node: Using Internal File Ops1003390 +Ref: Using Internal File Ops-Footnote-11005737 +Node: Extension Samples1006005 +Node: Extension Sample File Functions1007529 +Node: Extension Sample Fnmatch1015097 +Node: Extension Sample Fork1016579 +Node: Extension Sample Inplace1017792 +Node: Extension Sample Ord1019467 +Node: Extension Sample Readdir1020303 +Ref: table-readdir-file-types1021159 +Node: Extension Sample Revout1021958 +Node: Extension Sample Rev2way1022549 +Node: Extension Sample Read write array1023290 +Node: Extension Sample Readfile1025169 +Node: Extension Sample API Tests1026269 +Node: Extension Sample Time1026794 +Node: gawkextlib1028109 +Node: Extension summary1030922 +Node: Extension Exercises1034615 +Node: Language History1035337 +Node: V7/SVR3.11036980 +Node: SVR41039300 +Node: POSIX1040742 +Node: BTL1042128 +Node: POSIX/GNU1042862 +Node: Feature History1048461 +Node: Common Extensions1061591 +Node: Ranges and Locales1062903 +Ref: Ranges and Locales-Footnote-11067520 +Ref: Ranges and Locales-Footnote-21067547 +Ref: Ranges and Locales-Footnote-31067781 +Node: Contributors1068002 +Node: History summary1073427 +Node: Installation1074796 +Node: Gawk Distribution1075747 +Node: Getting1076231 +Node: Extracting1077055 +Node: Distribution contents1078697 +Node: Unix Installation1084414 +Node: Quick Installation1085031 +Node: Additional Configuration Options1087473 +Node: Configuration Philosophy1089211 +Node: Non-Unix Installation1091562 +Node: PC Installation1092020 +Node: PC Binary Installation1093331 +Node: PC Compiling1095179 +Ref: PC Compiling-Footnote-11098178 +Node: PC Testing1098283 +Node: PC Using1099459 +Node: Cygwin1103617 +Node: MSYS1104426 +Node: VMS Installation1104940 +Node: VMS Compilation1105736 +Ref: VMS Compilation-Footnote-11106958 +Node: VMS Dynamic Extensions1107016 +Node: VMS Installation Details1108389 +Node: VMS Running1110641 +Node: VMS GNV1113475 +Node: VMS Old Gawk1114198 +Node: Bugs1114668 +Node: Other Versions1118672 +Node: Installation summary1124927 +Node: Notes1125983 +Node: Compatibility Mode1126848 +Node: Additions1127630 +Node: Accessing The Source1128555 +Node: Adding Code1129991 +Node: New Ports1136169 +Node: Derived Files1140650 +Ref: Derived Files-Footnote-11145731 +Ref: Derived Files-Footnote-21145765 +Ref: Derived Files-Footnote-31146361 +Node: Future Extensions1146475 +Node: Implementation Limitations1147081 +Node: Extension Design1148329 +Node: Old Extension Problems1149483 +Ref: Old Extension Problems-Footnote-11151000 +Node: Extension New Mechanism Goals1151057 +Ref: Extension New Mechanism Goals-Footnote-11154417 +Node: Extension Other Design Decisions1154606 +Node: Extension Future Growth1156712 +Node: Old Extension Mechanism1157548 +Node: Notes summary1159310 +Node: Basic Concepts1160496 +Node: Basic High Level1161177 +Ref: figure-general-flow1161449 +Ref: figure-process-flow1162048 +Ref: Basic High Level-Footnote-11165277 +Node: Basic Data Typing1165462 +Node: Glossary1168790 +Node: Copying1193942 +Node: GNU Free Documentation License1231498 +Node: Index1256634 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 08fca873..c6520ba3 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -5457,6 +5457,17 @@ With the POSIX character classes, you can write @code{/[[:alnum:]]/} to match the alphabetic and numeric characters in your character set. +@c Thanks to +@c Date: Tue, 01 Jul 2014 07:39:51 +0200 +@c From: Hermann Peifer <peifer@gmx.eu> +Some utilities that match regular expressions provide a non-standard +@code{[:ascii:]} character class; @command{awk} does not. However, you +can simulate such a construct using @code{[\x00-\x7F]}. This matches +all values numerically between zero and 127, which is the defined +range of the ASCII character set. Use a complemented character list +(@code{[^\x00-\x7F]}) to match any single-byte characters that are not +in the ASCII range. + @cindex bracket expressions, collating elements @cindex bracket expressions, non-ASCII @cindex collating elements diff --git a/doc/gawktexi.in b/doc/gawktexi.in index e1c157b4..d485a50d 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -5302,6 +5302,17 @@ With the POSIX character classes, you can write @code{/[[:alnum:]]/} to match the alphabetic and numeric characters in your character set. +@c Thanks to +@c Date: Tue, 01 Jul 2014 07:39:51 +0200 +@c From: Hermann Peifer <peifer@gmx.eu> +Some utilities that match regular expressions provide a non-standard +@code{[:ascii:]} character class; @command{awk} does not. However, you +can simulate such a construct using @code{[\x00-\x7F]}. This matches +all values numerically between zero and 127, which is the defined +range of the ASCII character set. Use a complemented character list +(@code{[^\x00-\x7F]}) to match any single-byte characters that are not +in the ASCII range. + @cindex bracket expressions, collating elements @cindex bracket expressions, non-ASCII @cindex collating elements |