diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 1087 |
1 files changed, 546 insertions, 541 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index d11fdac9..aad73f7a 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -14,7 +14,7 @@ Free Software Foundation, Inc. This is Edition 4.1 of `GAWK: Effective AWK Programming: A User's -Guide for GNU Awk', for the 4.1.0 (or later) version of the GNU +Guide for GNU Awk', for the 4.1.1 (or later) version of the GNU implementation of AWK. Permission is granted to copy, distribute and/or modify this document @@ -45,7 +45,7 @@ Free Software Foundation, Inc. This is Edition 4.1 of `GAWK: Effective AWK Programming: A User's -Guide for GNU Awk', for the 4.1.0 (or later) version of the GNU +Guide for GNU Awk', for the 4.1.1 (or later) version of the GNU implementation of AWK. Permission is granted to copy, distribute and/or modify this document @@ -583,7 +583,8 @@ texts being (a) (see below), and with the Back-Cover Texts being (b) version of `awk'. * POSIX/GNU:: The extensions in `gawk' not in POSIX `awk'. -* Feature History:: The history of the features in `gawk'. +* Feature History:: The history of the features in + `gawk'. * Common Extensions:: Common Extensions Summary. * Ranges and Locales:: How locales used to affect regexp ranges. @@ -9963,7 +9964,7 @@ with a pound sign (`#'). the `delete' statement with the `SYMTAB' array. You may use an index for `SYMTAB' that is not a predefined - identifer: + identifier: SYMTAB["xxx"] = 5 print SYMTAB["xxx"] @@ -12620,7 +12621,7 @@ of Arrays::). traversing a multidimensional array: you can test if an element is itself an array or not. The second is inside the body of a user-defined function (not discussed yet; *note User-defined::), to -test if a paramater is an array or not. +test if a parameter is an array or not. Note, however, that using `isarray()' at the global level to test variables makes no sense. Since you are the one writing the program, you @@ -21181,11 +21182,15 @@ need it. arbitrary precision arithmetic. The easiest way to find out is to look at the output of the following command: - $ gawk --version - -| GNU Awk 4.1.0, API: 1.0 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2) - -| Copyright (C) 1989, 1991-2013 Free Software Foundation. + $ ./gawk --version + -| GNU Awk 4.1.1, API: 1.1 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2) + -| Copyright (C) 1989, 1991-2014 Free Software Foundation. ... +(You may see different version numbers than what's shown here. That's +OK; what's important is to see that GNU MPFR and GNU MP are listed in +the output.) + `gawk' uses the GNU MPFR (http://www.mpfr.org) and GNU MP (http://gmplib.org) (GMP) libraries for arbitrary precision arithmetic on numbers. So if you do not see the names of these libraries in the @@ -26055,7 +26060,7 @@ There are three ways to get GNU software: supported. If you have the `wget' program, you can use a command like the following: - wget http://ftp.gnu.org/gnu/gawk/gawk-4.1.0.tar.gz + wget http://ftp.gnu.org/gnu/gawk/gawk-4.1.1.tar.gz The GNU software archive is mirrored around the world. The up-to-date list of mirror sites is available from the main FSF web site @@ -26074,26 +26079,26 @@ compression programs: `gzip', `bzip2', and `xz'. For simplicity, the rest of these instructions assume you are using the one compressed with the GNU Zip program, `gzip'. - Once you have the distribution (for example, `gawk-4.1.0.tar.gz'), + Once you have the distribution (for example, `gawk-4.1.1.tar.gz'), use `gzip' to expand the file and then use `tar' to extract it. You can use the following pipeline to produce the `gawk' distribution: # Under System V, add 'o' to the tar options - gzip -d -c gawk-4.1.0.tar.gz | tar -xvpf - + gzip -d -c gawk-4.1.1.tar.gz | tar -xvpf - On a system with GNU `tar', you can let `tar' do the decompression for you: - tar -xvpzf gawk-4.1.0.tar.gz + tar -xvpzf gawk-4.1.1.tar.gz -Extracting the archive creates a directory named `gawk-4.1.0' in the +Extracting the archive creates a directory named `gawk-4.1.1' in the current directory. The distribution file name is of the form `gawk-V.R.P.tar.gz'. The V represents the major version of `gawk', the R represents the current release of version V, and the P represents a "patch level", meaning that minor bugs have been fixed in the release. The current patch -level is 0, but when retrieving distributions, you should get the +level is 1, but when retrieving distributions, you should get the version with the highest version, release, and patch level. (Note, however, that patch levels greater than or equal to 70 denote "beta" or nonproduction software; you might not want to retrieve such a version @@ -26303,7 +26308,7 @@ Unix-derived systems, GNU/Linux, BSD-based systems, and the Cygwin environment for MS-Windows. After you have extracted the `gawk' distribution, `cd' to -`gawk-4.1.0'. Like most GNU software, `gawk' is configured +`gawk-4.1.1'. Like most GNU software, `gawk' is configured automatically for your system by running the `configure' program. This program is a Bourne shell script that is generated automatically using GNU `autoconf'. (The `autoconf' software is described fully starting @@ -26726,8 +26731,8 @@ GNU tools, such as Bash, the GNU Compiler Collection (GCC), GNU Make, and other GNU programs. Compilation and installation for Cygwin is the same as for a Unix system: - tar -xvpzf gawk-4.1.0.tar.gz - cd gawk-4.1.0 + tar -xvpzf gawk-4.1.1.tar.gz + cd gawk-4.1.1 ./configure make @@ -33098,529 +33103,529 @@ Index Tag Table: Node: Top1292 -Node: Foreword40781 -Node: Preface45126 -Ref: Preface-Footnote-148179 -Ref: Preface-Footnote-248275 -Node: History48507 -Node: Names50881 -Ref: Names-Footnote-152358 -Node: This Manual52430 -Ref: This Manual-Footnote-158204 -Node: Conventions58304 -Node: Manual History60460 -Ref: Manual History-Footnote-163908 -Ref: Manual History-Footnote-263949 -Node: How To Contribute64023 -Node: Acknowledgments65167 -Node: Getting Started69361 -Node: Running gawk71740 -Node: One-shot72926 -Node: Read Terminal74151 -Ref: Read Terminal-Footnote-175801 -Ref: Read Terminal-Footnote-276077 -Node: Long76248 -Node: Executable Scripts77624 -Ref: Executable Scripts-Footnote-179457 -Ref: Executable Scripts-Footnote-279559 -Node: Comments80106 -Node: Quoting82573 -Node: DOS Quoting87196 -Node: Sample Data Files87871 -Node: Very Simple90386 -Node: Two Rules95037 -Node: More Complex96935 -Ref: More Complex-Footnote-199865 -Node: Statements/Lines99950 -Ref: Statements/Lines-Footnote-1104413 -Node: Other Features104678 -Node: When105606 -Node: Invoking Gawk107753 -Node: Command Line109216 -Node: Options109999 -Ref: Options-Footnote-1125377 -Node: Other Arguments125402 -Node: Naming Standard Input128060 -Node: Environment Variables129154 -Node: AWKPATH Variable129712 -Ref: AWKPATH Variable-Footnote-1132493 -Ref: AWKPATH Variable-Footnote-2132538 -Node: AWKLIBPATH Variable132798 -Node: Other Environment Variables133516 -Node: Exit Status136479 -Node: Include Files137154 -Node: Loading Shared Libraries140723 -Node: Obsolete142087 -Node: Undocumented142784 -Node: Regexp143026 -Node: Regexp Usage144415 -Node: Escape Sequences146440 -Node: Regexp Operators152109 -Ref: Regexp Operators-Footnote-1159489 -Ref: Regexp Operators-Footnote-2159636 -Node: Bracket Expressions159734 -Ref: table-char-classes161624 -Node: GNU Regexp Operators164147 -Node: Case-sensitivity167870 -Ref: Case-sensitivity-Footnote-1170838 -Ref: Case-sensitivity-Footnote-2171073 -Node: Leftmost Longest171181 -Node: Computed Regexps172382 -Node: Reading Files175719 -Node: Records177721 -Ref: Records-Footnote-1187244 -Node: Fields187281 -Ref: Fields-Footnote-1190237 -Node: Nonconstant Fields190323 -Node: Changing Fields192529 -Node: Field Separators198488 -Node: Default Field Splitting201190 -Node: Regexp Field Splitting202307 -Node: Single Character Fields205649 -Node: Command Line Field Separator206708 -Node: Full Line Fields210050 -Ref: Full Line Fields-Footnote-1210558 -Node: Field Splitting Summary210604 -Ref: Field Splitting Summary-Footnote-1213703 -Node: Constant Size213804 -Node: Splitting By Content218411 -Ref: Splitting By Content-Footnote-1222160 -Node: Multiple Line222200 -Ref: Multiple Line-Footnote-1228047 -Node: Getline228226 -Node: Plain Getline230442 -Node: Getline/Variable232537 -Node: Getline/File233684 -Node: Getline/Variable/File235025 -Ref: Getline/Variable/File-Footnote-1236624 -Node: Getline/Pipe236711 -Node: Getline/Variable/Pipe239410 -Node: Getline/Coprocess240517 -Node: Getline/Variable/Coprocess241769 -Node: Getline Notes242506 -Node: Getline Summary245293 -Ref: table-getline-variants245701 -Node: Read Timeout246613 -Ref: Read Timeout-Footnote-1250354 -Node: Command line directories250411 -Node: Printing251041 -Node: Print252672 -Node: Print Examples254009 -Node: Output Separators256793 -Node: OFMT258809 -Node: Printf260167 -Node: Basic Printf261073 -Node: Control Letters262612 -Node: Format Modifiers266424 -Node: Printf Examples272433 -Node: Redirection275145 -Node: Special Files282119 -Node: Special FD282652 -Ref: Special FD-Footnote-1286277 -Node: Special Network286351 -Node: Special Caveats287201 -Node: Close Files And Pipes287997 -Ref: Close Files And Pipes-Footnote-1294980 -Ref: Close Files And Pipes-Footnote-2295128 -Node: Expressions295278 -Node: Values296410 -Node: Constants297086 -Node: Scalar Constants297766 -Ref: Scalar Constants-Footnote-1298625 -Node: Nondecimal-numbers298807 -Node: Regexp Constants301807 -Node: Using Constant Regexps302282 -Node: Variables305337 -Node: Using Variables305992 -Node: Assignment Options307716 -Node: Conversion309591 -Ref: table-locale-affects315091 -Ref: Conversion-Footnote-1315715 -Node: All Operators315824 -Node: Arithmetic Ops316454 -Node: Concatenation318959 -Ref: Concatenation-Footnote-1321747 -Node: Assignment Ops321867 -Ref: table-assign-ops326855 -Node: Increment Ops328186 -Node: Truth Values and Conditions331620 -Node: Truth Values332703 -Node: Typing and Comparison333752 -Node: Variable Typing334545 -Ref: Variable Typing-Footnote-1338442 -Node: Comparison Operators338564 -Ref: table-relational-ops338974 -Node: POSIX String Comparison342522 -Ref: POSIX String Comparison-Footnote-1343478 -Node: Boolean Ops343616 -Ref: Boolean Ops-Footnote-1347686 -Node: Conditional Exp347777 -Node: Function Calls349509 -Node: Precedence353103 -Node: Locales356772 -Node: Patterns and Actions357861 -Node: Pattern Overview358915 -Node: Regexp Patterns360584 -Node: Expression Patterns361127 -Node: Ranges364908 -Node: BEGIN/END368012 -Node: Using BEGIN/END368774 -Ref: Using BEGIN/END-Footnote-1371510 -Node: I/O And BEGIN/END371616 -Node: BEGINFILE/ENDFILE373898 -Node: Empty376812 -Node: Using Shell Variables377129 -Node: Action Overview379414 -Node: Statements381771 -Node: If Statement383625 -Node: While Statement385124 -Node: Do Statement387168 -Node: For Statement388324 -Node: Switch Statement391476 -Node: Break Statement393630 -Node: Continue Statement395620 -Node: Next Statement397413 -Node: Nextfile Statement399803 -Node: Exit Statement402458 -Node: Built-in Variables404874 -Node: User-modified405969 -Ref: User-modified-Footnote-1414327 -Node: Auto-set414389 -Ref: Auto-set-Footnote-1427845 -Ref: Auto-set-Footnote-2428050 -Node: ARGC and ARGV428106 -Node: Arrays431960 -Node: Array Basics433465 -Node: Array Intro434291 -Node: Reference to Elements438608 -Node: Assigning Elements440878 -Node: Array Example441369 -Node: Scanning an Array443101 -Node: Controlling Scanning445415 -Ref: Controlling Scanning-Footnote-1450502 -Node: Delete450818 -Ref: Delete-Footnote-1453583 -Node: Numeric Array Subscripts453640 -Node: Uninitialized Subscripts455823 -Node: Multidimensional457450 -Node: Multiscanning460543 -Node: Arrays of Arrays462132 -Node: Functions466772 -Node: Built-in467591 -Node: Calling Built-in468669 -Node: Numeric Functions470657 -Ref: Numeric Functions-Footnote-1474489 -Ref: Numeric Functions-Footnote-2474846 -Ref: Numeric Functions-Footnote-3474894 -Node: String Functions475163 -Ref: String Functions-Footnote-1498121 -Ref: String Functions-Footnote-2498250 -Ref: String Functions-Footnote-3498498 -Node: Gory Details498585 -Ref: table-sub-escapes500264 -Ref: table-sub-posix-92501618 -Ref: table-sub-proposed502969 -Ref: table-posix-sub504323 -Ref: table-gensub-escapes505868 -Ref: Gory Details-Footnote-1507044 -Ref: Gory Details-Footnote-2507095 -Node: I/O Functions507246 -Ref: I/O Functions-Footnote-1514236 -Node: Time Functions514383 -Ref: Time Functions-Footnote-1525366 -Ref: Time Functions-Footnote-2525434 -Ref: Time Functions-Footnote-3525592 -Ref: Time Functions-Footnote-4525703 -Ref: Time Functions-Footnote-5525815 -Ref: Time Functions-Footnote-6526042 -Node: Bitwise Functions526308 -Ref: table-bitwise-ops526870 -Ref: Bitwise Functions-Footnote-1531091 -Node: Type Functions531275 -Node: I18N Functions532426 -Node: User-defined534053 -Node: Definition Syntax534857 -Ref: Definition Syntax-Footnote-1539771 -Node: Function Example539840 -Ref: Function Example-Footnote-1542489 -Node: Function Caveats542511 -Node: Calling A Function543029 -Node: Variable Scope543984 -Node: Pass By Value/Reference546947 -Node: Return Statement550455 -Node: Dynamic Typing553436 -Node: Indirect Calls554367 -Node: Library Functions564054 -Ref: Library Functions-Footnote-1567567 -Ref: Library Functions-Footnote-2567710 -Node: Library Names567881 -Ref: Library Names-Footnote-1571354 -Ref: Library Names-Footnote-2571574 -Node: General Functions571660 -Node: Strtonum Function572688 -Node: Assert Function575618 -Node: Round Function578944 -Node: Cliff Random Function580485 -Node: Ordinal Functions581501 -Ref: Ordinal Functions-Footnote-1584578 -Ref: Ordinal Functions-Footnote-2584830 -Node: Join Function585041 -Ref: Join Function-Footnote-1586812 -Node: Getlocaltime Function587012 -Node: Readfile Function590753 -Node: Data File Management592592 -Node: Filetrans Function593224 -Node: Rewind Function597293 -Node: File Checking598680 -Node: Empty Files599774 -Node: Ignoring Assigns602004 -Node: Getopt Function603558 -Ref: Getopt Function-Footnote-1614861 -Node: Passwd Functions615064 -Ref: Passwd Functions-Footnote-1624042 -Node: Group Functions624130 -Node: Walking Arrays632214 -Node: Sample Programs634350 -Node: Running Examples635024 -Node: Clones635752 -Node: Cut Program636976 -Node: Egrep Program646827 -Ref: Egrep Program-Footnote-1654600 -Node: Id Program654710 -Node: Split Program658359 -Ref: Split Program-Footnote-1661878 -Node: Tee Program662006 -Node: Uniq Program664809 -Node: Wc Program672238 -Ref: Wc Program-Footnote-1676504 -Ref: Wc Program-Footnote-2676704 -Node: Miscellaneous Programs676796 -Node: Dupword Program677984 -Node: Alarm Program680015 -Node: Translate Program684822 -Ref: Translate Program-Footnote-1689209 -Ref: Translate Program-Footnote-2689457 -Node: Labels Program689591 -Ref: Labels Program-Footnote-1692962 -Node: Word Sorting693046 -Node: History Sorting696930 -Node: Extract Program698769 -Ref: Extract Program-Footnote-1706272 -Node: Simple Sed706400 -Node: Igawk Program709462 -Ref: Igawk Program-Footnote-1724619 -Ref: Igawk Program-Footnote-2724820 -Node: Anagram Program724958 -Node: Signature Program728026 -Node: Advanced Features729126 -Node: Nondecimal Data731012 -Node: Array Sorting732595 -Node: Controlling Array Traversal733292 -Node: Array Sorting Functions741576 -Ref: Array Sorting Functions-Footnote-1745445 -Node: Two-way I/O745639 -Ref: Two-way I/O-Footnote-1751071 -Node: TCP/IP Networking751153 -Node: Profiling753997 -Node: Internationalization761500 -Node: I18N and L10N762925 -Node: Explaining gettext763611 -Ref: Explaining gettext-Footnote-1768679 -Ref: Explaining gettext-Footnote-2768863 -Node: Programmer i18n769028 -Node: Translator i18n773230 -Node: String Extraction774024 -Ref: String Extraction-Footnote-1774985 -Node: Printf Ordering775071 -Ref: Printf Ordering-Footnote-1777853 -Node: I18N Portability777917 -Ref: I18N Portability-Footnote-1780366 -Node: I18N Example780429 -Ref: I18N Example-Footnote-1783067 -Node: Gawk I18N783139 -Node: Debugger783760 -Node: Debugging784731 -Node: Debugging Concepts785164 -Node: Debugging Terms787020 -Node: Awk Debugging789617 -Node: Sample Debugging Session790509 -Node: Debugger Invocation791029 -Node: Finding The Bug792362 -Node: List of Debugger Commands798849 -Node: Breakpoint Control800183 -Node: Debugger Execution Control803847 -Node: Viewing And Changing Data807207 -Node: Execution Stack810563 -Node: Debugger Info812030 -Node: Miscellaneous Debugger Commands816012 -Node: Readline Support821188 -Node: Limitations822019 -Node: Arbitrary Precision Arithmetic824271 -Ref: Arbitrary Precision Arithmetic-Footnote-1825920 -Node: General Arithmetic826068 -Node: Floating Point Issues827788 -Node: String Conversion Precision828669 -Ref: String Conversion Precision-Footnote-1830374 -Node: Unexpected Results830483 -Node: POSIX Floating Point Problems832636 -Ref: POSIX Floating Point Problems-Footnote-1836461 -Node: Integer Programming836499 -Node: Floating-point Programming838238 -Ref: Floating-point Programming-Footnote-1844569 -Ref: Floating-point Programming-Footnote-2844839 -Node: Floating-point Representation845103 -Node: Floating-point Context846268 -Ref: table-ieee-formats847107 -Node: Rounding Mode848491 -Ref: table-rounding-modes848970 -Ref: Rounding Mode-Footnote-1851985 -Node: Gawk and MPFR852164 -Node: Arbitrary Precision Floats853419 -Ref: Arbitrary Precision Floats-Footnote-1855862 -Node: Setting Precision856178 -Ref: table-predefined-precision-strings856864 -Node: Setting Rounding Mode859009 -Ref: table-gawk-rounding-modes859413 -Node: Floating-point Constants860600 -Node: Changing Precision862029 -Ref: Changing Precision-Footnote-1863426 -Node: Exact Arithmetic863600 -Node: Arbitrary Precision Integers866738 -Ref: Arbitrary Precision Integers-Footnote-1869753 -Node: Dynamic Extensions869900 -Node: Extension Intro871358 -Node: Plugin License872623 -Node: Extension Mechanism Outline873308 -Ref: load-extension873725 -Ref: load-new-function875203 -Ref: call-new-function876198 -Node: Extension API Description878213 -Node: Extension API Functions Introduction879500 -Node: General Data Types884427 -Ref: General Data Types-Footnote-1890122 -Node: Requesting Values890421 -Ref: table-value-types-returned891158 -Node: Memory Allocation Functions892112 -Ref: Memory Allocation Functions-Footnote-1894858 -Node: Constructor Functions894954 -Node: Registration Functions896712 -Node: Extension Functions897397 -Node: Exit Callback Functions899699 -Node: Extension Version String900948 -Node: Input Parsers901598 -Node: Output Wrappers911355 -Node: Two-way processors915865 -Node: Printing Messages918073 -Ref: Printing Messages-Footnote-1919150 -Node: Updating `ERRNO'919302 -Node: Accessing Parameters920041 -Node: Symbol Table Access921271 -Node: Symbol table by name921785 -Node: Symbol table by cookie923761 -Ref: Symbol table by cookie-Footnote-1927893 -Node: Cached values927956 -Ref: Cached values-Footnote-1931446 -Node: Array Manipulation931537 -Ref: Array Manipulation-Footnote-1932635 -Node: Array Data Types932674 -Ref: Array Data Types-Footnote-1935377 -Node: Array Functions935469 -Node: Flattening Arrays939305 -Node: Creating Arrays946157 -Node: Extension API Variables950882 -Node: Extension Versioning951518 -Node: Extension API Informational Variables953419 -Node: Extension API Boilerplate954505 -Node: Finding Extensions958309 -Node: Extension Example958869 -Node: Internal File Description959599 -Node: Internal File Ops963690 -Ref: Internal File Ops-Footnote-1975199 -Node: Using Internal File Ops975339 -Ref: Using Internal File Ops-Footnote-1977692 -Node: Extension Samples977958 -Node: Extension Sample File Functions979482 -Node: Extension Sample Fnmatch987967 -Node: Extension Sample Fork989736 -Node: Extension Sample Inplace990949 -Node: Extension Sample Ord992727 -Node: Extension Sample Readdir993563 -Node: Extension Sample Revout995095 -Node: Extension Sample Rev2way995688 -Node: Extension Sample Read write array996378 -Node: Extension Sample Readfile998261 -Node: Extension Sample API Tests999361 -Node: Extension Sample Time999886 -Node: gawkextlib1001250 -Node: Language History1004031 -Node: V7/SVR3.11005624 -Node: SVR41007944 -Node: POSIX1009386 -Node: BTL1010772 -Node: POSIX/GNU1011506 -Node: Feature History1017105 -Node: Common Extensions1030081 -Node: Ranges and Locales1031393 -Ref: Ranges and Locales-Footnote-11036010 -Ref: Ranges and Locales-Footnote-21036037 -Ref: Ranges and Locales-Footnote-31036271 -Node: Contributors1036492 -Node: Installation1041873 -Node: Gawk Distribution1042767 -Node: Getting1043251 -Node: Extracting1044077 -Node: Distribution contents1045769 -Node: Unix Installation1051474 -Node: Quick Installation1052091 -Node: Additional Configuration Options1054537 -Node: Configuration Philosophy1056273 -Node: Non-Unix Installation1058627 -Node: PC Installation1059085 -Node: PC Binary Installation1060384 -Node: PC Compiling1062232 -Node: PC Testing1065176 -Node: PC Using1066352 -Node: Cygwin1070520 -Node: MSYS1071329 -Node: VMS Installation1071843 -Node: VMS Compilation1072607 -Ref: VMS Compilation-Footnote-11073859 -Node: VMS Dynamic Extensions1073917 -Node: VMS Installation Details1075290 -Node: VMS Running1077541 -Node: VMS GNV1080375 -Node: VMS Old Gawk1081098 -Node: Bugs1081568 -Node: Other Versions1085486 -Node: Notes1091570 -Node: Compatibility Mode1092370 -Node: Additions1093153 -Node: Accessing The Source1094080 -Node: Adding Code1095520 -Node: New Ports1101565 -Node: Derived Files1105700 -Ref: Derived Files-Footnote-11111021 -Ref: Derived Files-Footnote-21111055 -Ref: Derived Files-Footnote-31111655 -Node: Future Extensions1111753 -Node: Implementation Limitations1112336 -Node: Extension Design1113588 -Node: Old Extension Problems1114742 -Ref: Old Extension Problems-Footnote-11116250 -Node: Extension New Mechanism Goals1116307 -Ref: Extension New Mechanism Goals-Footnote-11119672 -Node: Extension Other Design Decisions1119858 -Node: Extension Future Growth1121964 -Node: Old Extension Mechanism1122800 -Node: Basic Concepts1124540 -Node: Basic High Level1125221 -Ref: figure-general-flow1125493 -Ref: figure-process-flow1126092 -Ref: Basic High Level-Footnote-11129321 -Node: Basic Data Typing1129506 -Node: Glossary1132861 -Node: Copying1158092 -Node: GNU Free Documentation License1195648 -Node: Index1220784 +Node: Foreword40821 +Node: Preface45166 +Ref: Preface-Footnote-148219 +Ref: Preface-Footnote-248315 +Node: History48547 +Node: Names50921 +Ref: Names-Footnote-152398 +Node: This Manual52470 +Ref: This Manual-Footnote-158244 +Node: Conventions58344 +Node: Manual History60500 +Ref: Manual History-Footnote-163948 +Ref: Manual History-Footnote-263989 +Node: How To Contribute64063 +Node: Acknowledgments65207 +Node: Getting Started69401 +Node: Running gawk71780 +Node: One-shot72966 +Node: Read Terminal74191 +Ref: Read Terminal-Footnote-175841 +Ref: Read Terminal-Footnote-276117 +Node: Long76288 +Node: Executable Scripts77664 +Ref: Executable Scripts-Footnote-179497 +Ref: Executable Scripts-Footnote-279599 +Node: Comments80146 +Node: Quoting82613 +Node: DOS Quoting87236 +Node: Sample Data Files87911 +Node: Very Simple90426 +Node: Two Rules95077 +Node: More Complex96975 +Ref: More Complex-Footnote-199905 +Node: Statements/Lines99990 +Ref: Statements/Lines-Footnote-1104453 +Node: Other Features104718 +Node: When105646 +Node: Invoking Gawk107793 +Node: Command Line109256 +Node: Options110039 +Ref: Options-Footnote-1125417 +Node: Other Arguments125442 +Node: Naming Standard Input128100 +Node: Environment Variables129194 +Node: AWKPATH Variable129752 +Ref: AWKPATH Variable-Footnote-1132533 +Ref: AWKPATH Variable-Footnote-2132578 +Node: AWKLIBPATH Variable132838 +Node: Other Environment Variables133556 +Node: Exit Status136519 +Node: Include Files137194 +Node: Loading Shared Libraries140763 +Node: Obsolete142127 +Node: Undocumented142824 +Node: Regexp143066 +Node: Regexp Usage144455 +Node: Escape Sequences146480 +Node: Regexp Operators152149 +Ref: Regexp Operators-Footnote-1159529 +Ref: Regexp Operators-Footnote-2159676 +Node: Bracket Expressions159774 +Ref: table-char-classes161664 +Node: GNU Regexp Operators164187 +Node: Case-sensitivity167910 +Ref: Case-sensitivity-Footnote-1170878 +Ref: Case-sensitivity-Footnote-2171113 +Node: Leftmost Longest171221 +Node: Computed Regexps172422 +Node: Reading Files175759 +Node: Records177761 +Ref: Records-Footnote-1187284 +Node: Fields187321 +Ref: Fields-Footnote-1190277 +Node: Nonconstant Fields190363 +Node: Changing Fields192569 +Node: Field Separators198528 +Node: Default Field Splitting201230 +Node: Regexp Field Splitting202347 +Node: Single Character Fields205689 +Node: Command Line Field Separator206748 +Node: Full Line Fields210090 +Ref: Full Line Fields-Footnote-1210598 +Node: Field Splitting Summary210644 +Ref: Field Splitting Summary-Footnote-1213743 +Node: Constant Size213844 +Node: Splitting By Content218451 +Ref: Splitting By Content-Footnote-1222200 +Node: Multiple Line222240 +Ref: Multiple Line-Footnote-1228087 +Node: Getline228266 +Node: Plain Getline230482 +Node: Getline/Variable232577 +Node: Getline/File233724 +Node: Getline/Variable/File235065 +Ref: Getline/Variable/File-Footnote-1236664 +Node: Getline/Pipe236751 +Node: Getline/Variable/Pipe239450 +Node: Getline/Coprocess240557 +Node: Getline/Variable/Coprocess241809 +Node: Getline Notes242546 +Node: Getline Summary245333 +Ref: table-getline-variants245741 +Node: Read Timeout246653 +Ref: Read Timeout-Footnote-1250394 +Node: Command line directories250451 +Node: Printing251081 +Node: Print252712 +Node: Print Examples254049 +Node: Output Separators256833 +Node: OFMT258849 +Node: Printf260207 +Node: Basic Printf261113 +Node: Control Letters262652 +Node: Format Modifiers266464 +Node: Printf Examples272473 +Node: Redirection275185 +Node: Special Files282159 +Node: Special FD282692 +Ref: Special FD-Footnote-1286317 +Node: Special Network286391 +Node: Special Caveats287241 +Node: Close Files And Pipes288037 +Ref: Close Files And Pipes-Footnote-1295020 +Ref: Close Files And Pipes-Footnote-2295168 +Node: Expressions295318 +Node: Values296450 +Node: Constants297126 +Node: Scalar Constants297806 +Ref: Scalar Constants-Footnote-1298665 +Node: Nondecimal-numbers298847 +Node: Regexp Constants301847 +Node: Using Constant Regexps302322 +Node: Variables305377 +Node: Using Variables306032 +Node: Assignment Options307756 +Node: Conversion309631 +Ref: table-locale-affects315131 +Ref: Conversion-Footnote-1315755 +Node: All Operators315864 +Node: Arithmetic Ops316494 +Node: Concatenation318999 +Ref: Concatenation-Footnote-1321787 +Node: Assignment Ops321907 +Ref: table-assign-ops326895 +Node: Increment Ops328226 +Node: Truth Values and Conditions331660 +Node: Truth Values332743 +Node: Typing and Comparison333792 +Node: Variable Typing334585 +Ref: Variable Typing-Footnote-1338482 +Node: Comparison Operators338604 +Ref: table-relational-ops339014 +Node: POSIX String Comparison342562 +Ref: POSIX String Comparison-Footnote-1343518 +Node: Boolean Ops343656 +Ref: Boolean Ops-Footnote-1347726 +Node: Conditional Exp347817 +Node: Function Calls349549 +Node: Precedence353143 +Node: Locales356812 +Node: Patterns and Actions357901 +Node: Pattern Overview358955 +Node: Regexp Patterns360624 +Node: Expression Patterns361167 +Node: Ranges364948 +Node: BEGIN/END368052 +Node: Using BEGIN/END368814 +Ref: Using BEGIN/END-Footnote-1371550 +Node: I/O And BEGIN/END371656 +Node: BEGINFILE/ENDFILE373938 +Node: Empty376852 +Node: Using Shell Variables377169 +Node: Action Overview379454 +Node: Statements381811 +Node: If Statement383665 +Node: While Statement385164 +Node: Do Statement387208 +Node: For Statement388364 +Node: Switch Statement391516 +Node: Break Statement393670 +Node: Continue Statement395660 +Node: Next Statement397453 +Node: Nextfile Statement399843 +Node: Exit Statement402498 +Node: Built-in Variables404914 +Node: User-modified406009 +Ref: User-modified-Footnote-1414367 +Node: Auto-set414429 +Ref: Auto-set-Footnote-1427886 +Ref: Auto-set-Footnote-2428091 +Node: ARGC and ARGV428147 +Node: Arrays432001 +Node: Array Basics433506 +Node: Array Intro434332 +Node: Reference to Elements438649 +Node: Assigning Elements440919 +Node: Array Example441410 +Node: Scanning an Array443142 +Node: Controlling Scanning445456 +Ref: Controlling Scanning-Footnote-1450543 +Node: Delete450859 +Ref: Delete-Footnote-1453624 +Node: Numeric Array Subscripts453681 +Node: Uninitialized Subscripts455864 +Node: Multidimensional457491 +Node: Multiscanning460584 +Node: Arrays of Arrays462173 +Node: Functions466813 +Node: Built-in467632 +Node: Calling Built-in468710 +Node: Numeric Functions470698 +Ref: Numeric Functions-Footnote-1474530 +Ref: Numeric Functions-Footnote-2474887 +Ref: Numeric Functions-Footnote-3474935 +Node: String Functions475204 +Ref: String Functions-Footnote-1498162 +Ref: String Functions-Footnote-2498291 +Ref: String Functions-Footnote-3498539 +Node: Gory Details498626 +Ref: table-sub-escapes500305 +Ref: table-sub-posix-92501659 +Ref: table-sub-proposed503010 +Ref: table-posix-sub504364 +Ref: table-gensub-escapes505909 +Ref: Gory Details-Footnote-1507085 +Ref: Gory Details-Footnote-2507136 +Node: I/O Functions507287 +Ref: I/O Functions-Footnote-1514277 +Node: Time Functions514424 +Ref: Time Functions-Footnote-1525407 +Ref: Time Functions-Footnote-2525475 +Ref: Time Functions-Footnote-3525633 +Ref: Time Functions-Footnote-4525744 +Ref: Time Functions-Footnote-5525856 +Ref: Time Functions-Footnote-6526083 +Node: Bitwise Functions526349 +Ref: table-bitwise-ops526911 +Ref: Bitwise Functions-Footnote-1531132 +Node: Type Functions531316 +Node: I18N Functions532467 +Node: User-defined534094 +Node: Definition Syntax534898 +Ref: Definition Syntax-Footnote-1539812 +Node: Function Example539881 +Ref: Function Example-Footnote-1542530 +Node: Function Caveats542552 +Node: Calling A Function543070 +Node: Variable Scope544025 +Node: Pass By Value/Reference546988 +Node: Return Statement550496 +Node: Dynamic Typing553477 +Node: Indirect Calls554408 +Node: Library Functions564095 +Ref: Library Functions-Footnote-1567608 +Ref: Library Functions-Footnote-2567751 +Node: Library Names567922 +Ref: Library Names-Footnote-1571395 +Ref: Library Names-Footnote-2571615 +Node: General Functions571701 +Node: Strtonum Function572729 +Node: Assert Function575659 +Node: Round Function578985 +Node: Cliff Random Function580526 +Node: Ordinal Functions581542 +Ref: Ordinal Functions-Footnote-1584619 +Ref: Ordinal Functions-Footnote-2584871 +Node: Join Function585082 +Ref: Join Function-Footnote-1586853 +Node: Getlocaltime Function587053 +Node: Readfile Function590794 +Node: Data File Management592633 +Node: Filetrans Function593265 +Node: Rewind Function597334 +Node: File Checking598721 +Node: Empty Files599815 +Node: Ignoring Assigns602045 +Node: Getopt Function603599 +Ref: Getopt Function-Footnote-1614902 +Node: Passwd Functions615105 +Ref: Passwd Functions-Footnote-1624083 +Node: Group Functions624171 +Node: Walking Arrays632255 +Node: Sample Programs634391 +Node: Running Examples635065 +Node: Clones635793 +Node: Cut Program637017 +Node: Egrep Program646868 +Ref: Egrep Program-Footnote-1654641 +Node: Id Program654751 +Node: Split Program658400 +Ref: Split Program-Footnote-1661919 +Node: Tee Program662047 +Node: Uniq Program664850 +Node: Wc Program672279 +Ref: Wc Program-Footnote-1676545 +Ref: Wc Program-Footnote-2676745 +Node: Miscellaneous Programs676837 +Node: Dupword Program678025 +Node: Alarm Program680056 +Node: Translate Program684863 +Ref: Translate Program-Footnote-1689250 +Ref: Translate Program-Footnote-2689498 +Node: Labels Program689632 +Ref: Labels Program-Footnote-1693003 +Node: Word Sorting693087 +Node: History Sorting696971 +Node: Extract Program698810 +Ref: Extract Program-Footnote-1706313 +Node: Simple Sed706441 +Node: Igawk Program709503 +Ref: Igawk Program-Footnote-1724660 +Ref: Igawk Program-Footnote-2724861 +Node: Anagram Program724999 +Node: Signature Program728067 +Node: Advanced Features729167 +Node: Nondecimal Data731053 +Node: Array Sorting732636 +Node: Controlling Array Traversal733333 +Node: Array Sorting Functions741617 +Ref: Array Sorting Functions-Footnote-1745486 +Node: Two-way I/O745680 +Ref: Two-way I/O-Footnote-1751112 +Node: TCP/IP Networking751194 +Node: Profiling754038 +Node: Internationalization761541 +Node: I18N and L10N762966 +Node: Explaining gettext763652 +Ref: Explaining gettext-Footnote-1768720 +Ref: Explaining gettext-Footnote-2768904 +Node: Programmer i18n769069 +Node: Translator i18n773271 +Node: String Extraction774065 +Ref: String Extraction-Footnote-1775026 +Node: Printf Ordering775112 +Ref: Printf Ordering-Footnote-1777894 +Node: I18N Portability777958 +Ref: I18N Portability-Footnote-1780407 +Node: I18N Example780470 +Ref: I18N Example-Footnote-1783108 +Node: Gawk I18N783180 +Node: Debugger783801 +Node: Debugging784772 +Node: Debugging Concepts785205 +Node: Debugging Terms787061 +Node: Awk Debugging789658 +Node: Sample Debugging Session790550 +Node: Debugger Invocation791070 +Node: Finding The Bug792403 +Node: List of Debugger Commands798890 +Node: Breakpoint Control800224 +Node: Debugger Execution Control803888 +Node: Viewing And Changing Data807248 +Node: Execution Stack810604 +Node: Debugger Info812071 +Node: Miscellaneous Debugger Commands816053 +Node: Readline Support821229 +Node: Limitations822060 +Node: Arbitrary Precision Arithmetic824312 +Ref: Arbitrary Precision Arithmetic-Footnote-1825961 +Node: General Arithmetic826109 +Node: Floating Point Issues827829 +Node: String Conversion Precision828710 +Ref: String Conversion Precision-Footnote-1830415 +Node: Unexpected Results830524 +Node: POSIX Floating Point Problems832677 +Ref: POSIX Floating Point Problems-Footnote-1836502 +Node: Integer Programming836540 +Node: Floating-point Programming838279 +Ref: Floating-point Programming-Footnote-1844610 +Ref: Floating-point Programming-Footnote-2844880 +Node: Floating-point Representation845144 +Node: Floating-point Context846309 +Ref: table-ieee-formats847148 +Node: Rounding Mode848532 +Ref: table-rounding-modes849011 +Ref: Rounding Mode-Footnote-1852026 +Node: Gawk and MPFR852205 +Node: Arbitrary Precision Floats853616 +Ref: Arbitrary Precision Floats-Footnote-1856059 +Node: Setting Precision856375 +Ref: table-predefined-precision-strings857061 +Node: Setting Rounding Mode859206 +Ref: table-gawk-rounding-modes859610 +Node: Floating-point Constants860797 +Node: Changing Precision862226 +Ref: Changing Precision-Footnote-1863623 +Node: Exact Arithmetic863797 +Node: Arbitrary Precision Integers866935 +Ref: Arbitrary Precision Integers-Footnote-1869950 +Node: Dynamic Extensions870097 +Node: Extension Intro871555 +Node: Plugin License872820 +Node: Extension Mechanism Outline873505 +Ref: load-extension873922 +Ref: load-new-function875400 +Ref: call-new-function876395 +Node: Extension API Description878410 +Node: Extension API Functions Introduction879697 +Node: General Data Types884624 +Ref: General Data Types-Footnote-1890319 +Node: Requesting Values890618 +Ref: table-value-types-returned891355 +Node: Memory Allocation Functions892309 +Ref: Memory Allocation Functions-Footnote-1895055 +Node: Constructor Functions895151 +Node: Registration Functions896909 +Node: Extension Functions897594 +Node: Exit Callback Functions899896 +Node: Extension Version String901145 +Node: Input Parsers901795 +Node: Output Wrappers911552 +Node: Two-way processors916062 +Node: Printing Messages918270 +Ref: Printing Messages-Footnote-1919347 +Node: Updating `ERRNO'919499 +Node: Accessing Parameters920238 +Node: Symbol Table Access921468 +Node: Symbol table by name921982 +Node: Symbol table by cookie923958 +Ref: Symbol table by cookie-Footnote-1928090 +Node: Cached values928153 +Ref: Cached values-Footnote-1931643 +Node: Array Manipulation931734 +Ref: Array Manipulation-Footnote-1932832 +Node: Array Data Types932871 +Ref: Array Data Types-Footnote-1935574 +Node: Array Functions935666 +Node: Flattening Arrays939502 +Node: Creating Arrays946354 +Node: Extension API Variables951079 +Node: Extension Versioning951715 +Node: Extension API Informational Variables953616 +Node: Extension API Boilerplate954702 +Node: Finding Extensions958506 +Node: Extension Example959066 +Node: Internal File Description959796 +Node: Internal File Ops963887 +Ref: Internal File Ops-Footnote-1975396 +Node: Using Internal File Ops975536 +Ref: Using Internal File Ops-Footnote-1977889 +Node: Extension Samples978155 +Node: Extension Sample File Functions979679 +Node: Extension Sample Fnmatch988164 +Node: Extension Sample Fork989933 +Node: Extension Sample Inplace991146 +Node: Extension Sample Ord992924 +Node: Extension Sample Readdir993760 +Node: Extension Sample Revout995292 +Node: Extension Sample Rev2way995885 +Node: Extension Sample Read write array996575 +Node: Extension Sample Readfile998458 +Node: Extension Sample API Tests999558 +Node: Extension Sample Time1000083 +Node: gawkextlib1001447 +Node: Language History1004228 +Node: V7/SVR3.11005821 +Node: SVR41008141 +Node: POSIX1009583 +Node: BTL1010969 +Node: POSIX/GNU1011703 +Node: Feature History1017302 +Node: Common Extensions1030278 +Node: Ranges and Locales1031590 +Ref: Ranges and Locales-Footnote-11036207 +Ref: Ranges and Locales-Footnote-21036234 +Ref: Ranges and Locales-Footnote-31036468 +Node: Contributors1036689 +Node: Installation1042070 +Node: Gawk Distribution1042964 +Node: Getting1043448 +Node: Extracting1044274 +Node: Distribution contents1045966 +Node: Unix Installation1051671 +Node: Quick Installation1052288 +Node: Additional Configuration Options1054734 +Node: Configuration Philosophy1056470 +Node: Non-Unix Installation1058824 +Node: PC Installation1059282 +Node: PC Binary Installation1060581 +Node: PC Compiling1062429 +Node: PC Testing1065373 +Node: PC Using1066549 +Node: Cygwin1070717 +Node: MSYS1071526 +Node: VMS Installation1072040 +Node: VMS Compilation1072804 +Ref: VMS Compilation-Footnote-11074056 +Node: VMS Dynamic Extensions1074114 +Node: VMS Installation Details1075487 +Node: VMS Running1077738 +Node: VMS GNV1080572 +Node: VMS Old Gawk1081295 +Node: Bugs1081765 +Node: Other Versions1085683 +Node: Notes1091767 +Node: Compatibility Mode1092567 +Node: Additions1093350 +Node: Accessing The Source1094277 +Node: Adding Code1095717 +Node: New Ports1101762 +Node: Derived Files1105897 +Ref: Derived Files-Footnote-11111218 +Ref: Derived Files-Footnote-21111252 +Ref: Derived Files-Footnote-31111852 +Node: Future Extensions1111950 +Node: Implementation Limitations1112533 +Node: Extension Design1113785 +Node: Old Extension Problems1114939 +Ref: Old Extension Problems-Footnote-11116447 +Node: Extension New Mechanism Goals1116504 +Ref: Extension New Mechanism Goals-Footnote-11119869 +Node: Extension Other Design Decisions1120055 +Node: Extension Future Growth1122161 +Node: Old Extension Mechanism1122997 +Node: Basic Concepts1124737 +Node: Basic High Level1125418 +Ref: figure-general-flow1125690 +Ref: figure-process-flow1126289 +Ref: Basic High Level-Footnote-11129518 +Node: Basic Data Typing1129703 +Node: Glossary1133058 +Node: Copying1158289 +Node: GNU Free Documentation License1195845 +Node: Index1220981 End Tag Table |