diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 1090 |
1 files changed, 556 insertions, 534 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 4196f313..fcef0ee6 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10,8 +10,8 @@ START-INFO-DIR-ENTRY END-INFO-DIR-ENTRY Copyright (C) 1989, 1991, 1992, 1993, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013 Free -Software Foundation, Inc. +2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014 +Free Software Foundation, Inc. This is Edition 4.1 of `GAWK: Effective AWK Programming: A User's @@ -42,8 +42,8 @@ This file documents `awk', a program that you can use to select particular records in a file and perform operations upon them. Copyright (C) 1989, 1991, 1992, 1993, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013 Free -Software Foundation, Inc. +2001, 2002, 2003, 2004, 2005, 2007, 2009, 2010, 2011, 2012, 2013, 2014 +Free Software Foundation, Inc. This is Edition 4.1 of `GAWK: Effective AWK Programming: A User's @@ -193,6 +193,7 @@ texts being (a) (see below), and with the Back-Cover Texts being (b) field. * Command Line Field Separator:: Setting `FS' from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. * Constant Size:: Reading constant width data. * Splitting By Content:: Defining Fields By Content @@ -4384,6 +4385,7 @@ File: gawk.info, Node: Field Separators, Next: Constant Size, Prev: Changing * Regexp Field Splitting:: Using regexps as the field separator. * Single Character Fields:: Making each character a separate field. * Command Line Field Separator:: Setting `FS' from the command-line. +* Full Line Fields:: Making the full line be a single field. * Field Splitting Summary:: Some final points and a summary table. The "field separator", which is either a single character or a @@ -4565,7 +4567,7 @@ Options::), if `FS' is the null string, then `gawk' also behaves this way. -File: gawk.info, Node: Command Line Field Separator, Next: Field Splitting Summary, Prev: Single Character Fields, Up: Field Separators +File: gawk.info, Node: Command Line Field Separator, Next: Full Line Fields, Prev: Single Character Fields, Up: Field Separators 4.5.4 Setting `FS' from the Command Line ---------------------------------------- @@ -4652,9 +4654,27 @@ the entries for users who have no password: awk -F: '$2 == ""' /etc/passwd -File: gawk.info, Node: Field Splitting Summary, Prev: Command Line Field Separator, Up: Field Separators +File: gawk.info, Node: Full Line Fields, Next: Field Splitting Summary, Prev: Command Line Field Separator, Up: Field Separators -4.5.5 Field-Splitting Summary +4.5.5 Making The Full Line Be A Single Field +-------------------------------------------- + +Occasionally, it's useful to treat the whole input line as a single +field. This can be done easily and portably simply by setting `FS' to +`"\n"' (a newline).(1) + + awk -F'\n' 'PROGRAM' FILES ... + +When you do this, `$1' is the same as `$0'. + + ---------- Footnotes ---------- + + (1) Thanks to Andrew Schorr for this tip. + + +File: gawk.info, Node: Field Splitting Summary, Prev: Full Line Fields, Up: Field Separators + +4.5.6 Field-Splitting Summary ----------------------------- It is important to remember that when you assign a string constant as @@ -30022,7 +30042,7 @@ Index * Beebe, Nelson: Acknowledgments. (line 60) * BEGIN pattern <1>: Profiling. (line 62) * BEGIN pattern <2>: BEGIN/END. (line 6) -* BEGIN pattern <3>: Field Separators. (line 44) +* BEGIN pattern <3>: Field Separators. (line 45) * BEGIN pattern: Records. (line 29) * BEGIN pattern, assert() user-defined function and: Assert Function. (line 83) @@ -30682,8 +30702,8 @@ Index * field operator $: Fields. (line 19) * field operators, dollar sign as: Fields. (line 19) * field separators <1>: User-modified. (line 56) -* field separators: Field Separators. (line 14) -* field separators, choice of: Field Separators. (line 50) +* field separators: Field Separators. (line 15) +* field separators, choice of: Field Separators. (line 51) * field separators, FIELDWIDTHS variable and: User-modified. (line 35) * field separators, FPAT variable and: User-modified. (line 45) * field separators, in multiline records: Multiple Line. (line 41) @@ -30694,7 +30714,7 @@ Index * field separators, POSIX and: Fields. (line 6) * field separators, regular expressions as <1>: Regexp Field Splitting. (line 6) -* field separators, regular expressions as: Field Separators. (line 50) +* field separators, regular expressions as: Field Separators. (line 51) * field separators, See Also OFS: Changing Fields. (line 64) * field separators, spaces as: Cut Program. (line 109) * fields <1>: Basic High Level. (line 73) @@ -30707,7 +30727,7 @@ Index * fields, number of: Fields. (line 33) * fields, numbers: Nonconstant Fields. (line 6) * fields, printing: Print Examples. (line 21) -* fields, separating: Field Separators. (line 14) +* fields, separating: Field Separators. (line 15) * fields, single-character: Single Character Fields. (line 6) * FIELDWIDTHS variable <1>: User-modified. (line 35) @@ -30817,12 +30837,12 @@ Index * Free Software Foundation (FSF): Manual History. (line 6) * FreeBSD: Glossary. (line 624) * FS variable <1>: User-modified. (line 56) -* FS variable: Field Separators. (line 14) +* FS variable: Field Separators. (line 15) * FS variable, --field-separator option and: Options. (line 21) * FS variable, as null string: Single Character Fields. (line 20) * FS variable, as TAB character: Options. (line 259) -* FS variable, changing value of: Field Separators. (line 34) +* FS variable, changing value of: Field Separators. (line 35) * FS variable, running awk programs and: Cut Program. (line 68) * FS variable, setting from command line: Command Line Field Separator. (line 6) @@ -31759,7 +31779,7 @@ Index * regexp constants, vs. string constants: Computed Regexps. (line 38) * regexp, See regular expressions: Regexp. (line 6) * regular expressions: Regexp. (line 6) -* regular expressions as field separators: Field Separators. (line 50) +* regular expressions as field separators: Field Separators. (line 51) * regular expressions, anchors in: Regexp Operators. (line 22) * regular expressions, as field separators: Regexp Field Splitting. (line 6) @@ -32129,7 +32149,7 @@ Index * troubleshooting, --non-decimal-data option: Options. (line 207) * troubleshooting, == operator: Comparison Operators. (line 37) -* troubleshooting, awk uses FS not IFS: Field Separators. (line 29) +* troubleshooting, awk uses FS not IFS: Field Separators. (line 30) * troubleshooting, backslash before nonspecial character: Escape Sequences. (line 112) * troubleshooting, division: Arithmetic Ops. (line 44) @@ -32323,523 +32343,525 @@ Index Tag Table: -Node: Top1360 -Node: Foreword40645 -Node: Preface44990 -Ref: Preface-Footnote-148043 -Ref: Preface-Footnote-248139 -Node: History48371 -Node: Names50745 -Ref: Names-Footnote-152222 -Node: This Manual52294 -Ref: This Manual-Footnote-158068 -Node: Conventions58168 -Node: Manual History60324 -Ref: Manual History-Footnote-163772 -Ref: Manual History-Footnote-263813 -Node: How To Contribute63887 -Node: Acknowledgments65031 -Node: Getting Started69240 -Node: Running gawk71619 -Node: One-shot72805 -Node: Read Terminal74030 -Ref: Read Terminal-Footnote-175680 -Ref: Read Terminal-Footnote-275956 -Node: Long76127 -Node: Executable Scripts77503 -Ref: Executable Scripts-Footnote-179336 -Ref: Executable Scripts-Footnote-279438 -Node: Comments79985 -Node: Quoting82452 -Node: DOS Quoting87075 -Node: Sample Data Files87750 -Node: Very Simple90794 -Node: Two Rules95393 -Node: More Complex97540 -Ref: More Complex-Footnote-1100470 -Node: Statements/Lines100555 -Ref: Statements/Lines-Footnote-1105017 -Node: Other Features105282 -Node: When106210 -Node: Invoking Gawk108357 -Node: Command Line109818 -Node: Options110601 -Ref: Options-Footnote-1125993 -Node: Other Arguments126018 -Node: Naming Standard Input128676 -Node: Environment Variables129770 -Node: AWKPATH Variable130328 -Ref: AWKPATH Variable-Footnote-1133086 -Node: AWKLIBPATH Variable133346 -Node: Other Environment Variables134064 -Node: Exit Status137027 -Node: Include Files137702 -Node: Loading Shared Libraries141271 -Node: Obsolete142635 -Node: Undocumented143332 -Node: Regexp143574 -Node: Regexp Usage144963 -Node: Escape Sequences146989 -Node: Regexp Operators152658 -Ref: Regexp Operators-Footnote-1160038 -Ref: Regexp Operators-Footnote-2160185 -Node: Bracket Expressions160283 -Ref: table-char-classes162173 -Node: GNU Regexp Operators164696 -Node: Case-sensitivity168419 -Ref: Case-sensitivity-Footnote-1171387 -Ref: Case-sensitivity-Footnote-2171622 -Node: Leftmost Longest171730 -Node: Computed Regexps172931 -Node: Reading Files176268 -Node: Records178270 -Ref: Records-Footnote-1187159 -Node: Fields187196 -Ref: Fields-Footnote-1190229 -Node: Nonconstant Fields190315 -Node: Changing Fields192517 -Node: Field Separators198476 -Node: Default Field Splitting201105 -Node: Regexp Field Splitting202222 -Node: Single Character Fields205564 -Node: Command Line Field Separator206623 -Node: Field Splitting Summary210064 -Ref: Field Splitting Summary-Footnote-1213175 -Node: Constant Size213276 -Node: Splitting By Content217860 -Ref: Splitting By Content-Footnote-1221586 -Node: Multiple Line221626 -Ref: Multiple Line-Footnote-1227473 -Node: Getline227652 -Node: Plain Getline229868 -Node: Getline/Variable231963 -Node: Getline/File233110 -Node: Getline/Variable/File234451 -Ref: Getline/Variable/File-Footnote-1236050 -Node: Getline/Pipe236137 -Node: Getline/Variable/Pipe238836 -Node: Getline/Coprocess239943 -Node: Getline/Variable/Coprocess241195 -Node: Getline Notes241932 -Node: Getline Summary244719 -Ref: table-getline-variants245127 -Node: Read Timeout246039 -Ref: Read Timeout-Footnote-1249780 -Node: Command line directories249837 -Node: Printing250467 -Node: Print252098 -Node: Print Examples253435 -Node: Output Separators256219 -Node: OFMT257979 -Node: Printf259337 -Node: Basic Printf260243 -Node: Control Letters261782 -Node: Format Modifiers265594 -Node: Printf Examples271603 -Node: Redirection274318 -Node: Special Files281283 -Node: Special FD281816 -Ref: Special FD-Footnote-1285441 -Node: Special Network285515 -Node: Special Caveats286365 -Node: Close Files And Pipes287161 -Ref: Close Files And Pipes-Footnote-1294144 -Ref: Close Files And Pipes-Footnote-2294292 -Node: Expressions294442 -Node: Values295574 -Node: Constants296250 -Node: Scalar Constants296930 -Ref: Scalar Constants-Footnote-1297789 -Node: Nondecimal-numbers297971 -Node: Regexp Constants300971 -Node: Using Constant Regexps301446 -Node: Variables304501 -Node: Using Variables305156 -Node: Assignment Options306880 -Node: Conversion308752 -Ref: table-locale-affects314253 -Ref: Conversion-Footnote-1314877 -Node: All Operators314986 -Node: Arithmetic Ops315616 -Node: Concatenation318121 -Ref: Concatenation-Footnote-1320913 -Node: Assignment Ops321033 -Ref: table-assign-ops326021 -Node: Increment Ops327352 -Node: Truth Values and Conditions330786 -Node: Truth Values331869 -Node: Typing and Comparison332918 -Node: Variable Typing333711 -Ref: Variable Typing-Footnote-1337608 -Node: Comparison Operators337730 -Ref: table-relational-ops338140 -Node: POSIX String Comparison341689 -Ref: POSIX String Comparison-Footnote-1342645 -Node: Boolean Ops342783 -Ref: Boolean Ops-Footnote-1346861 -Node: Conditional Exp346952 -Node: Function Calls348684 -Node: Precedence352278 -Node: Locales355947 -Node: Patterns and Actions357036 -Node: Pattern Overview358090 -Node: Regexp Patterns359759 -Node: Expression Patterns360302 -Node: Ranges363987 -Node: BEGIN/END366953 -Node: Using BEGIN/END367715 -Ref: Using BEGIN/END-Footnote-1370446 -Node: I/O And BEGIN/END370552 -Node: BEGINFILE/ENDFILE372834 -Node: Empty375748 -Node: Using Shell Variables376064 -Node: Action Overview378349 -Node: Statements380706 -Node: If Statement382560 -Node: While Statement384059 -Node: Do Statement386103 -Node: For Statement387259 -Node: Switch Statement390411 -Node: Break Statement392508 -Node: Continue Statement394498 -Node: Next Statement396291 -Node: Nextfile Statement398681 -Node: Exit Statement401324 -Node: Built-in Variables403740 -Node: User-modified404835 -Ref: User-modified-Footnote-1413193 -Node: Auto-set413255 -Ref: Auto-set-Footnote-1426333 -Ref: Auto-set-Footnote-2426538 -Node: ARGC and ARGV426594 -Node: Arrays430445 -Node: Array Basics431950 -Node: Array Intro432776 -Node: Reference to Elements437093 -Node: Assigning Elements439363 -Node: Array Example439854 -Node: Scanning an Array441586 -Node: Controlling Scanning443900 -Ref: Controlling Scanning-Footnote-1448987 -Node: Delete449303 -Ref: Delete-Footnote-1452068 -Node: Numeric Array Subscripts452125 -Node: Uninitialized Subscripts454308 -Node: Multidimensional455935 -Node: Multiscanning459028 -Node: Arrays of Arrays460617 -Node: Functions465257 -Node: Built-in466076 -Node: Calling Built-in467154 -Node: Numeric Functions469142 -Ref: Numeric Functions-Footnote-1472974 -Ref: Numeric Functions-Footnote-2473331 -Ref: Numeric Functions-Footnote-3473379 -Node: String Functions473648 -Ref: String Functions-Footnote-1496568 -Ref: String Functions-Footnote-2496697 -Ref: String Functions-Footnote-3496945 -Node: Gory Details497032 -Ref: table-sub-escapes498711 -Ref: table-sub-posix-92500065 -Ref: table-sub-proposed501416 -Ref: table-posix-sub502770 -Ref: table-gensub-escapes504315 -Ref: Gory Details-Footnote-1505491 -Ref: Gory Details-Footnote-2505542 -Node: I/O Functions505693 -Ref: I/O Functions-Footnote-1512678 -Node: Time Functions512825 -Ref: Time Functions-Footnote-1523758 -Ref: Time Functions-Footnote-2523826 -Ref: Time Functions-Footnote-3523984 -Ref: Time Functions-Footnote-4524095 -Ref: Time Functions-Footnote-5524207 -Ref: Time Functions-Footnote-6524434 -Node: Bitwise Functions524700 -Ref: table-bitwise-ops525262 -Ref: Bitwise Functions-Footnote-1529483 -Node: Type Functions529667 -Node: I18N Functions530818 -Node: User-defined532445 -Node: Definition Syntax533249 -Ref: Definition Syntax-Footnote-1538159 -Node: Function Example538228 -Node: Function Caveats540822 -Node: Calling A Function541243 -Node: Variable Scope542358 -Node: Pass By Value/Reference545321 -Node: Return Statement548829 -Node: Dynamic Typing551810 -Node: Indirect Calls552741 -Node: Library Functions562426 -Ref: Library Functions-Footnote-1565939 -Ref: Library Functions-Footnote-2566082 -Node: Library Names566253 -Ref: Library Names-Footnote-1569724 -Ref: Library Names-Footnote-2569944 -Node: General Functions570030 -Node: Strtonum Function571058 -Node: Assert Function573988 -Node: Round Function577314 -Node: Cliff Random Function578857 -Node: Ordinal Functions579873 -Ref: Ordinal Functions-Footnote-1582943 -Ref: Ordinal Functions-Footnote-2583195 -Node: Join Function583404 -Ref: Join Function-Footnote-1585175 -Node: Getlocaltime Function585375 -Node: Readfile Function589116 -Node: Data File Management590955 -Node: Filetrans Function591587 -Node: Rewind Function595656 -Node: File Checking597043 -Node: Empty Files598137 -Node: Ignoring Assigns600367 -Node: Getopt Function601920 -Ref: Getopt Function-Footnote-1613223 -Node: Passwd Functions613426 -Ref: Passwd Functions-Footnote-1622401 -Node: Group Functions622489 -Node: Walking Arrays630573 -Node: Sample Programs632710 -Node: Running Examples633384 -Node: Clones634112 -Node: Cut Program635336 -Node: Egrep Program645181 -Ref: Egrep Program-Footnote-1652954 -Node: Id Program653064 -Node: Split Program656680 -Ref: Split Program-Footnote-1660199 -Node: Tee Program660327 -Node: Uniq Program663130 -Node: Wc Program670559 -Ref: Wc Program-Footnote-1674825 -Ref: Wc Program-Footnote-2675025 -Node: Miscellaneous Programs675117 -Node: Dupword Program676305 -Node: Alarm Program678336 -Node: Translate Program683089 -Ref: Translate Program-Footnote-1687476 -Ref: Translate Program-Footnote-2687724 -Node: Labels Program687858 -Ref: Labels Program-Footnote-1691229 -Node: Word Sorting691313 -Node: History Sorting695197 -Node: Extract Program697036 -Ref: Extract Program-Footnote-1704539 -Node: Simple Sed704667 -Node: Igawk Program707729 -Ref: Igawk Program-Footnote-1722886 -Ref: Igawk Program-Footnote-2723087 -Node: Anagram Program723225 -Node: Signature Program726293 -Node: Advanced Features727393 -Node: Nondecimal Data729279 -Node: Array Sorting730862 -Node: Controlling Array Traversal731559 -Node: Array Sorting Functions739843 -Ref: Array Sorting Functions-Footnote-1743712 -Node: Two-way I/O743906 -Ref: Two-way I/O-Footnote-1749338 -Node: TCP/IP Networking749408 -Node: Profiling752252 -Node: Internationalization759749 -Node: I18N and L10N761174 -Node: Explaining gettext761860 -Ref: Explaining gettext-Footnote-1766928 -Ref: Explaining gettext-Footnote-2767112 -Node: Programmer i18n767277 -Node: Translator i18n771479 -Node: String Extraction772272 -Ref: String Extraction-Footnote-1773233 -Node: Printf Ordering773319 -Ref: Printf Ordering-Footnote-1776103 -Node: I18N Portability776167 -Ref: I18N Portability-Footnote-1778616 -Node: I18N Example778679 -Ref: I18N Example-Footnote-1781317 -Node: Gawk I18N781389 -Node: Debugger782010 -Node: Debugging782981 -Node: Debugging Concepts783414 -Node: Debugging Terms785270 -Node: Awk Debugging787867 -Node: Sample Debugging Session788759 -Node: Debugger Invocation789279 -Node: Finding The Bug790611 -Node: List of Debugger Commands797099 -Node: Breakpoint Control798433 -Node: Debugger Execution Control802097 -Node: Viewing And Changing Data805457 -Node: Execution Stack808813 -Node: Debugger Info810280 -Node: Miscellaneous Debugger Commands814262 -Node: Readline Support819438 -Node: Limitations820269 -Node: Arbitrary Precision Arithmetic822521 -Ref: Arbitrary Precision Arithmetic-Footnote-1824170 -Node: General Arithmetic824318 -Node: Floating Point Issues826038 -Node: String Conversion Precision826919 -Ref: String Conversion Precision-Footnote-1828624 -Node: Unexpected Results828733 -Node: POSIX Floating Point Problems830886 -Ref: POSIX Floating Point Problems-Footnote-1834711 -Node: Integer Programming834749 -Node: Floating-point Programming836488 -Ref: Floating-point Programming-Footnote-1842819 -Ref: Floating-point Programming-Footnote-2843089 -Node: Floating-point Representation843353 -Node: Floating-point Context844518 -Ref: table-ieee-formats845357 -Node: Rounding Mode846741 -Ref: table-rounding-modes847220 -Ref: Rounding Mode-Footnote-1850235 -Node: Gawk and MPFR850414 -Node: Arbitrary Precision Floats851669 -Ref: Arbitrary Precision Floats-Footnote-1854112 -Node: Setting Precision854428 -Ref: table-predefined-precision-strings855114 -Node: Setting Rounding Mode857259 -Ref: table-gawk-rounding-modes857663 -Node: Floating-point Constants858850 -Node: Changing Precision860279 -Ref: Changing Precision-Footnote-1861676 -Node: Exact Arithmetic861850 -Node: Arbitrary Precision Integers864988 -Ref: Arbitrary Precision Integers-Footnote-1868006 -Node: Dynamic Extensions868153 -Node: Extension Intro869611 -Node: Plugin License870876 -Node: Extension Mechanism Outline871561 -Ref: load-extension871978 -Ref: load-new-function873456 -Ref: call-new-function874451 -Node: Extension API Description876466 -Node: Extension API Functions Introduction877679 -Node: General Data Types882545 -Ref: General Data Types-Footnote-1888150 -Node: Requesting Values888449 -Ref: table-value-types-returned889180 -Node: Constructor Functions890134 -Node: Registration Functions893154 -Node: Extension Functions893839 -Node: Exit Callback Functions896064 -Node: Extension Version String897313 -Node: Input Parsers897963 -Node: Output Wrappers907720 -Node: Two-way processors912230 -Node: Printing Messages914438 -Ref: Printing Messages-Footnote-1915515 -Node: Updating `ERRNO'915667 -Node: Accessing Parameters916406 -Node: Symbol Table Access917636 -Node: Symbol table by name918148 -Node: Symbol table by cookie919895 -Ref: Symbol table by cookie-Footnote-1924025 -Node: Cached values924088 -Ref: Cached values-Footnote-1927537 -Node: Array Manipulation927628 -Ref: Array Manipulation-Footnote-1928726 -Node: Array Data Types928765 -Ref: Array Data Types-Footnote-1931468 -Node: Array Functions931560 -Node: Flattening Arrays935326 -Node: Creating Arrays942178 -Node: Extension API Variables946903 -Node: Extension Versioning947539 -Node: Extension API Informational Variables949440 -Node: Extension API Boilerplate950526 -Node: Finding Extensions954330 -Node: Extension Example954890 -Node: Internal File Description955620 -Node: Internal File Ops959711 -Ref: Internal File Ops-Footnote-1971219 -Node: Using Internal File Ops971359 -Ref: Using Internal File Ops-Footnote-1973712 -Node: Extension Samples973978 -Node: Extension Sample File Functions975502 -Node: Extension Sample Fnmatch983987 -Node: Extension Sample Fork985713 -Node: Extension Sample Inplace986931 -Node: Extension Sample Ord988709 -Node: Extension Sample Readdir989545 -Node: Extension Sample Revout991077 -Node: Extension Sample Rev2way991670 -Node: Extension Sample Read write array992360 -Node: Extension Sample Readfile994243 -Node: Extension Sample API Tests995061 -Node: Extension Sample Time995586 -Node: gawkextlib996950 -Node: Language History999731 -Node: V7/SVR3.11001253 -Node: SVR41003573 -Node: POSIX1005015 -Node: BTL1006401 -Node: POSIX/GNU1007135 -Node: Common Extensions1012736 -Node: Ranges and Locales1014042 -Ref: Ranges and Locales-Footnote-11018660 -Ref: Ranges and Locales-Footnote-21018687 -Ref: Ranges and Locales-Footnote-31018947 -Node: Contributors1019168 -Node: Installation1024243 -Node: Gawk Distribution1025137 -Node: Getting1025621 -Node: Extracting1026447 -Node: Distribution contents1028139 -Node: Unix Installation1033844 -Node: Quick Installation1034461 -Node: Additional Configuration Options1036905 -Node: Configuration Philosophy1038641 -Node: Non-Unix Installation1040995 -Node: PC Installation1041453 -Node: PC Binary Installation1042752 -Node: PC Compiling1044600 -Node: PC Testing1047544 -Node: PC Using1048720 -Node: Cygwin1052905 -Node: MSYS1053905 -Node: VMS Installation1054419 -Node: VMS Compilation1055183 -Ref: VMS Compilation-Footnote-11056798 -Node: VMS Dynamic Extensions1056856 -Node: VMS Installation Details1058229 -Node: VMS Running1060063 -Node: VMS GNV1062897 -Node: VMS Old Gawk1063606 -Node: Bugs1064076 -Node: Other Versions1067996 -Node: Notes1074080 -Node: Compatibility Mode1074880 -Node: Additions1075663 -Node: Accessing The Source1076590 -Node: Adding Code1078030 -Node: New Ports1084075 -Node: Derived Files1088210 -Ref: Derived Files-Footnote-11093531 -Ref: Derived Files-Footnote-21093565 -Ref: Derived Files-Footnote-31094165 -Node: Future Extensions1094263 -Node: Implementation Limitations1094846 -Node: Extension Design1096098 -Node: Old Extension Problems1097252 -Ref: Old Extension Problems-Footnote-11098760 -Node: Extension New Mechanism Goals1098817 -Ref: Extension New Mechanism Goals-Footnote-11102182 -Node: Extension Other Design Decisions1102368 -Node: Extension Future Growth1104474 -Node: Old Extension Mechanism1105310 -Node: Basic Concepts1107050 -Node: Basic High Level1107731 -Ref: figure-general-flow1108002 -Ref: figure-process-flow1108601 -Ref: Basic High Level-Footnote-11111830 -Node: Basic Data Typing1112015 -Node: Glossary1115370 -Node: Copying1140832 -Node: GNU Free Documentation License1178389 -Node: Index1203526 +Node: Top1366 +Node: Foreword40737 +Node: Preface45082 +Ref: Preface-Footnote-148135 +Ref: Preface-Footnote-248231 +Node: History48463 +Node: Names50837 +Ref: Names-Footnote-152314 +Node: This Manual52386 +Ref: This Manual-Footnote-158160 +Node: Conventions58260 +Node: Manual History60416 +Ref: Manual History-Footnote-163864 +Ref: Manual History-Footnote-263905 +Node: How To Contribute63979 +Node: Acknowledgments65123 +Node: Getting Started69332 +Node: Running gawk71711 +Node: One-shot72897 +Node: Read Terminal74122 +Ref: Read Terminal-Footnote-175772 +Ref: Read Terminal-Footnote-276048 +Node: Long76219 +Node: Executable Scripts77595 +Ref: Executable Scripts-Footnote-179428 +Ref: Executable Scripts-Footnote-279530 +Node: Comments80077 +Node: Quoting82544 +Node: DOS Quoting87167 +Node: Sample Data Files87842 +Node: Very Simple90886 +Node: Two Rules95485 +Node: More Complex97632 +Ref: More Complex-Footnote-1100562 +Node: Statements/Lines100647 +Ref: Statements/Lines-Footnote-1105109 +Node: Other Features105374 +Node: When106302 +Node: Invoking Gawk108449 +Node: Command Line109910 +Node: Options110693 +Ref: Options-Footnote-1126085 +Node: Other Arguments126110 +Node: Naming Standard Input128768 +Node: Environment Variables129862 +Node: AWKPATH Variable130420 +Ref: AWKPATH Variable-Footnote-1133178 +Node: AWKLIBPATH Variable133438 +Node: Other Environment Variables134156 +Node: Exit Status137119 +Node: Include Files137794 +Node: Loading Shared Libraries141363 +Node: Obsolete142727 +Node: Undocumented143424 +Node: Regexp143666 +Node: Regexp Usage145055 +Node: Escape Sequences147081 +Node: Regexp Operators152750 +Ref: Regexp Operators-Footnote-1160130 +Ref: Regexp Operators-Footnote-2160277 +Node: Bracket Expressions160375 +Ref: table-char-classes162265 +Node: GNU Regexp Operators164788 +Node: Case-sensitivity168511 +Ref: Case-sensitivity-Footnote-1171479 +Ref: Case-sensitivity-Footnote-2171714 +Node: Leftmost Longest171822 +Node: Computed Regexps173023 +Node: Reading Files176360 +Node: Records178362 +Ref: Records-Footnote-1187251 +Node: Fields187288 +Ref: Fields-Footnote-1190321 +Node: Nonconstant Fields190407 +Node: Changing Fields192609 +Node: Field Separators198568 +Node: Default Field Splitting201270 +Node: Regexp Field Splitting202387 +Node: Single Character Fields205729 +Node: Command Line Field Separator206788 +Node: Full Line Fields210222 +Ref: Full Line Fields-Footnote-1210730 +Node: Field Splitting Summary210776 +Ref: Field Splitting Summary-Footnote-1213875 +Node: Constant Size213976 +Node: Splitting By Content218560 +Ref: Splitting By Content-Footnote-1222286 +Node: Multiple Line222326 +Ref: Multiple Line-Footnote-1228173 +Node: Getline228352 +Node: Plain Getline230568 +Node: Getline/Variable232663 +Node: Getline/File233810 +Node: Getline/Variable/File235151 +Ref: Getline/Variable/File-Footnote-1236750 +Node: Getline/Pipe236837 +Node: Getline/Variable/Pipe239536 +Node: Getline/Coprocess240643 +Node: Getline/Variable/Coprocess241895 +Node: Getline Notes242632 +Node: Getline Summary245419 +Ref: table-getline-variants245827 +Node: Read Timeout246739 +Ref: Read Timeout-Footnote-1250480 +Node: Command line directories250537 +Node: Printing251167 +Node: Print252798 +Node: Print Examples254135 +Node: Output Separators256919 +Node: OFMT258679 +Node: Printf260037 +Node: Basic Printf260943 +Node: Control Letters262482 +Node: Format Modifiers266294 +Node: Printf Examples272303 +Node: Redirection275018 +Node: Special Files281983 +Node: Special FD282516 +Ref: Special FD-Footnote-1286141 +Node: Special Network286215 +Node: Special Caveats287065 +Node: Close Files And Pipes287861 +Ref: Close Files And Pipes-Footnote-1294844 +Ref: Close Files And Pipes-Footnote-2294992 +Node: Expressions295142 +Node: Values296274 +Node: Constants296950 +Node: Scalar Constants297630 +Ref: Scalar Constants-Footnote-1298489 +Node: Nondecimal-numbers298671 +Node: Regexp Constants301671 +Node: Using Constant Regexps302146 +Node: Variables305201 +Node: Using Variables305856 +Node: Assignment Options307580 +Node: Conversion309452 +Ref: table-locale-affects314953 +Ref: Conversion-Footnote-1315577 +Node: All Operators315686 +Node: Arithmetic Ops316316 +Node: Concatenation318821 +Ref: Concatenation-Footnote-1321613 +Node: Assignment Ops321733 +Ref: table-assign-ops326721 +Node: Increment Ops328052 +Node: Truth Values and Conditions331486 +Node: Truth Values332569 +Node: Typing and Comparison333618 +Node: Variable Typing334411 +Ref: Variable Typing-Footnote-1338308 +Node: Comparison Operators338430 +Ref: table-relational-ops338840 +Node: POSIX String Comparison342389 +Ref: POSIX String Comparison-Footnote-1343345 +Node: Boolean Ops343483 +Ref: Boolean Ops-Footnote-1347561 +Node: Conditional Exp347652 +Node: Function Calls349384 +Node: Precedence352978 +Node: Locales356647 +Node: Patterns and Actions357736 +Node: Pattern Overview358790 +Node: Regexp Patterns360459 +Node: Expression Patterns361002 +Node: Ranges364687 +Node: BEGIN/END367653 +Node: Using BEGIN/END368415 +Ref: Using BEGIN/END-Footnote-1371146 +Node: I/O And BEGIN/END371252 +Node: BEGINFILE/ENDFILE373534 +Node: Empty376448 +Node: Using Shell Variables376764 +Node: Action Overview379049 +Node: Statements381406 +Node: If Statement383260 +Node: While Statement384759 +Node: Do Statement386803 +Node: For Statement387959 +Node: Switch Statement391111 +Node: Break Statement393208 +Node: Continue Statement395198 +Node: Next Statement396991 +Node: Nextfile Statement399381 +Node: Exit Statement402024 +Node: Built-in Variables404440 +Node: User-modified405535 +Ref: User-modified-Footnote-1413893 +Node: Auto-set413955 +Ref: Auto-set-Footnote-1427033 +Ref: Auto-set-Footnote-2427238 +Node: ARGC and ARGV427294 +Node: Arrays431145 +Node: Array Basics432650 +Node: Array Intro433476 +Node: Reference to Elements437793 +Node: Assigning Elements440063 +Node: Array Example440554 +Node: Scanning an Array442286 +Node: Controlling Scanning444600 +Ref: Controlling Scanning-Footnote-1449687 +Node: Delete450003 +Ref: Delete-Footnote-1452768 +Node: Numeric Array Subscripts452825 +Node: Uninitialized Subscripts455008 +Node: Multidimensional456635 +Node: Multiscanning459728 +Node: Arrays of Arrays461317 +Node: Functions465957 +Node: Built-in466776 +Node: Calling Built-in467854 +Node: Numeric Functions469842 +Ref: Numeric Functions-Footnote-1473674 +Ref: Numeric Functions-Footnote-2474031 +Ref: Numeric Functions-Footnote-3474079 +Node: String Functions474348 +Ref: String Functions-Footnote-1497268 +Ref: String Functions-Footnote-2497397 +Ref: String Functions-Footnote-3497645 +Node: Gory Details497732 +Ref: table-sub-escapes499411 +Ref: table-sub-posix-92500765 +Ref: table-sub-proposed502116 +Ref: table-posix-sub503470 +Ref: table-gensub-escapes505015 +Ref: Gory Details-Footnote-1506191 +Ref: Gory Details-Footnote-2506242 +Node: I/O Functions506393 +Ref: I/O Functions-Footnote-1513378 +Node: Time Functions513525 +Ref: Time Functions-Footnote-1524458 +Ref: Time Functions-Footnote-2524526 +Ref: Time Functions-Footnote-3524684 +Ref: Time Functions-Footnote-4524795 +Ref: Time Functions-Footnote-5524907 +Ref: Time Functions-Footnote-6525134 +Node: Bitwise Functions525400 +Ref: table-bitwise-ops525962 +Ref: Bitwise Functions-Footnote-1530183 +Node: Type Functions530367 +Node: I18N Functions531518 +Node: User-defined533145 +Node: Definition Syntax533949 +Ref: Definition Syntax-Footnote-1538859 +Node: Function Example538928 +Node: Function Caveats541522 +Node: Calling A Function541943 +Node: Variable Scope543058 +Node: Pass By Value/Reference546021 +Node: Return Statement549529 +Node: Dynamic Typing552510 +Node: Indirect Calls553441 +Node: Library Functions563126 +Ref: Library Functions-Footnote-1566639 +Ref: Library Functions-Footnote-2566782 +Node: Library Names566953 +Ref: Library Names-Footnote-1570424 +Ref: Library Names-Footnote-2570644 +Node: General Functions570730 +Node: Strtonum Function571758 +Node: Assert Function574688 +Node: Round Function578014 +Node: Cliff Random Function579557 +Node: Ordinal Functions580573 +Ref: Ordinal Functions-Footnote-1583643 +Ref: Ordinal Functions-Footnote-2583895 +Node: Join Function584104 +Ref: Join Function-Footnote-1585875 +Node: Getlocaltime Function586075 +Node: Readfile Function589816 +Node: Data File Management591655 +Node: Filetrans Function592287 +Node: Rewind Function596356 +Node: File Checking597743 +Node: Empty Files598837 +Node: Ignoring Assigns601067 +Node: Getopt Function602620 +Ref: Getopt Function-Footnote-1613923 +Node: Passwd Functions614126 +Ref: Passwd Functions-Footnote-1623101 +Node: Group Functions623189 +Node: Walking Arrays631273 +Node: Sample Programs633410 +Node: Running Examples634084 +Node: Clones634812 +Node: Cut Program636036 +Node: Egrep Program645881 +Ref: Egrep Program-Footnote-1653654 +Node: Id Program653764 +Node: Split Program657380 +Ref: Split Program-Footnote-1660899 +Node: Tee Program661027 +Node: Uniq Program663830 +Node: Wc Program671259 +Ref: Wc Program-Footnote-1675525 +Ref: Wc Program-Footnote-2675725 +Node: Miscellaneous Programs675817 +Node: Dupword Program677005 +Node: Alarm Program679036 +Node: Translate Program683789 +Ref: Translate Program-Footnote-1688176 +Ref: Translate Program-Footnote-2688424 +Node: Labels Program688558 +Ref: Labels Program-Footnote-1691929 +Node: Word Sorting692013 +Node: History Sorting695897 +Node: Extract Program697736 +Ref: Extract Program-Footnote-1705239 +Node: Simple Sed705367 +Node: Igawk Program708429 +Ref: Igawk Program-Footnote-1723586 +Ref: Igawk Program-Footnote-2723787 +Node: Anagram Program723925 +Node: Signature Program726993 +Node: Advanced Features728093 +Node: Nondecimal Data729979 +Node: Array Sorting731562 +Node: Controlling Array Traversal732259 +Node: Array Sorting Functions740543 +Ref: Array Sorting Functions-Footnote-1744412 +Node: Two-way I/O744606 +Ref: Two-way I/O-Footnote-1750038 +Node: TCP/IP Networking750108 +Node: Profiling752952 +Node: Internationalization760449 +Node: I18N and L10N761874 +Node: Explaining gettext762560 +Ref: Explaining gettext-Footnote-1767628 +Ref: Explaining gettext-Footnote-2767812 +Node: Programmer i18n767977 +Node: Translator i18n772179 +Node: String Extraction772972 +Ref: String Extraction-Footnote-1773933 +Node: Printf Ordering774019 +Ref: Printf Ordering-Footnote-1776803 +Node: I18N Portability776867 +Ref: I18N Portability-Footnote-1779316 +Node: I18N Example779379 +Ref: I18N Example-Footnote-1782017 +Node: Gawk I18N782089 +Node: Debugger782710 +Node: Debugging783681 +Node: Debugging Concepts784114 +Node: Debugging Terms785970 +Node: Awk Debugging788567 +Node: Sample Debugging Session789459 +Node: Debugger Invocation789979 +Node: Finding The Bug791311 +Node: List of Debugger Commands797799 +Node: Breakpoint Control799133 +Node: Debugger Execution Control802797 +Node: Viewing And Changing Data806157 +Node: Execution Stack809513 +Node: Debugger Info810980 +Node: Miscellaneous Debugger Commands814962 +Node: Readline Support820138 +Node: Limitations820969 +Node: Arbitrary Precision Arithmetic823221 +Ref: Arbitrary Precision Arithmetic-Footnote-1824870 +Node: General Arithmetic825018 +Node: Floating Point Issues826738 +Node: String Conversion Precision827619 +Ref: String Conversion Precision-Footnote-1829324 +Node: Unexpected Results829433 +Node: POSIX Floating Point Problems831586 +Ref: POSIX Floating Point Problems-Footnote-1835411 +Node: Integer Programming835449 +Node: Floating-point Programming837188 +Ref: Floating-point Programming-Footnote-1843519 +Ref: Floating-point Programming-Footnote-2843789 +Node: Floating-point Representation844053 +Node: Floating-point Context845218 +Ref: table-ieee-formats846057 +Node: Rounding Mode847441 +Ref: table-rounding-modes847920 +Ref: Rounding Mode-Footnote-1850935 +Node: Gawk and MPFR851114 +Node: Arbitrary Precision Floats852369 +Ref: Arbitrary Precision Floats-Footnote-1854812 +Node: Setting Precision855128 +Ref: table-predefined-precision-strings855814 +Node: Setting Rounding Mode857959 +Ref: table-gawk-rounding-modes858363 +Node: Floating-point Constants859550 +Node: Changing Precision860979 +Ref: Changing Precision-Footnote-1862376 +Node: Exact Arithmetic862550 +Node: Arbitrary Precision Integers865688 +Ref: Arbitrary Precision Integers-Footnote-1868706 +Node: Dynamic Extensions868853 +Node: Extension Intro870311 +Node: Plugin License871576 +Node: Extension Mechanism Outline872261 +Ref: load-extension872678 +Ref: load-new-function874156 +Ref: call-new-function875151 +Node: Extension API Description877166 +Node: Extension API Functions Introduction878379 +Node: General Data Types883245 +Ref: General Data Types-Footnote-1888850 +Node: Requesting Values889149 +Ref: table-value-types-returned889880 +Node: Constructor Functions890834 +Node: Registration Functions893854 +Node: Extension Functions894539 +Node: Exit Callback Functions896764 +Node: Extension Version String898013 +Node: Input Parsers898663 +Node: Output Wrappers908420 +Node: Two-way processors912930 +Node: Printing Messages915138 +Ref: Printing Messages-Footnote-1916215 +Node: Updating `ERRNO'916367 +Node: Accessing Parameters917106 +Node: Symbol Table Access918336 +Node: Symbol table by name918848 +Node: Symbol table by cookie920595 +Ref: Symbol table by cookie-Footnote-1924725 +Node: Cached values924788 +Ref: Cached values-Footnote-1928237 +Node: Array Manipulation928328 +Ref: Array Manipulation-Footnote-1929426 +Node: Array Data Types929465 +Ref: Array Data Types-Footnote-1932168 +Node: Array Functions932260 +Node: Flattening Arrays936026 +Node: Creating Arrays942878 +Node: Extension API Variables947603 +Node: Extension Versioning948239 +Node: Extension API Informational Variables950140 +Node: Extension API Boilerplate951226 +Node: Finding Extensions955030 +Node: Extension Example955590 +Node: Internal File Description956320 +Node: Internal File Ops960411 +Ref: Internal File Ops-Footnote-1971919 +Node: Using Internal File Ops972059 +Ref: Using Internal File Ops-Footnote-1974412 +Node: Extension Samples974678 +Node: Extension Sample File Functions976202 +Node: Extension Sample Fnmatch984687 +Node: Extension Sample Fork986413 +Node: Extension Sample Inplace987631 +Node: Extension Sample Ord989409 +Node: Extension Sample Readdir990245 +Node: Extension Sample Revout991777 +Node: Extension Sample Rev2way992370 +Node: Extension Sample Read write array993060 +Node: Extension Sample Readfile994943 +Node: Extension Sample API Tests995761 +Node: Extension Sample Time996286 +Node: gawkextlib997650 +Node: Language History1000431 +Node: V7/SVR3.11001953 +Node: SVR41004273 +Node: POSIX1005715 +Node: BTL1007101 +Node: POSIX/GNU1007835 +Node: Common Extensions1013436 +Node: Ranges and Locales1014742 +Ref: Ranges and Locales-Footnote-11019360 +Ref: Ranges and Locales-Footnote-21019387 +Ref: Ranges and Locales-Footnote-31019647 +Node: Contributors1019868 +Node: Installation1024943 +Node: Gawk Distribution1025837 +Node: Getting1026321 +Node: Extracting1027147 +Node: Distribution contents1028839 +Node: Unix Installation1034544 +Node: Quick Installation1035161 +Node: Additional Configuration Options1037605 +Node: Configuration Philosophy1039341 +Node: Non-Unix Installation1041695 +Node: PC Installation1042153 +Node: PC Binary Installation1043452 +Node: PC Compiling1045300 +Node: PC Testing1048244 +Node: PC Using1049420 +Node: Cygwin1053605 +Node: MSYS1054605 +Node: VMS Installation1055119 +Node: VMS Compilation1055883 +Ref: VMS Compilation-Footnote-11057498 +Node: VMS Dynamic Extensions1057556 +Node: VMS Installation Details1058929 +Node: VMS Running1060763 +Node: VMS GNV1063597 +Node: VMS Old Gawk1064306 +Node: Bugs1064776 +Node: Other Versions1068696 +Node: Notes1074780 +Node: Compatibility Mode1075580 +Node: Additions1076363 +Node: Accessing The Source1077290 +Node: Adding Code1078730 +Node: New Ports1084775 +Node: Derived Files1088910 +Ref: Derived Files-Footnote-11094231 +Ref: Derived Files-Footnote-21094265 +Ref: Derived Files-Footnote-31094865 +Node: Future Extensions1094963 +Node: Implementation Limitations1095546 +Node: Extension Design1096798 +Node: Old Extension Problems1097952 +Ref: Old Extension Problems-Footnote-11099460 +Node: Extension New Mechanism Goals1099517 +Ref: Extension New Mechanism Goals-Footnote-11102882 +Node: Extension Other Design Decisions1103068 +Node: Extension Future Growth1105174 +Node: Old Extension Mechanism1106010 +Node: Basic Concepts1107750 +Node: Basic High Level1108431 +Ref: figure-general-flow1108702 +Ref: figure-process-flow1109301 +Ref: Basic High Level-Footnote-11112530 +Node: Basic Data Typing1112715 +Node: Glossary1116070 +Node: Copying1141532 +Node: GNU Free Documentation License1179089 +Node: Index1204226 End Tag Table |