[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-2567-gc73879
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-2567-gc73879a |
|
Date: |
Sun, 28 May 2017 22:57:50 -0400 (EDT) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, master has been updated
via c73879ace26ad81ee05db907001b7989d0b11af3 (commit)
from 6163a2b1d5bdc76c395f5c7c1d0d8ef445011357 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=c73879ace26ad81ee05db907001b7989d0b11af3
commit c73879ace26ad81ee05db907001b7989d0b11af3
Author: Arnold D. Robbins <address@hidden>
Date: Mon May 29 05:57:29 2017 +0300
Add doc on checking for MPFR at runtime.
diff --git a/awklib/eg/lib/have_mpfr.awk b/awklib/eg/lib/have_mpfr.awk
new file mode 100644
index 0000000..90bd523
--- /dev/null
+++ b/awklib/eg/lib/have_mpfr.awk
@@ -0,0 +1,9 @@
+# adequate_math_precision --- return true if we have enough bits
+#
+# Andrew Schorr, address@hidden, Public Domain
+# May 2017
+
+function adequate_math_precision(n)
+{
+ return (1 != (1+(1/(2^(n-1)))))
+}
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 764d093..e610a6e 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2017-05-29 Arnold D. Robbins <address@hidden>
+
+ * gawktexi.in (Checking for MPFR): New node on checking if
+ gawk was invoked with -M.
+
2017-05-22 Arnold D. Robbins <address@hidden>
* gawktexi.in: Document FIELDWIDTHS much better, including how
diff --git a/doc/gawk.info b/doc/gawk.info
index 14d34a9..2ed1c73 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -536,6 +536,7 @@ in (a) below. A copy of the license is included in the
section entitled
* Setting the rounding mode:: How to set the rounding mode.
* Arbitrary Precision Integers:: Arbitrary Precision Integer Arithmetic
with 'gawk'.
+* Checking for MPFR:: How to check if MPFR is available.
* POSIX Floating Point Problems:: Standards Versus Existing Practice.
* Floating point summary:: Summary of floating point discussion.
* Extension Intro:: What is an extension.
@@ -22486,6 +22487,7 @@ are not quite in agreement.
* FP Math Caution:: Things to know.
* Arbitrary Precision Integers:: Arbitrary Precision Integer Arithmetic with
'gawk'.
+* Checking for MPFR:: How to check if MPFR is available.
* POSIX Floating Point Problems:: Standards Versus Existing Practice.
* Floating point summary:: Summary of floating point discussion.
@@ -23125,7 +23127,7 @@ library in your system does not use the IEEE 754
even-rounding rule to
round halfway cases for 'printf'.
-File: gawk.info, Node: Arbitrary Precision Integers, Next: POSIX Floating
Point Problems, Prev: FP Math Caution, Up: Arbitrary Precision Arithmetic
+File: gawk.info, Node: Arbitrary Precision Integers, Next: Checking for
MPFR, Prev: FP Math Caution, Up: Arbitrary Precision Arithmetic
15.5 Arbitrary-Precision Integer Arithmetic with 'gawk'
=======================================================
@@ -23255,9 +23257,46 @@ Wolfram Web Resource
(<http://mathworld.wolfram.com/SylvestersSequence.html>).
-File: gawk.info, Node: POSIX Floating Point Problems, Next: Floating point
summary, Prev: Arbitrary Precision Integers, Up: Arbitrary Precision
Arithmetic
+File: gawk.info, Node: Checking for MPFR, Next: POSIX Floating Point
Problems, Prev: Arbitrary Precision Integers, Up: Arbitrary Precision
Arithmetic
-15.6 Standards Versus Existing Practice
+15.6 How To Check If MPFR Is Available
+======================================
+
+Occasionally, you might like to be able to check if 'gawk' was invoked
+with the '-M' option, enabling aribtrary-precision arithmetic. You can
+do so with the following function, contributed by Andrew Schorr:
+
+ # adequate_math_precision --- return true if we have enough bits
+
+ function adequate_math_precision(n)
+ {
+ return (1 != (1+(1/(2^(n-1)))))
+ }
+
+ Here is code that invokes the function in order to check if
+arbitrary-precision arithmetic is available:
+
+ BEGIN {
+ # How many bits of mantissa precision are required
+ # for this program to function properly?
+ fpbits = 123
+
+ # We hope that we were invoked with MPFR enabled. If so, the
+ # following statement should configure calculations to our desired
+ # precision.
+ PREC = fpbits
+
+ if (! adequate_math_precision(fpbits)) {
+ print("Error: insufficient computation precision available.\n" \
+ "Try again with the -M argument?") > "/dev/stderr"
+ exit 1
+ }
+ }
+
+
+File: gawk.info, Node: POSIX Floating Point Problems, Next: Floating point
summary, Prev: Checking for MPFR, Up: Arbitrary Precision Arithmetic
+
+15.7 Standards Versus Existing Practice
=======================================
Historically, 'awk' has converted any nonnumeric-looking string to the
@@ -23344,7 +23383,7 @@ and infinity values. The solution implemented in
'gawk' is as follows:
File: gawk.info, Node: Floating point summary, Prev: POSIX Floating Point
Problems, Up: Arbitrary Precision Arithmetic
-15.7 Summary
+15.8 Summary
============
* Most computer arithmetic is done using either integers or
@@ -33282,6 +33321,7 @@ Index
* Chassell, Robert J.: Acknowledgments. (line 33)
* chdir() extension function: Extension Sample File Functions.
(line 12)
+* checking for MPFR: Checking for MPFR. (line 6)
* chem utility: Glossary. (line 206)
* chr() extension function: Extension Sample Ord.
(line 15)
@@ -34610,6 +34650,7 @@ Index
* modifiers, in format specifiers: Format Modifiers. (line 6)
* monetary information, localization: Explaining gettext. (line 104)
* Moore, Duncan: Getline Notes. (line 40)
+* MPFR, checking availability of: Checking for MPFR. (line 6)
* msgfmt utility: I18N Example. (line 66)
* multiple precision: Arbitrary Precision Arithmetic.
(line 6)
@@ -35680,579 +35721,580 @@ Index
Tag Table:
Node: Top1200
-Node: Foreword343204
-Node: Foreword447646
-Node: Preface49178
-Ref: Preface-Footnote-152037
-Ref: Preface-Footnote-252144
-Ref: Preface-Footnote-352378
-Node: History52520
-Node: Names54872
-Ref: Names-Footnote-155966
-Node: This Manual56113
-Ref: This Manual-Footnote-162598
-Node: Conventions62698
-Node: Manual History65052
-Ref: Manual History-Footnote-168047
-Ref: Manual History-Footnote-268088
-Node: How To Contribute68162
-Node: Acknowledgments68813
-Node: Getting Started73699
-Node: Running gawk76138
-Node: One-shot77328
-Node: Read Terminal78591
-Node: Long80584
-Node: Executable Scripts82097
-Ref: Executable Scripts-Footnote-184892
-Node: Comments84995
-Node: Quoting87479
-Node: DOS Quoting92996
-Node: Sample Data Files95051
-Node: Very Simple97646
-Node: Two Rules102548
-Node: More Complex104433
-Node: Statements/Lines107299
-Ref: Statements/Lines-Footnote-1111758
-Node: Other Features112023
-Node: When112959
-Ref: When-Footnote-1114713
-Node: Intro Summary114778
-Node: Invoking Gawk115662
-Node: Command Line117176
-Node: Options117974
-Ref: Options-Footnote-1134593
-Ref: Options-Footnote-2134823
-Node: Other Arguments134848
-Node: Naming Standard Input137795
-Node: Environment Variables138888
-Node: AWKPATH Variable139446
-Ref: AWKPATH Variable-Footnote-1142857
-Ref: AWKPATH Variable-Footnote-2142891
-Node: AWKLIBPATH Variable143152
-Node: Other Environment Variables144409
-Node: Exit Status148230
-Node: Include Files148907
-Node: Loading Shared Libraries152502
-Node: Obsolete153930
-Node: Undocumented154622
-Node: Invoking Summary154919
-Node: Regexp156579
-Node: Regexp Usage158033
-Node: Escape Sequences160070
-Node: Regexp Operators166302
-Ref: Regexp Operators-Footnote-1173718
-Ref: Regexp Operators-Footnote-2173865
-Node: Bracket Expressions173963
-Ref: table-char-classes176439
-Node: Leftmost Longest179576
-Node: Computed Regexps180879
-Node: GNU Regexp Operators184306
-Node: Case-sensitivity187985
-Ref: Case-sensitivity-Footnote-1190872
-Ref: Case-sensitivity-Footnote-2191107
-Node: Regexp Summary191215
-Node: Reading Files192681
-Node: Records194950
-Node: awk split records195683
-Node: gawk split records200614
-Ref: gawk split records-Footnote-1205154
-Node: Fields205191
-Node: Nonconstant Fields207932
-Ref: Nonconstant Fields-Footnote-1210168
-Node: Changing Fields210372
-Node: Field Separators216300
-Node: Default Field Splitting218998
-Node: Regexp Field Splitting220116
-Node: Single Character Fields223469
-Node: Command Line Field Separator224529
-Node: Full Line Fields227747
-Ref: Full Line Fields-Footnote-1229269
-Ref: Full Line Fields-Footnote-2229315
-Node: Field Splitting Summary229416
-Node: Constant Size231490
-Node: Fixed width data232222
-Node: Skipping intervening235689
-Node: Allowing trailing data236487
-Node: Fields with fixed data237524
-Node: Splitting By Content239042
-Ref: Splitting By Content-Footnote-1242692
-Node: Testing field creation242855
-Node: Multiple Line244476
-Ref: Multiple Line-Footnote-1250360
-Node: Getline250539
-Node: Plain Getline253008
-Node: Getline/Variable255649
-Node: Getline/File256800
-Node: Getline/Variable/File258188
-Ref: Getline/Variable/File-Footnote-1259793
-Node: Getline/Pipe259881
-Node: Getline/Variable/Pipe262588
-Node: Getline/Coprocess263723
-Node: Getline/Variable/Coprocess264990
-Node: Getline Notes265732
-Node: Getline Summary268529
-Ref: table-getline-variants268953
-Node: Read Timeout269701
-Ref: Read Timeout-Footnote-1273607
-Node: Retrying Input273665
-Node: Command-line directories274864
-Node: Input Summary275770
-Node: Input Exercises278942
-Node: Printing279670
-Node: Print281504
-Node: Print Examples282961
-Node: Output Separators285741
-Node: OFMT287758
-Node: Printf289114
-Node: Basic Printf289899
-Node: Control Letters291473
-Node: Format Modifiers295461
-Node: Printf Examples301476
-Node: Redirection303962
-Node: Special FD310803
-Ref: Special FD-Footnote-1313971
-Node: Special Files314045
-Node: Other Inherited Files314662
-Node: Special Network315663
-Node: Special Caveats316523
-Node: Close Files And Pipes317472
-Ref: table-close-pipe-return-values324379
-Ref: Close Files And Pipes-Footnote-1325162
-Ref: Close Files And Pipes-Footnote-2325310
-Node: Nonfatal325462
-Node: Output Summary327787
-Node: Output Exercises329009
-Node: Expressions329688
-Node: Values330876
-Node: Constants331554
-Node: Scalar Constants332245
-Ref: Scalar Constants-Footnote-1333109
-Node: Nondecimal-numbers333359
-Node: Regexp Constants336360
-Node: Using Constant Regexps336886
-Node: Standard Regexp Constants337508
-Node: Strong Regexp Constants340696
-Node: Variables343654
-Node: Using Variables344311
-Node: Assignment Options346221
-Node: Conversion348094
-Node: Strings And Numbers348618
-Ref: Strings And Numbers-Footnote-1351681
-Node: Locale influences conversions351790
-Ref: table-locale-affects354548
-Node: All Operators355166
-Node: Arithmetic Ops355795
-Node: Concatenation358301
-Ref: Concatenation-Footnote-1361148
-Node: Assignment Ops361255
-Ref: table-assign-ops366246
-Node: Increment Ops367559
-Node: Truth Values and Conditions371019
-Node: Truth Values372093
-Node: Typing and Comparison373141
-Node: Variable Typing373961
-Ref: Variable Typing-Footnote-1380424
-Ref: Variable Typing-Footnote-2380496
-Node: Comparison Operators380573
-Ref: table-relational-ops380992
-Node: POSIX String Comparison384487
-Ref: POSIX String Comparison-Footnote-1386182
-Ref: POSIX String Comparison-Footnote-2386321
-Node: Boolean Ops386405
-Ref: Boolean Ops-Footnote-1390887
-Node: Conditional Exp390979
-Node: Function Calls392715
-Node: Precedence396592
-Node: Locales400251
-Node: Expressions Summary401883
-Node: Patterns and Actions404456
-Node: Pattern Overview405576
-Node: Regexp Patterns407253
-Node: Expression Patterns407795
-Node: Ranges411576
-Node: BEGIN/END414684
-Node: Using BEGIN/END415445
-Ref: Using BEGIN/END-Footnote-1418181
-Node: I/O And BEGIN/END418287
-Node: BEGINFILE/ENDFILE420601
-Node: Empty423508
-Node: Using Shell Variables423825
-Node: Action Overview426099
-Node: Statements428424
-Node: If Statement430272
-Node: While Statement431767
-Node: Do Statement433795
-Node: For Statement434943
-Node: Switch Statement438101
-Node: Break Statement440487
-Node: Continue Statement442579
-Node: Next Statement444406
-Node: Nextfile Statement446789
-Node: Exit Statement449441
-Node: Built-in Variables451844
-Node: User-modified452977
-Node: Auto-set460744
-Ref: Auto-set-Footnote-1475472
-Ref: Auto-set-Footnote-2475678
-Node: ARGC and ARGV475734
-Node: Pattern Action Summary479947
-Node: Arrays482377
-Node: Array Basics483706
-Node: Array Intro484550
-Ref: figure-array-elements486525
-Ref: Array Intro-Footnote-1489229
-Node: Reference to Elements489357
-Node: Assigning Elements491821
-Node: Array Example492312
-Node: Scanning an Array494071
-Node: Controlling Scanning497093
-Ref: Controlling Scanning-Footnote-1502492
-Node: Numeric Array Subscripts502808
-Node: Uninitialized Subscripts504992
-Node: Delete506611
-Ref: Delete-Footnote-1509363
-Node: Multidimensional509420
-Node: Multiscanning512515
-Node: Arrays of Arrays514106
-Node: Arrays Summary518873
-Node: Functions520966
-Node: Built-in522004
-Node: Calling Built-in523085
-Node: Numeric Functions525081
-Ref: Numeric Functions-Footnote-1530026
-Ref: Numeric Functions-Footnote-2530383
-Ref: Numeric Functions-Footnote-3530431
-Node: String Functions530703
-Ref: String Functions-Footnote-1554361
-Ref: String Functions-Footnote-2554489
-Ref: String Functions-Footnote-3554737
-Node: Gory Details554824
-Ref: table-sub-escapes556615
-Ref: table-sub-proposed558134
-Ref: table-posix-sub559497
-Ref: table-gensub-escapes561038
-Ref: Gory Details-Footnote-1561861
-Node: I/O Functions562015
-Ref: table-system-return-values568597
-Ref: I/O Functions-Footnote-1570577
-Ref: I/O Functions-Footnote-2570725
-Node: Time Functions570845
-Ref: Time Functions-Footnote-1581512
-Ref: Time Functions-Footnote-2581580
-Ref: Time Functions-Footnote-3581738
-Ref: Time Functions-Footnote-4581849
-Ref: Time Functions-Footnote-5581961
-Ref: Time Functions-Footnote-6582188
-Node: Bitwise Functions582454
-Ref: table-bitwise-ops583048
-Ref: Bitwise Functions-Footnote-1589081
-Ref: Bitwise Functions-Footnote-2589254
-Node: Type Functions589445
-Node: I18N Functions592120
-Node: User-defined593771
-Node: Definition Syntax594576
-Ref: Definition Syntax-Footnote-1600263
-Node: Function Example600334
-Ref: Function Example-Footnote-1603256
-Node: Function Caveats603278
-Node: Calling A Function603796
-Node: Variable Scope604754
-Node: Pass By Value/Reference607748
-Node: Return Statement611247
-Node: Dynamic Typing614226
-Node: Indirect Calls615156
-Ref: Indirect Calls-Footnote-1625407
-Node: Functions Summary625535
-Node: Library Functions628240
-Ref: Library Functions-Footnote-1631847
-Ref: Library Functions-Footnote-2631990
-Node: Library Names632161
-Ref: Library Names-Footnote-1635621
-Ref: Library Names-Footnote-2635844
-Node: General Functions635930
-Node: Strtonum Function637033
-Node: Assert Function640055
-Node: Round Function643381
-Node: Cliff Random Function644922
-Node: Ordinal Functions645938
-Ref: Ordinal Functions-Footnote-1649001
-Ref: Ordinal Functions-Footnote-2649253
-Node: Join Function649463
-Ref: Join Function-Footnote-1651233
-Node: Getlocaltime Function651433
-Node: Readfile Function655175
-Node: Shell Quoting657147
-Node: Data File Management658548
-Node: Filetrans Function659180
-Node: Rewind Function663276
-Node: File Checking665182
-Ref: File Checking-Footnote-1666516
-Node: Empty Files666717
-Node: Ignoring Assigns668696
-Node: Getopt Function670246
-Ref: Getopt Function-Footnote-1681715
-Node: Passwd Functions681915
-Ref: Passwd Functions-Footnote-1690754
-Node: Group Functions690842
-Ref: Group Functions-Footnote-1698740
-Node: Walking Arrays698947
-Node: Library Functions Summary701955
-Node: Library Exercises703361
-Node: Sample Programs703826
-Node: Running Examples704596
-Node: Clones705324
-Node: Cut Program706548
-Node: Egrep Program716477
-Ref: Egrep Program-Footnote-1723989
-Node: Id Program724099
-Node: Split Program727779
-Ref: Split Program-Footnote-1731238
-Node: Tee Program731367
-Node: Uniq Program734157
-Node: Wc Program741583
-Ref: Wc Program-Footnote-1745838
-Node: Miscellaneous Programs745932
-Node: Dupword Program747145
-Node: Alarm Program749175
-Node: Translate Program754030
-Ref: Translate Program-Footnote-1758595
-Node: Labels Program758865
-Ref: Labels Program-Footnote-1762216
-Node: Word Sorting762300
-Node: History Sorting766372
-Node: Extract Program768207
-Node: Simple Sed775736
-Node: Igawk Program778810
-Ref: Igawk Program-Footnote-1793141
-Ref: Igawk Program-Footnote-2793343
-Ref: Igawk Program-Footnote-3793465
-Node: Anagram Program793580
-Node: Signature Program796642
-Node: Programs Summary797889
-Node: Programs Exercises799103
-Ref: Programs Exercises-Footnote-1803232
-Node: Advanced Features803323
-Node: Nondecimal Data805313
-Node: Array Sorting806904
-Node: Controlling Array Traversal807604
-Ref: Controlling Array Traversal-Footnote-1815971
-Node: Array Sorting Functions816089
-Ref: Array Sorting Functions-Footnote-1821180
-Node: Two-way I/O821376
-Ref: Two-way I/O-Footnote-1827927
-Ref: Two-way I/O-Footnote-2828114
-Node: TCP/IP Networking828196
-Node: Profiling831314
-Ref: Profiling-Footnote-1839986
-Node: Advanced Features Summary840309
-Node: Internationalization842153
-Node: I18N and L10N843633
-Node: Explaining gettext844320
-Ref: Explaining gettext-Footnote-1850212
-Ref: Explaining gettext-Footnote-2850397
-Node: Programmer i18n850562
-Ref: Programmer i18n-Footnote-1855511
-Node: Translator i18n855560
-Node: String Extraction856354
-Ref: String Extraction-Footnote-1857486
-Node: Printf Ordering857572
-Ref: Printf Ordering-Footnote-1860358
-Node: I18N Portability860422
-Ref: I18N Portability-Footnote-1862878
-Node: I18N Example862941
-Ref: I18N Example-Footnote-1865747
-Node: Gawk I18N865820
-Node: I18N Summary866465
-Node: Debugger867806
-Node: Debugging868828
-Node: Debugging Concepts869269
-Node: Debugging Terms871078
-Node: Awk Debugging873653
-Node: Sample Debugging Session874559
-Node: Debugger Invocation875093
-Node: Finding The Bug876479
-Node: List of Debugger Commands882957
-Node: Breakpoint Control884290
-Node: Debugger Execution Control887984
-Node: Viewing And Changing Data891346
-Node: Execution Stack894720
-Node: Debugger Info896357
-Node: Miscellaneous Debugger Commands900428
-Node: Readline Support905516
-Node: Limitations906412
-Node: Debugging Summary908521
-Node: Arbitrary Precision Arithmetic909800
-Node: Computer Arithmetic911216
-Ref: table-numeric-ranges914807
-Ref: Computer Arithmetic-Footnote-1915529
-Node: Math Definitions915586
-Ref: table-ieee-formats918900
-Ref: Math Definitions-Footnote-1919503
-Node: MPFR features919608
-Node: FP Math Caution921325
-Ref: FP Math Caution-Footnote-1922397
-Node: Inexactness of computations922766
-Node: Inexact representation923726
-Node: Comparing FP Values925086
-Node: Errors accumulate926168
-Node: Getting Accuracy927601
-Node: Try To Round930311
-Node: Setting precision931210
-Ref: table-predefined-precision-strings931907
-Node: Setting the rounding mode933737
-Ref: table-gawk-rounding-modes934111
-Ref: Setting the rounding mode-Footnote-1937519
-Node: Arbitrary Precision Integers937698
-Ref: Arbitrary Precision Integers-Footnote-1942615
-Node: POSIX Floating Point Problems942764
-Ref: POSIX Floating Point Problems-Footnote-1946646
-Node: Floating point summary946684
-Node: Dynamic Extensions948874
-Node: Extension Intro950427
-Node: Plugin License951693
-Node: Extension Mechanism Outline952490
-Ref: figure-load-extension952929
-Ref: figure-register-new-function954494
-Ref: figure-call-new-function955586
-Node: Extension API Description957648
-Node: Extension API Functions Introduction959290
-Node: General Data Types964624
-Ref: General Data Types-Footnote-1971829
-Node: Memory Allocation Functions972128
-Ref: Memory Allocation Functions-Footnote-1974973
-Node: Constructor Functions975072
-Node: Registration Functions978071
-Node: Extension Functions978756
-Node: Exit Callback Functions983969
-Node: Extension Version String985219
-Node: Input Parsers985882
-Node: Output Wrappers998589
-Node: Two-way processors1003101
-Node: Printing Messages1005366
-Ref: Printing Messages-Footnote-11006537
-Node: Updating ERRNO1006690
-Node: Requesting Values1007429
-Ref: table-value-types-returned1008166
-Node: Accessing Parameters1009102
-Node: Symbol Table Access1010337
-Node: Symbol table by name1010849
-Node: Symbol table by cookie1012638
-Ref: Symbol table by cookie-Footnote-11016823
-Node: Cached values1016887
-Ref: Cached values-Footnote-11020423
-Node: Array Manipulation1020514
-Ref: Array Manipulation-Footnote-11021605
-Node: Array Data Types1021642
-Ref: Array Data Types-Footnote-11024300
-Node: Array Functions1024392
-Node: Flattening Arrays1028791
-Node: Creating Arrays1035732
-Node: Redirection API1040501
-Node: Extension API Variables1043343
-Node: Extension Versioning1043976
-Ref: gawk-api-version1044413
-Node: Extension API Informational Variables1046141
-Node: Extension API Boilerplate1047205
-Node: Changes from API V11051067
-Node: Finding Extensions1051727
-Node: Extension Example1052286
-Node: Internal File Description1053084
-Node: Internal File Ops1057164
-Ref: Internal File Ops-Footnote-11068564
-Node: Using Internal File Ops1068704
-Ref: Using Internal File Ops-Footnote-11071087
-Node: Extension Samples1071361
-Node: Extension Sample File Functions1072890
-Node: Extension Sample Fnmatch1080539
-Node: Extension Sample Fork1082026
-Node: Extension Sample Inplace1083244
-Node: Extension Sample Ord1086454
-Node: Extension Sample Readdir1087290
-Ref: table-readdir-file-types1088179
-Node: Extension Sample Revout1088984
-Node: Extension Sample Rev2way1089573
-Node: Extension Sample Read write array1090313
-Node: Extension Sample Readfile1092255
-Node: Extension Sample Time1093350
-Node: Extension Sample API Tests1094698
-Node: gawkextlib1095190
-Node: Extension summary1097637
-Node: Extension Exercises1101339
-Node: Language History1102837
-Node: V7/SVR3.11104493
-Node: SVR41106645
-Node: POSIX1108079
-Node: BTL1109458
-Node: POSIX/GNU1110187
-Node: Feature History1116079
-Node: Common Extensions1130449
-Node: Ranges and Locales1131732
-Ref: Ranges and Locales-Footnote-11136348
-Ref: Ranges and Locales-Footnote-21136375
-Ref: Ranges and Locales-Footnote-31136610
-Node: Contributors1136831
-Node: History summary1142391
-Node: Installation1143771
-Node: Gawk Distribution1144715
-Node: Getting1145199
-Node: Extracting1146160
-Node: Distribution contents1147798
-Node: Unix Installation1154140
-Node: Quick Installation1154822
-Node: Shell Startup Files1157236
-Node: Additional Configuration Options1158325
-Node: Configuration Philosophy1160314
-Node: Non-Unix Installation1162683
-Node: PC Installation1163143
-Node: PC Binary Installation1163981
-Node: PC Compiling1164416
-Node: PC Using1165533
-Node: Cygwin1168578
-Node: MSYS1169348
-Node: VMS Installation1169849
-Node: VMS Compilation1170640
-Ref: VMS Compilation-Footnote-11171869
-Node: VMS Dynamic Extensions1171927
-Node: VMS Installation Details1173612
-Node: VMS Running1175865
-Node: VMS GNV1180144
-Node: VMS Old Gawk1180879
-Node: Bugs1181350
-Node: Bug address1182013
-Node: Usenet1184410
-Node: Maintainers1185187
-Node: Other Versions1186563
-Node: Installation summary1193147
-Node: Notes1194182
-Node: Compatibility Mode1195047
-Node: Additions1195829
-Node: Accessing The Source1196754
-Node: Adding Code1198189
-Node: New Ports1204407
-Node: Derived Files1208895
-Ref: Derived Files-Footnote-11214380
-Ref: Derived Files-Footnote-21214415
-Ref: Derived Files-Footnote-31215013
-Node: Future Extensions1215127
-Node: Implementation Limitations1215785
-Node: Extension Design1216968
-Node: Old Extension Problems1218122
-Ref: Old Extension Problems-Footnote-11219640
-Node: Extension New Mechanism Goals1219697
-Ref: Extension New Mechanism Goals-Footnote-11223061
-Node: Extension Other Design Decisions1223250
-Node: Extension Future Growth1225363
-Node: Old Extension Mechanism1226199
-Node: Notes summary1227962
-Node: Basic Concepts1229144
-Node: Basic High Level1229825
-Ref: figure-general-flow1230107
-Ref: figure-process-flow1230792
-Ref: Basic High Level-Footnote-11234093
-Node: Basic Data Typing1234278
-Node: Glossary1237606
-Node: Copying1269553
-Node: GNU Free Documentation License1307092
-Node: Index1332210
+Node: Foreword343279
+Node: Foreword447721
+Node: Preface49253
+Ref: Preface-Footnote-152112
+Ref: Preface-Footnote-252219
+Ref: Preface-Footnote-352453
+Node: History52595
+Node: Names54947
+Ref: Names-Footnote-156041
+Node: This Manual56188
+Ref: This Manual-Footnote-162673
+Node: Conventions62773
+Node: Manual History65127
+Ref: Manual History-Footnote-168122
+Ref: Manual History-Footnote-268163
+Node: How To Contribute68237
+Node: Acknowledgments68888
+Node: Getting Started73774
+Node: Running gawk76213
+Node: One-shot77403
+Node: Read Terminal78666
+Node: Long80659
+Node: Executable Scripts82172
+Ref: Executable Scripts-Footnote-184967
+Node: Comments85070
+Node: Quoting87554
+Node: DOS Quoting93071
+Node: Sample Data Files95126
+Node: Very Simple97721
+Node: Two Rules102623
+Node: More Complex104508
+Node: Statements/Lines107374
+Ref: Statements/Lines-Footnote-1111833
+Node: Other Features112098
+Node: When113034
+Ref: When-Footnote-1114788
+Node: Intro Summary114853
+Node: Invoking Gawk115737
+Node: Command Line117251
+Node: Options118049
+Ref: Options-Footnote-1134668
+Ref: Options-Footnote-2134898
+Node: Other Arguments134923
+Node: Naming Standard Input137870
+Node: Environment Variables138963
+Node: AWKPATH Variable139521
+Ref: AWKPATH Variable-Footnote-1142932
+Ref: AWKPATH Variable-Footnote-2142966
+Node: AWKLIBPATH Variable143227
+Node: Other Environment Variables144484
+Node: Exit Status148305
+Node: Include Files148982
+Node: Loading Shared Libraries152577
+Node: Obsolete154005
+Node: Undocumented154697
+Node: Invoking Summary154994
+Node: Regexp156654
+Node: Regexp Usage158108
+Node: Escape Sequences160145
+Node: Regexp Operators166377
+Ref: Regexp Operators-Footnote-1173793
+Ref: Regexp Operators-Footnote-2173940
+Node: Bracket Expressions174038
+Ref: table-char-classes176514
+Node: Leftmost Longest179651
+Node: Computed Regexps180954
+Node: GNU Regexp Operators184381
+Node: Case-sensitivity188060
+Ref: Case-sensitivity-Footnote-1190947
+Ref: Case-sensitivity-Footnote-2191182
+Node: Regexp Summary191290
+Node: Reading Files192756
+Node: Records195025
+Node: awk split records195758
+Node: gawk split records200689
+Ref: gawk split records-Footnote-1205229
+Node: Fields205266
+Node: Nonconstant Fields208007
+Ref: Nonconstant Fields-Footnote-1210243
+Node: Changing Fields210447
+Node: Field Separators216375
+Node: Default Field Splitting219073
+Node: Regexp Field Splitting220191
+Node: Single Character Fields223544
+Node: Command Line Field Separator224604
+Node: Full Line Fields227822
+Ref: Full Line Fields-Footnote-1229344
+Ref: Full Line Fields-Footnote-2229390
+Node: Field Splitting Summary229491
+Node: Constant Size231565
+Node: Fixed width data232297
+Node: Skipping intervening235764
+Node: Allowing trailing data236562
+Node: Fields with fixed data237599
+Node: Splitting By Content239117
+Ref: Splitting By Content-Footnote-1242767
+Node: Testing field creation242930
+Node: Multiple Line244551
+Ref: Multiple Line-Footnote-1250435
+Node: Getline250614
+Node: Plain Getline253083
+Node: Getline/Variable255724
+Node: Getline/File256875
+Node: Getline/Variable/File258263
+Ref: Getline/Variable/File-Footnote-1259868
+Node: Getline/Pipe259956
+Node: Getline/Variable/Pipe262663
+Node: Getline/Coprocess263798
+Node: Getline/Variable/Coprocess265065
+Node: Getline Notes265807
+Node: Getline Summary268604
+Ref: table-getline-variants269028
+Node: Read Timeout269776
+Ref: Read Timeout-Footnote-1273682
+Node: Retrying Input273740
+Node: Command-line directories274939
+Node: Input Summary275845
+Node: Input Exercises279017
+Node: Printing279745
+Node: Print281579
+Node: Print Examples283036
+Node: Output Separators285816
+Node: OFMT287833
+Node: Printf289189
+Node: Basic Printf289974
+Node: Control Letters291548
+Node: Format Modifiers295536
+Node: Printf Examples301551
+Node: Redirection304037
+Node: Special FD310878
+Ref: Special FD-Footnote-1314046
+Node: Special Files314120
+Node: Other Inherited Files314737
+Node: Special Network315738
+Node: Special Caveats316598
+Node: Close Files And Pipes317547
+Ref: table-close-pipe-return-values324454
+Ref: Close Files And Pipes-Footnote-1325237
+Ref: Close Files And Pipes-Footnote-2325385
+Node: Nonfatal325537
+Node: Output Summary327862
+Node: Output Exercises329084
+Node: Expressions329763
+Node: Values330951
+Node: Constants331629
+Node: Scalar Constants332320
+Ref: Scalar Constants-Footnote-1333184
+Node: Nondecimal-numbers333434
+Node: Regexp Constants336435
+Node: Using Constant Regexps336961
+Node: Standard Regexp Constants337583
+Node: Strong Regexp Constants340771
+Node: Variables343729
+Node: Using Variables344386
+Node: Assignment Options346296
+Node: Conversion348169
+Node: Strings And Numbers348693
+Ref: Strings And Numbers-Footnote-1351756
+Node: Locale influences conversions351865
+Ref: table-locale-affects354623
+Node: All Operators355241
+Node: Arithmetic Ops355870
+Node: Concatenation358376
+Ref: Concatenation-Footnote-1361223
+Node: Assignment Ops361330
+Ref: table-assign-ops366321
+Node: Increment Ops367634
+Node: Truth Values and Conditions371094
+Node: Truth Values372168
+Node: Typing and Comparison373216
+Node: Variable Typing374036
+Ref: Variable Typing-Footnote-1380499
+Ref: Variable Typing-Footnote-2380571
+Node: Comparison Operators380648
+Ref: table-relational-ops381067
+Node: POSIX String Comparison384562
+Ref: POSIX String Comparison-Footnote-1386257
+Ref: POSIX String Comparison-Footnote-2386396
+Node: Boolean Ops386480
+Ref: Boolean Ops-Footnote-1390962
+Node: Conditional Exp391054
+Node: Function Calls392790
+Node: Precedence396667
+Node: Locales400326
+Node: Expressions Summary401958
+Node: Patterns and Actions404531
+Node: Pattern Overview405651
+Node: Regexp Patterns407328
+Node: Expression Patterns407870
+Node: Ranges411651
+Node: BEGIN/END414759
+Node: Using BEGIN/END415520
+Ref: Using BEGIN/END-Footnote-1418256
+Node: I/O And BEGIN/END418362
+Node: BEGINFILE/ENDFILE420676
+Node: Empty423583
+Node: Using Shell Variables423900
+Node: Action Overview426174
+Node: Statements428499
+Node: If Statement430347
+Node: While Statement431842
+Node: Do Statement433870
+Node: For Statement435018
+Node: Switch Statement438176
+Node: Break Statement440562
+Node: Continue Statement442654
+Node: Next Statement444481
+Node: Nextfile Statement446864
+Node: Exit Statement449516
+Node: Built-in Variables451919
+Node: User-modified453052
+Node: Auto-set460819
+Ref: Auto-set-Footnote-1475547
+Ref: Auto-set-Footnote-2475753
+Node: ARGC and ARGV475809
+Node: Pattern Action Summary480022
+Node: Arrays482452
+Node: Array Basics483781
+Node: Array Intro484625
+Ref: figure-array-elements486600
+Ref: Array Intro-Footnote-1489304
+Node: Reference to Elements489432
+Node: Assigning Elements491896
+Node: Array Example492387
+Node: Scanning an Array494146
+Node: Controlling Scanning497168
+Ref: Controlling Scanning-Footnote-1502567
+Node: Numeric Array Subscripts502883
+Node: Uninitialized Subscripts505067
+Node: Delete506686
+Ref: Delete-Footnote-1509438
+Node: Multidimensional509495
+Node: Multiscanning512590
+Node: Arrays of Arrays514181
+Node: Arrays Summary518948
+Node: Functions521041
+Node: Built-in522079
+Node: Calling Built-in523160
+Node: Numeric Functions525156
+Ref: Numeric Functions-Footnote-1530101
+Ref: Numeric Functions-Footnote-2530458
+Ref: Numeric Functions-Footnote-3530506
+Node: String Functions530778
+Ref: String Functions-Footnote-1554436
+Ref: String Functions-Footnote-2554564
+Ref: String Functions-Footnote-3554812
+Node: Gory Details554899
+Ref: table-sub-escapes556690
+Ref: table-sub-proposed558209
+Ref: table-posix-sub559572
+Ref: table-gensub-escapes561113
+Ref: Gory Details-Footnote-1561936
+Node: I/O Functions562090
+Ref: table-system-return-values568672
+Ref: I/O Functions-Footnote-1570652
+Ref: I/O Functions-Footnote-2570800
+Node: Time Functions570920
+Ref: Time Functions-Footnote-1581587
+Ref: Time Functions-Footnote-2581655
+Ref: Time Functions-Footnote-3581813
+Ref: Time Functions-Footnote-4581924
+Ref: Time Functions-Footnote-5582036
+Ref: Time Functions-Footnote-6582263
+Node: Bitwise Functions582529
+Ref: table-bitwise-ops583123
+Ref: Bitwise Functions-Footnote-1589156
+Ref: Bitwise Functions-Footnote-2589329
+Node: Type Functions589520
+Node: I18N Functions592195
+Node: User-defined593846
+Node: Definition Syntax594651
+Ref: Definition Syntax-Footnote-1600338
+Node: Function Example600409
+Ref: Function Example-Footnote-1603331
+Node: Function Caveats603353
+Node: Calling A Function603871
+Node: Variable Scope604829
+Node: Pass By Value/Reference607823
+Node: Return Statement611322
+Node: Dynamic Typing614301
+Node: Indirect Calls615231
+Ref: Indirect Calls-Footnote-1625482
+Node: Functions Summary625610
+Node: Library Functions628315
+Ref: Library Functions-Footnote-1631922
+Ref: Library Functions-Footnote-2632065
+Node: Library Names632236
+Ref: Library Names-Footnote-1635696
+Ref: Library Names-Footnote-2635919
+Node: General Functions636005
+Node: Strtonum Function637108
+Node: Assert Function640130
+Node: Round Function643456
+Node: Cliff Random Function644997
+Node: Ordinal Functions646013
+Ref: Ordinal Functions-Footnote-1649076
+Ref: Ordinal Functions-Footnote-2649328
+Node: Join Function649538
+Ref: Join Function-Footnote-1651308
+Node: Getlocaltime Function651508
+Node: Readfile Function655250
+Node: Shell Quoting657222
+Node: Data File Management658623
+Node: Filetrans Function659255
+Node: Rewind Function663351
+Node: File Checking665257
+Ref: File Checking-Footnote-1666591
+Node: Empty Files666792
+Node: Ignoring Assigns668771
+Node: Getopt Function670321
+Ref: Getopt Function-Footnote-1681790
+Node: Passwd Functions681990
+Ref: Passwd Functions-Footnote-1690829
+Node: Group Functions690917
+Ref: Group Functions-Footnote-1698815
+Node: Walking Arrays699022
+Node: Library Functions Summary702030
+Node: Library Exercises703436
+Node: Sample Programs703901
+Node: Running Examples704671
+Node: Clones705399
+Node: Cut Program706623
+Node: Egrep Program716552
+Ref: Egrep Program-Footnote-1724064
+Node: Id Program724174
+Node: Split Program727854
+Ref: Split Program-Footnote-1731313
+Node: Tee Program731442
+Node: Uniq Program734232
+Node: Wc Program741658
+Ref: Wc Program-Footnote-1745913
+Node: Miscellaneous Programs746007
+Node: Dupword Program747220
+Node: Alarm Program749250
+Node: Translate Program754105
+Ref: Translate Program-Footnote-1758670
+Node: Labels Program758940
+Ref: Labels Program-Footnote-1762291
+Node: Word Sorting762375
+Node: History Sorting766447
+Node: Extract Program768282
+Node: Simple Sed775811
+Node: Igawk Program778885
+Ref: Igawk Program-Footnote-1793216
+Ref: Igawk Program-Footnote-2793418
+Ref: Igawk Program-Footnote-3793540
+Node: Anagram Program793655
+Node: Signature Program796717
+Node: Programs Summary797964
+Node: Programs Exercises799178
+Ref: Programs Exercises-Footnote-1803307
+Node: Advanced Features803398
+Node: Nondecimal Data805388
+Node: Array Sorting806979
+Node: Controlling Array Traversal807679
+Ref: Controlling Array Traversal-Footnote-1816046
+Node: Array Sorting Functions816164
+Ref: Array Sorting Functions-Footnote-1821255
+Node: Two-way I/O821451
+Ref: Two-way I/O-Footnote-1828002
+Ref: Two-way I/O-Footnote-2828189
+Node: TCP/IP Networking828271
+Node: Profiling831389
+Ref: Profiling-Footnote-1840061
+Node: Advanced Features Summary840384
+Node: Internationalization842228
+Node: I18N and L10N843708
+Node: Explaining gettext844395
+Ref: Explaining gettext-Footnote-1850287
+Ref: Explaining gettext-Footnote-2850472
+Node: Programmer i18n850637
+Ref: Programmer i18n-Footnote-1855586
+Node: Translator i18n855635
+Node: String Extraction856429
+Ref: String Extraction-Footnote-1857561
+Node: Printf Ordering857647
+Ref: Printf Ordering-Footnote-1860433
+Node: I18N Portability860497
+Ref: I18N Portability-Footnote-1862953
+Node: I18N Example863016
+Ref: I18N Example-Footnote-1865822
+Node: Gawk I18N865895
+Node: I18N Summary866540
+Node: Debugger867881
+Node: Debugging868903
+Node: Debugging Concepts869344
+Node: Debugging Terms871153
+Node: Awk Debugging873728
+Node: Sample Debugging Session874634
+Node: Debugger Invocation875168
+Node: Finding The Bug876554
+Node: List of Debugger Commands883032
+Node: Breakpoint Control884365
+Node: Debugger Execution Control888059
+Node: Viewing And Changing Data891421
+Node: Execution Stack894795
+Node: Debugger Info896432
+Node: Miscellaneous Debugger Commands900503
+Node: Readline Support905591
+Node: Limitations906487
+Node: Debugging Summary908596
+Node: Arbitrary Precision Arithmetic909875
+Node: Computer Arithmetic911360
+Ref: table-numeric-ranges914951
+Ref: Computer Arithmetic-Footnote-1915673
+Node: Math Definitions915730
+Ref: table-ieee-formats919044
+Ref: Math Definitions-Footnote-1919647
+Node: MPFR features919752
+Node: FP Math Caution921469
+Ref: FP Math Caution-Footnote-1922541
+Node: Inexactness of computations922910
+Node: Inexact representation923870
+Node: Comparing FP Values925230
+Node: Errors accumulate926312
+Node: Getting Accuracy927745
+Node: Try To Round930455
+Node: Setting precision931354
+Ref: table-predefined-precision-strings932051
+Node: Setting the rounding mode933881
+Ref: table-gawk-rounding-modes934255
+Ref: Setting the rounding mode-Footnote-1937663
+Node: Arbitrary Precision Integers937842
+Ref: Arbitrary Precision Integers-Footnote-1942747
+Node: Checking for MPFR942896
+Node: POSIX Floating Point Problems944193
+Ref: POSIX Floating Point Problems-Footnote-1948064
+Node: Floating point summary948102
+Node: Dynamic Extensions950292
+Node: Extension Intro951845
+Node: Plugin License953111
+Node: Extension Mechanism Outline953908
+Ref: figure-load-extension954347
+Ref: figure-register-new-function955912
+Ref: figure-call-new-function957004
+Node: Extension API Description959066
+Node: Extension API Functions Introduction960708
+Node: General Data Types966042
+Ref: General Data Types-Footnote-1973247
+Node: Memory Allocation Functions973546
+Ref: Memory Allocation Functions-Footnote-1976391
+Node: Constructor Functions976490
+Node: Registration Functions979489
+Node: Extension Functions980174
+Node: Exit Callback Functions985387
+Node: Extension Version String986637
+Node: Input Parsers987300
+Node: Output Wrappers1000007
+Node: Two-way processors1004519
+Node: Printing Messages1006784
+Ref: Printing Messages-Footnote-11007955
+Node: Updating ERRNO1008108
+Node: Requesting Values1008847
+Ref: table-value-types-returned1009584
+Node: Accessing Parameters1010520
+Node: Symbol Table Access1011755
+Node: Symbol table by name1012267
+Node: Symbol table by cookie1014056
+Ref: Symbol table by cookie-Footnote-11018241
+Node: Cached values1018305
+Ref: Cached values-Footnote-11021841
+Node: Array Manipulation1021932
+Ref: Array Manipulation-Footnote-11023023
+Node: Array Data Types1023060
+Ref: Array Data Types-Footnote-11025718
+Node: Array Functions1025810
+Node: Flattening Arrays1030209
+Node: Creating Arrays1037150
+Node: Redirection API1041919
+Node: Extension API Variables1044761
+Node: Extension Versioning1045394
+Ref: gawk-api-version1045831
+Node: Extension API Informational Variables1047559
+Node: Extension API Boilerplate1048623
+Node: Changes from API V11052485
+Node: Finding Extensions1053145
+Node: Extension Example1053704
+Node: Internal File Description1054502
+Node: Internal File Ops1058582
+Ref: Internal File Ops-Footnote-11069982
+Node: Using Internal File Ops1070122
+Ref: Using Internal File Ops-Footnote-11072505
+Node: Extension Samples1072779
+Node: Extension Sample File Functions1074308
+Node: Extension Sample Fnmatch1081957
+Node: Extension Sample Fork1083444
+Node: Extension Sample Inplace1084662
+Node: Extension Sample Ord1087872
+Node: Extension Sample Readdir1088708
+Ref: table-readdir-file-types1089597
+Node: Extension Sample Revout1090402
+Node: Extension Sample Rev2way1090991
+Node: Extension Sample Read write array1091731
+Node: Extension Sample Readfile1093673
+Node: Extension Sample Time1094768
+Node: Extension Sample API Tests1096116
+Node: gawkextlib1096608
+Node: Extension summary1099055
+Node: Extension Exercises1102757
+Node: Language History1104255
+Node: V7/SVR3.11105911
+Node: SVR41108063
+Node: POSIX1109497
+Node: BTL1110876
+Node: POSIX/GNU1111605
+Node: Feature History1117497
+Node: Common Extensions1131867
+Node: Ranges and Locales1133150
+Ref: Ranges and Locales-Footnote-11137766
+Ref: Ranges and Locales-Footnote-21137793
+Ref: Ranges and Locales-Footnote-31138028
+Node: Contributors1138249
+Node: History summary1143809
+Node: Installation1145189
+Node: Gawk Distribution1146133
+Node: Getting1146617
+Node: Extracting1147578
+Node: Distribution contents1149216
+Node: Unix Installation1155558
+Node: Quick Installation1156240
+Node: Shell Startup Files1158654
+Node: Additional Configuration Options1159743
+Node: Configuration Philosophy1161732
+Node: Non-Unix Installation1164101
+Node: PC Installation1164561
+Node: PC Binary Installation1165399
+Node: PC Compiling1165834
+Node: PC Using1166951
+Node: Cygwin1169996
+Node: MSYS1170766
+Node: VMS Installation1171267
+Node: VMS Compilation1172058
+Ref: VMS Compilation-Footnote-11173287
+Node: VMS Dynamic Extensions1173345
+Node: VMS Installation Details1175030
+Node: VMS Running1177283
+Node: VMS GNV1181562
+Node: VMS Old Gawk1182297
+Node: Bugs1182768
+Node: Bug address1183431
+Node: Usenet1185828
+Node: Maintainers1186605
+Node: Other Versions1187981
+Node: Installation summary1194565
+Node: Notes1195600
+Node: Compatibility Mode1196465
+Node: Additions1197247
+Node: Accessing The Source1198172
+Node: Adding Code1199607
+Node: New Ports1205825
+Node: Derived Files1210313
+Ref: Derived Files-Footnote-11215798
+Ref: Derived Files-Footnote-21215833
+Ref: Derived Files-Footnote-31216431
+Node: Future Extensions1216545
+Node: Implementation Limitations1217203
+Node: Extension Design1218386
+Node: Old Extension Problems1219540
+Ref: Old Extension Problems-Footnote-11221058
+Node: Extension New Mechanism Goals1221115
+Ref: Extension New Mechanism Goals-Footnote-11224479
+Node: Extension Other Design Decisions1224668
+Node: Extension Future Growth1226781
+Node: Old Extension Mechanism1227617
+Node: Notes summary1229380
+Node: Basic Concepts1230562
+Node: Basic High Level1231243
+Ref: figure-general-flow1231525
+Ref: figure-process-flow1232210
+Ref: Basic High Level-Footnote-11235511
+Node: Basic Data Typing1235696
+Node: Glossary1239024
+Node: Copying1270971
+Node: GNU Free Documentation License1308510
+Node: Index1333628
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5b9eeed..e7d7552 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -64,7 +64,7 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
address@hidden UPDATE-MONTH January, 2017
address@hidden UPDATE-MONTH May, 2017
@set VERSION 4.1
@set PATCHLEVEL 4
@@ -908,6 +908,7 @@ particular records in a file and perform operations upon
them.
* Setting the rounding mode:: How to set the rounding mode.
* Arbitrary Precision Integers:: Arbitrary Precision Integer Arithmetic
with @command{gawk}.
+* Checking for MPFR:: How to check if MPFR is available.
* POSIX Floating Point Problems:: Standards Versus Existing Practice.
* Floating point summary:: Summary of floating point discussion.
* Extension Intro:: What is an extension.
@@ -4988,7 +4989,7 @@ the name by which @command{gawk} was invoked. Here is an
example of how this
feature may be used:
@example
-awk '
+gawk '
BEGIN @{
for (i = 0; i < length(PROCINFO["argv"]); i++)
print i, PROCINFO["argv"][i]
@@ -31224,6 +31225,7 @@ this is the place to be.
* FP Math Caution:: Things to know.
* Arbitrary Precision Integers:: Arbitrary Precision Integer Arithmetic with
@command{gawk}.
+* Checking for MPFR:: How to check if MPFR is available.
* POSIX Floating Point Problems:: Standards Versus Existing Practice.
* Floating point summary:: Summary of floating point discussion.
@end menu
@@ -32125,6 +32127,58 @@ word sizes. See
@uref{http://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899}.
@end quotation
address@hidden Checking for MPFR
address@hidden How To Check If MPFR Is Available
+
address@hidden MPFR, checking availability of
address@hidden checking for MPFR
+Occasionally, you might like to be able to check if @command{gawk}
+was invoked with the @option{-M} option, enabling aribtrary-precision
+arithmetic. You can do so with the following function, contributed
+by Andrew Schorr:
+
address@hidden
address@hidden file eg/lib/have_mpfr.awk
+# adequate_math_precision --- return true if we have enough bits
address@hidden endfile
address@hidden
address@hidden file eg/lib/have_mpfr.awk
+#
+# Andrew Schorr, aschorr@@telemetry-investments.com, Public Domain
+# May 2017
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/have_mpfr.awk
+
+function adequate_math_precision(n)
address@hidden
+ return (1 != (1+(1/(2^(n-1)))))
address@hidden
address@hidden endfile
address@hidden example
+
+Here is code that invokes the function in order to check
+if arbitrary-precision arithmetic is available:
+
address@hidden
+BEGIN @{
+ # How many bits of mantissa precision are required
+ # for this program to function properly?
+ fpbits = 123
+
+ # We hope that we were invoked with MPFR enabled. If so, the
+ # following statement should configure calculations to our desired
+ # precision.
+ PREC = fpbits
+
+ if (! adequate_math_precision(fpbits)) @{
+ print("Error: insufficient computation precision available.\n" \
+ "Try again with the -M argument?") > "/dev/stderr"
+ exit 1
+ @}
address@hidden
address@hidden example
+
@node POSIX Floating Point Problems
@section Standards Versus Existing Practice
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 1e1b134..f95360d 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -59,7 +59,7 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
address@hidden UPDATE-MONTH January, 2017
address@hidden UPDATE-MONTH May, 2017
@set VERSION 4.1
@set PATCHLEVEL 4
@@ -903,6 +903,7 @@ particular records in a file and perform operations upon
them.
* Setting the rounding mode:: How to set the rounding mode.
* Arbitrary Precision Integers:: Arbitrary Precision Integer Arithmetic
with @command{gawk}.
+* Checking for MPFR:: How to check if MPFR is available.
* POSIX Floating Point Problems:: Standards Versus Existing Practice.
* Floating point summary:: Summary of floating point discussion.
* Extension Intro:: What is an extension.
@@ -4899,7 +4900,7 @@ the name by which @command{gawk} was invoked. Here is an
example of how this
feature may be used:
@example
-awk '
+gawk '
BEGIN @{
for (i = 0; i < length(PROCINFO["argv"]); i++)
print i, PROCINFO["argv"][i]
@@ -30238,6 +30239,7 @@ this is the place to be.
* FP Math Caution:: Things to know.
* Arbitrary Precision Integers:: Arbitrary Precision Integer Arithmetic with
@command{gawk}.
+* Checking for MPFR:: How to check if MPFR is available.
* POSIX Floating Point Problems:: Standards Versus Existing Practice.
* Floating point summary:: Summary of floating point discussion.
@end menu
@@ -31139,6 +31141,58 @@ word sizes. See
@uref{http://www.hpmuseum.org/cgi-sys/cgiwrap/hpmuseum/articles.cgi?read=899}.
@end quotation
address@hidden Checking for MPFR
address@hidden How To Check If MPFR Is Available
+
address@hidden MPFR, checking availability of
address@hidden checking for MPFR
+Occasionally, you might like to be able to check if @command{gawk}
+was invoked with the @option{-M} option, enabling aribtrary-precision
+arithmetic. You can do so with the following function, contributed
+by Andrew Schorr:
+
address@hidden
address@hidden file eg/lib/have_mpfr.awk
+# adequate_math_precision --- return true if we have enough bits
address@hidden endfile
address@hidden
address@hidden file eg/lib/have_mpfr.awk
+#
+# Andrew Schorr, aschorr@@telemetry-investments.com, Public Domain
+# May 2017
address@hidden endfile
address@hidden ignore
address@hidden file eg/lib/have_mpfr.awk
+
+function adequate_math_precision(n)
address@hidden
+ return (1 != (1+(1/(2^(n-1)))))
address@hidden
address@hidden endfile
address@hidden example
+
+Here is code that invokes the function in order to check
+if arbitrary-precision arithmetic is available:
+
address@hidden
+BEGIN @{
+ # How many bits of mantissa precision are required
+ # for this program to function properly?
+ fpbits = 123
+
+ # We hope that we were invoked with MPFR enabled. If so, the
+ # following statement should configure calculations to our desired
+ # precision.
+ PREC = fpbits
+
+ if (! adequate_math_precision(fpbits)) @{
+ print("Error: insufficient computation precision available.\n" \
+ "Try again with the -M argument?") > "/dev/stderr"
+ exit 1
+ @}
address@hidden
address@hidden example
+
@node POSIX Floating Point Problems
@section Standards Versus Existing Practice
-----------------------------------------------------------------------
Summary of changes:
awklib/eg/lib/have_mpfr.awk | 9 +
doc/ChangeLog | 5 +
doc/gawk.info | 1198 ++++++++++++++++++++++---------------------
doc/gawk.texi | 58 ++-
doc/gawktexi.in | 58 ++-
5 files changed, 746 insertions(+), 582 deletions(-)
create mode 100644 awklib/eg/lib/have_mpfr.awk
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-2567-gc73879a,
Arnold Robbins <=