home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: SHell self-extracting ARchive
(archive/shar).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Newsgroup Content (archive/news)
| magic
| Supported |
| 100%
| dexvert
| SHell self-extracting ARchive (archive/shar)
| magic
| Supported |
| 100%
| dexvert
| Internet Message Format (text/imf)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| news or mail, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/329 Shell Archive Format
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| message/rfc822
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 53 75 62 6a 65 63 74 3a | 20 20 76 32 32 69 30 39 |Subject:| v22i09|
|00000010| 30 3a 20 20 47 4e 55 20 | 41 57 4b 2c 20 76 65 72 |0: GNU |AWK, ver|
|00000020| 73 69 6f 6e 20 32 2e 31 | 31 2c 20 50 61 72 74 30 |sion 2.1|1, Part0|
|00000030| 34 2f 31 36 0a 4e 65 77 | 73 67 72 6f 75 70 73 3a |4/16.New|sgroups:|
|00000040| 20 63 6f 6d 70 2e 73 6f | 75 72 63 65 73 2e 75 6e | comp.so|urces.un|
|00000050| 69 78 0a 41 70 70 72 6f | 76 65 64 3a 20 72 73 61 |ix.Appro|ved: rsa|
|00000060| 6c 7a 40 75 75 6e 65 74 | 2e 55 55 2e 4e 45 54 0a |lz@uunet|.UU.NET.|
|00000070| 58 2d 43 68 65 63 6b 73 | 75 6d 2d 53 6e 65 66 72 |X-Checks|um-Snefr|
|00000080| 75 3a 20 33 35 38 33 36 | 34 32 33 20 39 64 39 31 |u: 35836|423 9d91|
|00000090| 64 63 32 32 20 63 38 39 | 39 66 65 39 32 20 63 37 |dc22 c89|9fe92 c7|
|000000a0| 62 34 31 66 31 30 0a 0a | 53 75 62 6d 69 74 74 65 |b41f10..|Submitte|
|000000b0| 64 2d 62 79 3a 20 22 41 | 72 6e 6f 6c 64 20 44 2e |d-by: "A|rnold D.|
|000000c0| 20 52 6f 62 62 69 6e 73 | 22 20 3c 61 72 6e 6f 6c | Robbins|" <arnol|
|000000d0| 64 40 75 6e 69 78 2e 63 | 63 2e 65 6d 6f 72 79 2e |d@unix.c|c.emory.|
|000000e0| 65 64 75 3e 0a 50 6f 73 | 74 69 6e 67 2d 6e 75 6d |edu>.Pos|ting-num|
|000000f0| 62 65 72 3a 20 56 6f 6c | 75 6d 65 20 32 32 2c 20 |ber: Vol|ume 22, |
|00000100| 49 73 73 75 65 20 39 30 | 0a 41 72 63 68 69 76 65 |Issue 90|.Archive|
|00000110| 2d 6e 61 6d 65 3a 20 67 | 61 77 6b 32 2e 31 31 2f |-name: g|awk2.11/|
|00000120| 70 61 72 74 30 34 0a 0a | 23 21 20 2f 62 69 6e 2f |part04..|#! /bin/|
|00000130| 73 68 0a 23 20 54 68 69 | 73 20 69 73 20 61 20 73 |sh.# Thi|s is a s|
|00000140| 68 65 6c 6c 20 61 72 63 | 68 69 76 65 2e 20 20 52 |hell arc|hive. R|
|00000150| 65 6d 6f 76 65 20 61 6e | 79 74 68 69 6e 67 20 62 |emove an|ything b|
|00000160| 65 66 6f 72 65 20 74 68 | 69 73 20 6c 69 6e 65 2c |efore th|is line,|
|00000170| 20 74 68 65 6e 20 66 65 | 65 64 20 69 74 0a 23 20 | then fe|ed it.# |
|00000180| 69 6e 74 6f 20 61 20 73 | 68 65 6c 6c 20 76 69 61 |into a s|hell via|
|00000190| 20 22 73 68 20 66 69 6c | 65 22 20 6f 72 20 73 69 | "sh fil|e" or si|
|000001a0| 6d 69 6c 61 72 2e 20 20 | 54 6f 20 6f 76 65 72 77 |milar. |To overw|
|000001b0| 72 69 74 65 20 65 78 69 | 73 74 69 6e 67 20 66 69 |rite exi|sting fi|
|000001c0| 6c 65 73 2c 0a 23 20 74 | 79 70 65 20 22 73 68 20 |les,.# t|ype "sh |
|000001d0| 66 69 6c 65 20 2d 63 22 | 2e 0a 23 20 54 68 65 20 |file -c"|..# The |
|000001e0| 74 6f 6f 6c 20 74 68 61 | 74 20 67 65 6e 65 72 61 |tool tha|t genera|
|000001f0| 74 65 64 20 74 68 69 73 | 20 61 70 70 65 61 72 65 |ted this| appeare|
|00000200| 64 20 69 6e 20 74 68 65 | 20 63 6f 6d 70 2e 73 6f |d in the| comp.so|
|00000210| 75 72 63 65 73 2e 75 6e | 69 78 20 6e 65 77 73 67 |urces.un|ix newsg|
|00000220| 72 6f 75 70 3b 0a 23 20 | 73 65 6e 64 20 6d 61 69 |roup;.# |send mai|
|00000230| 6c 20 74 6f 20 63 6f 6d | 70 2d 73 6f 75 72 63 65 |l to com|p-source|
|00000240| 73 2d 75 6e 69 78 40 75 | 75 6e 65 74 2e 75 75 2e |s-unix@u|unet.uu.|
|00000250| 6e 65 74 20 69 66 20 79 | 6f 75 20 77 61 6e 74 20 |net if y|ou want |
|00000260| 74 68 61 74 20 74 6f 6f | 6c 2e 0a 23 20 43 6f 6e |that too|l..# Con|
|00000270| 74 65 6e 74 73 3a 20 20 | 2e 2f 67 61 77 6b 2e 74 |tents: |./gawk.t|
|00000280| 65 78 69 6e 66 6f 2e 30 | 35 20 2e 2f 70 61 74 63 |exinfo.0|5 ./patc|
|00000290| 68 6c 65 76 65 6c 2e 68 | 20 2e 2f 70 63 2e 64 2f |hlevel.h| ./pc.d/|
|000002a0| 70 6f 70 65 6e 2e 63 0a | 23 20 57 72 61 70 70 65 |popen.c.|# Wrappe|
|000002b0| 64 20 62 79 20 72 73 61 | 6c 7a 40 6c 69 74 63 68 |d by rsa|lz@litch|
|000002c0| 69 2e 62 62 6e 2e 63 6f | 6d 20 6f 6e 20 57 65 64 |i.bbn.co|m on Wed|
|000002d0| 20 4a 75 6e 20 20 36 20 | 31 32 3a 32 34 3a 34 38 | Jun 6 |12:24:48|
|000002e0| 20 31 39 39 30 0a 50 41 | 54 48 3d 2f 62 69 6e 3a | 1990.PA|TH=/bin:|
|000002f0| 2f 75 73 72 2f 62 69 6e | 3a 2f 75 73 72 2f 75 63 |/usr/bin|:/usr/uc|
|00000300| 62 20 3b 20 65 78 70 6f | 72 74 20 50 41 54 48 0a |b ; expo|rt PATH.|
|00000310| 65 63 68 6f 20 49 66 20 | 74 68 69 73 20 61 72 63 |echo If |this arc|
|00000320| 68 69 76 65 20 69 73 20 | 63 6f 6d 70 6c 65 74 65 |hive is |complete|
|00000330| 2c 20 79 6f 75 20 77 69 | 6c 6c 20 73 65 65 20 74 |, you wi|ll see t|
|00000340| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 6d 65 73 |he follo|wing mes|
|00000350| 73 61 67 65 3a 0a 65 63 | 68 6f 20 27 20 20 20 20 |sage:.ec|ho ' |
|00000360| 20 20 20 20 20 20 22 73 | 68 61 72 3a 20 45 6e 64 | "s|har: End|
|00000370| 20 6f 66 20 61 72 63 68 | 69 76 65 20 34 20 28 6f | of arch|ive 4 (o|
|00000380| 66 20 31 36 29 2e 22 27 | 0a 69 66 20 74 65 73 74 |f 16)."'|.if test|
|00000390| 20 2d 66 20 27 2e 2f 67 | 61 77 6b 2e 74 65 78 69 | -f './g|awk.texi|
|000003a0| 6e 66 6f 2e 30 35 27 20 | 2d 61 20 22 24 7b 31 7d |nfo.05' |-a "${1}|
|000003b0| 22 20 21 3d 20 22 2d 63 | 22 20 3b 20 74 68 65 6e |" != "-c|" ; then|
|000003c0| 20 0a 20 20 65 63 68 6f | 20 73 68 61 72 3a 20 57 | . echo| shar: W|
|000003d0| 69 6c 6c 20 6e 6f 74 20 | 63 6c 6f 62 62 65 72 20 |ill not |clobber |
|000003e0| 65 78 69 73 74 69 6e 67 | 20 66 69 6c 65 20 5c 22 |existing| file \"|
|000003f0| 27 2e 2f 67 61 77 6b 2e | 74 65 78 69 6e 66 6f 2e |'./gawk.|texinfo.|
|00000400| 30 35 27 5c 22 0a 65 6c | 73 65 0a 20 20 65 63 68 |05'\".el|se. ech|
|00000410| 6f 20 73 68 61 72 3a 20 | 45 78 74 72 61 63 74 69 |o shar: |Extracti|
|00000420| 6e 67 20 5c 22 27 2e 2f | 67 61 77 6b 2e 74 65 78 |ng \"'./|gawk.tex|
|00000430| 69 6e 66 6f 2e 30 35 27 | 5c 22 20 5c 28 34 39 36 |info.05'|\" \(496|
|00000440| 36 36 20 63 68 61 72 61 | 63 74 65 72 73 5c 29 0a |66 chara|cters\).|
|00000450| 20 20 73 65 64 20 22 73 | 2f 5e 58 2f 2f 22 20 3e | sed "s|/^X//" >|
|00000460| 27 2e 2f 67 61 77 6b 2e | 74 65 78 69 6e 66 6f 2e |'./gawk.|texinfo.|
|00000470| 30 35 27 20 3c 3c 27 45 | 4e 44 5f 4f 46 5f 46 49 |05' <<'E|ND_OF_FI|
|00000480| 4c 45 27 0a 58 49 66 20 | 61 20 6c 69 6e 65 20 6e |LE'.XIf |a line n|
|00000490| 75 6d 62 65 72 20 69 73 | 20 72 65 70 65 61 74 65 |umber is| repeate|
|000004a0| 64 2c 20 74 68 65 20 6c | 61 73 74 20 6c 69 6e 65 |d, the l|ast line|
|000004b0| 20 77 69 74 68 20 61 20 | 67 69 76 65 6e 20 6e 75 | with a |given nu|
|000004c0| 6d 62 65 72 20 6f 76 65 | 72 72 69 64 65 73 0a 58 |mber ove|rrides.X|
|000004d0| 74 68 65 20 6f 74 68 65 | 72 73 2e 0a 58 0a 58 47 |the othe|rs..X.XG|
|000004e0| 61 70 73 20 69 6e 20 74 | 68 65 20 6c 69 6e 65 20 |aps in t|he line |
|000004f0| 6e 75 6d 62 65 72 73 20 | 63 61 6e 20 62 65 20 68 |numbers |can be h|
|00000500| 61 6e 64 6c 65 64 20 77 | 69 74 68 20 61 6e 20 65 |andled w|ith an e|
|00000510| 61 73 79 20 69 6d 70 72 | 6f 76 65 6d 65 6e 74 20 |asy impr|ovement |
|00000520| 74 6f 20 74 68 65 0a 58 | 70 72 6f 67 72 61 6d 27 |to the.X|program'|
|00000530| 73 20 40 63 6f 64 65 7b | 45 4e 44 7d 20 72 75 6c |s @code{|END} rul|
|00000540| 65 3a 0a 58 0a 58 40 65 | 78 61 6d 70 6c 65 0a 58 |e:.X.X@e|xample.X|
|00000550| 45 4e 44 20 40 7b 0a 58 | 20 20 66 6f 72 20 28 78 |END @{.X| for (x|
|00000560| 20 3d 20 31 3b 20 78 20 | 3c 3d 20 6d 61 78 3b 20 | = 1; x |<= max; |
|00000570| 78 2b 2b 29 0a 58 20 20 | 20 20 69 66 20 28 78 20 |x++).X | if (x |
|00000580| 69 6e 20 61 72 72 29 0a | 58 20 20 20 20 20 20 70 |in arr).|X p|
|00000590| 72 69 6e 74 20 61 72 72 | 5b 78 5d 0a 58 40 7d 0a |rint arr|[x].X@}.|
|000005a0| 58 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 58 0a |X@end ex|ample.X.|
|000005b0| 58 40 6e 6f 64 65 20 53 | 63 61 6e 6e 69 6e 67 20 |X@node S|canning |
|000005c0| 61 6e 20 41 72 72 61 79 | 2c 20 44 65 6c 65 74 65 |an Array|, Delete|
|000005d0| 2c 20 41 72 72 61 79 20 | 45 78 61 6d 70 6c 65 2c |, Array |Example,|
|000005e0| 20 41 72 72 61 79 73 0a | 58 40 73 65 63 74 69 6f | Arrays.|X@sectio|
|000005f0| 6e 20 53 63 61 6e 6e 69 | 6e 67 20 41 6c 6c 20 45 |n Scanni|ng All E|
|00000600| 6c 65 6d 65 6e 74 73 20 | 6f 66 20 61 6e 20 41 72 |lements |of an Ar|
|00000610| 72 61 79 0a 58 40 63 69 | 6e 64 65 78 20 40 63 6f |ray.X@ci|ndex @co|
|00000620| 64 65 7b 66 6f 72 20 28 | 78 20 69 6e 20 40 64 6f |de{for (|x in @do|
|00000630| 74 73 7b 7d 29 7d 0a 58 | 40 63 69 6e 64 65 78 20 |ts{})}.X|@cindex |
|00000640| 61 72 72 61 79 73 2c 20 | 73 70 65 63 69 61 6c 20 |arrays, |special |
|00000650| 40 63 6f 64 65 7b 66 6f | 72 7d 20 73 74 61 74 65 |@code{fo|r} state|
|00000660| 6d 65 6e 74 0a 58 40 63 | 69 6e 64 65 78 20 73 63 |ment.X@c|index sc|
|00000670| 61 6e 6e 69 6e 67 20 61 | 6e 20 61 72 72 61 79 0a |anning a|n array.|
|00000680| 58 0a 58 49 6e 20 70 72 | 6f 67 72 61 6d 73 20 74 |X.XIn pr|ograms t|
|00000690| 68 61 74 20 75 73 65 20 | 61 72 72 61 79 73 2c 20 |hat use |arrays, |
|000006a0| 6f 66 74 65 6e 20 79 6f | 75 20 6e 65 65 64 20 61 |often yo|u need a|
|000006b0| 20 6c 6f 6f 70 20 74 68 | 61 74 20 65 78 65 63 75 | loop th|at execu|
|000006c0| 74 65 73 0a 58 6f 6e 63 | 65 20 66 6f 72 20 65 61 |tes.Xonc|e for ea|
|000006d0| 63 68 20 65 6c 65 6d 65 | 6e 74 20 6f 66 20 61 6e |ch eleme|nt of an|
|000006e0| 20 61 72 72 61 79 2e 20 | 20 49 6e 20 6f 74 68 65 | array. | In othe|
|000006f0| 72 20 6c 61 6e 67 75 61 | 67 65 73 2c 20 77 68 65 |r langua|ges, whe|
|00000700| 72 65 20 61 72 72 61 79 | 73 20 61 72 65 0a 58 63 |re array|s are.Xc|
|00000710| 6f 6e 74 69 67 75 6f 75 | 73 20 61 6e 64 20 69 6e |ontiguou|s and in|
|00000720| 64 69 63 65 73 20 61 72 | 65 20 6c 69 6d 69 74 65 |dices ar|e limite|
|00000730| 64 20 74 6f 20 70 6f 73 | 69 74 69 76 65 20 69 6e |d to pos|itive in|
|00000740| 74 65 67 65 72 73 2c 20 | 74 68 69 73 20 69 73 0a |tegers, |this is.|
|00000750| 58 65 61 73 79 3a 20 74 | 68 65 20 6c 61 72 67 65 |Xeasy: t|he large|
|00000760| 73 74 20 69 6e 64 65 78 | 20 69 73 20 6f 6e 65 20 |st index| is one |
|00000770| 6c 65 73 73 20 74 68 61 | 6e 20 74 68 65 20 6c 65 |less tha|n the le|
|00000780| 6e 67 74 68 20 6f 66 20 | 74 68 65 20 61 72 72 61 |ngth of |the arra|
|00000790| 79 2c 20 61 6e 64 20 79 | 6f 75 20 63 61 6e 0a 58 |y, and y|ou can.X|
|000007a0| 66 69 6e 64 20 61 6c 6c | 20 74 68 65 20 76 61 6c |find all| the val|
|000007b0| 69 64 20 69 6e 64 69 63 | 65 73 20 62 79 20 63 6f |id indic|es by co|
|000007c0| 75 6e 74 69 6e 67 20 66 | 72 6f 6d 20 7a 65 72 6f |unting f|rom zero|
|000007d0| 20 75 70 20 74 6f 20 74 | 68 61 74 20 76 61 6c 75 | up to t|hat valu|
|000007e0| 65 2e 20 20 54 68 69 73 | 0a 58 74 65 63 68 6e 69 |e. This|.Xtechni|
|000007f0| 71 75 65 20 77 6f 6e 27 | 74 20 64 6f 20 74 68 65 |que won'|t do the|
|00000800| 20 6a 6f 62 20 69 6e 20 | 40 63 6f 64 65 7b 61 77 | job in |@code{aw|
|00000810| 6b 7d 2c 20 73 69 6e 63 | 65 20 61 6e 79 20 6e 75 |k}, sinc|e any nu|
|00000820| 6d 62 65 72 20 6f 72 20 | 73 74 72 69 6e 67 0a 58 |mber or |string.X|
|00000830| 6d 61 79 20 62 65 20 61 | 6e 20 61 72 72 61 79 20 |may be a|n array |
|00000840| 69 6e 64 65 78 2e 20 20 | 53 6f 20 40 63 6f 64 65 |index. |So @code|
|00000850| 7b 61 77 6b 7d 20 68 61 | 73 20 61 20 73 70 65 63 |{awk} ha|s a spec|
|00000860| 69 61 6c 20 6b 69 6e 64 | 20 6f 66 20 40 63 6f 64 |ial kind| of @cod|
|00000870| 65 7b 66 6f 72 7d 0a 58 | 73 74 61 74 65 6d 65 6e |e{for}.X|statemen|
|00000880| 74 20 66 6f 72 20 73 63 | 61 6e 6e 69 6e 67 20 61 |t for sc|anning a|
|00000890| 6e 20 61 72 72 61 79 3a | 0a 58 0a 58 40 65 78 61 |n array:|.X.X@exa|
|000008a0| 6d 70 6c 65 0a 58 66 6f | 72 20 28 40 76 61 72 7b |mple.Xfo|r (@var{|
|000008b0| 76 61 72 7d 20 69 6e 20 | 40 76 61 72 7b 61 72 72 |var} in |@var{arr|
|000008c0| 61 79 7d 29 0a 58 20 20 | 40 76 61 72 7b 62 6f 64 |ay}).X |@var{bod|
|000008d0| 79 7d 0a 58 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |y}.X@end| example|
|000008e0| 0a 58 0a 58 40 6e 6f 69 | 6e 64 65 6e 74 0a 58 54 |.X.X@noi|ndent.XT|
|000008f0| 68 69 73 20 6c 6f 6f 70 | 20 65 78 65 63 75 74 65 |his loop| execute|
|00000900| 73 20 40 76 61 72 7b 62 | 6f 64 79 7d 20 6f 6e 63 |s @var{b|ody} onc|
|00000910| 65 20 66 6f 72 20 65 61 | 63 68 20 64 69 66 66 65 |e for ea|ch diffe|
|00000920| 72 65 6e 74 20 76 61 6c | 75 65 20 74 68 61 74 20 |rent val|ue that |
|00000930| 79 6f 75 72 0a 58 70 72 | 6f 67 72 61 6d 20 68 61 |your.Xpr|ogram ha|
|00000940| 73 20 70 72 65 76 69 6f | 75 73 6c 79 20 75 73 65 |s previo|usly use|
|00000950| 64 20 61 73 20 61 6e 20 | 69 6e 64 65 78 20 69 6e |d as an |index in|
|00000960| 20 40 76 61 72 7b 61 72 | 72 61 79 7d 2c 20 77 69 | @var{ar|ray}, wi|
|00000970| 74 68 20 74 68 65 0a 58 | 76 61 72 69 61 62 6c 65 |th the.X|variable|
|00000980| 20 40 76 61 72 7b 76 61 | 72 7d 20 73 65 74 20 74 | @var{va|r} set t|
|00000990| 6f 20 74 68 61 74 20 69 | 6e 64 65 78 2e 40 72 65 |o that i|ndex.@re|
|000009a0| 66 69 6c 6c 0a 58 0a 58 | 48 65 72 65 20 69 73 20 |fill.X.X|Here is |
|000009b0| 61 20 70 72 6f 67 72 61 | 6d 20 74 68 61 74 20 75 |a progra|m that u|
|000009c0| 73 65 73 20 74 68 69 73 | 20 66 6f 72 6d 20 6f 66 |ses this| form of|
|000009d0| 20 74 68 65 20 40 63 6f | 64 65 7b 66 6f 72 7d 20 | the @co|de{for} |
|000009e0| 73 74 61 74 65 6d 65 6e | 74 2e 20 20 54 68 65 0a |statemen|t. The.|
|000009f0| 58 66 69 72 73 74 20 72 | 75 6c 65 20 73 63 61 6e |Xfirst r|ule scan|
|00000a00| 73 20 74 68 65 20 69 6e | 70 75 74 20 72 65 63 6f |s the in|put reco|
|00000a10| 72 64 73 20 61 6e 64 20 | 6e 6f 74 65 73 20 77 68 |rds and |notes wh|
|00000a20| 69 63 68 20 77 6f 72 64 | 73 20 61 70 70 65 61 72 |ich word|s appear|
|00000a30| 20 28 61 74 0a 58 6c 65 | 61 73 74 20 6f 6e 63 65 | (at.Xle|ast once|
|00000a40| 29 20 69 6e 20 74 68 65 | 20 69 6e 70 75 74 2c 20 |) in the| input, |
|00000a50| 62 79 20 73 74 6f 72 69 | 6e 67 20 61 20 31 20 69 |by stori|ng a 1 i|
|00000a60| 6e 74 6f 20 74 68 65 20 | 61 72 72 61 79 20 40 63 |nto the |array @c|
|00000a70| 6f 64 65 7b 75 73 65 64 | 7d 20 77 69 74 68 0a 58 |ode{used|} with.X|
|00000a80| 74 68 65 20 77 6f 72 64 | 20 61 73 20 69 6e 64 65 |the word| as inde|
|00000a90| 78 2e 20 20 54 68 65 20 | 73 65 63 6f 6e 64 20 72 |x. The |second r|
|00000aa0| 75 6c 65 20 73 63 61 6e | 73 20 74 68 65 20 65 6c |ule scan|s the el|
|00000ab0| 65 6d 65 6e 74 73 20 6f | 66 20 40 63 6f 64 65 7b |ements o|f @code{|
|00000ac0| 75 73 65 64 7d 20 74 6f | 0a 58 66 69 6e 64 20 61 |used} to|.Xfind a|
|00000ad0| 6c 6c 20 74 68 65 20 64 | 69 73 74 69 6e 63 74 20 |ll the d|istinct |
|00000ae0| 77 6f 72 64 73 20 74 68 | 61 74 20 61 70 70 65 61 |words th|at appea|
|00000af0| 72 20 69 6e 20 74 68 65 | 20 69 6e 70 75 74 2e 20 |r in the| input. |
|00000b00| 20 49 74 20 70 72 69 6e | 74 73 20 65 61 63 68 0a | It prin|ts each.|
|00000b10| 58 77 6f 72 64 20 74 68 | 61 74 20 69 73 20 6d 6f |Xword th|at is mo|
|00000b20| 72 65 20 74 68 61 6e 20 | 31 30 20 63 68 61 72 61 |re than |10 chara|
|00000b30| 63 74 65 72 73 20 6c 6f | 6e 67 2c 20 61 6e 64 20 |cters lo|ng, and |
|00000b40| 61 6c 73 6f 20 70 72 69 | 6e 74 73 20 74 68 65 20 |also pri|nts the |
|00000b50| 6e 75 6d 62 65 72 20 6f | 66 0a 58 73 75 63 68 20 |number o|f.Xsuch |
|00000b60| 77 6f 72 64 73 2e 20 20 | 40 78 72 65 66 7b 42 75 |words. |@xref{Bu|
|00000b70| 69 6c 74 2d 69 6e 7d 2c | 20 66 6f 72 20 6d 6f 72 |ilt-in},| for mor|
|00000b80| 65 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 6f 6e |e inform|ation on|
|00000b90| 20 74 68 65 20 62 75 69 | 6c 74 2d 69 6e 0a 58 66 | the bui|lt-in.Xf|
|00000ba0| 75 6e 63 74 69 6f 6e 20 | 40 63 6f 64 65 7b 6c 65 |unction |@code{le|
|00000bb0| 6e 67 74 68 7d 2e 0a 58 | 0a 58 40 65 78 61 6d 70 |ngth}..X|.X@examp|
|00000bc0| 6c 65 0a 58 23 20 52 65 | 63 6f 72 64 20 61 20 31 |le.X# Re|cord a 1|
|00000bd0| 20 66 6f 72 20 65 61 63 | 68 20 77 6f 72 64 20 74 | for eac|h word t|
|00000be0| 68 61 74 20 69 73 20 75 | 73 65 64 20 61 74 20 6c |hat is u|sed at l|
|00000bf0| 65 61 73 74 20 6f 6e 63 | 65 2e 0a 58 40 7b 0a 58 |east onc|e..X@{.X|
|00000c00| 20 20 66 6f 72 20 28 69 | 20 3d 20 30 3b 20 69 20 | for (i| = 0; i |
|00000c10| 3c 20 4e 46 3b 20 69 2b | 2b 29 0a 58 20 20 20 20 |< NF; i+|+).X |
|00000c20| 75 73 65 64 5b 24 69 5d | 20 3d 20 31 0a 58 40 7d |used[$i]| = 1.X@}|
|00000c30| 0a 58 0a 58 23 20 46 69 | 6e 64 20 6e 75 6d 62 65 |.X.X# Fi|nd numbe|
|00000c40| 72 20 6f 66 20 64 69 73 | 74 69 6e 63 74 20 77 6f |r of dis|tinct wo|
|00000c50| 72 64 73 20 6d 6f 72 65 | 20 74 68 61 6e 20 31 30 |rds more| than 10|
|00000c60| 20 63 68 61 72 61 63 74 | 65 72 73 20 6c 6f 6e 67 | charact|ers long|
|00000c70| 2e 0a 58 45 4e 44 20 40 | 7b 0a 58 20 20 6e 75 6d |..XEND @|{.X num|
|00000c80| 5f 6c 6f 6e 67 5f 77 6f | 72 64 73 20 3d 20 30 0a |_long_wo|rds = 0.|
|00000c90| 58 20 20 66 6f 72 20 28 | 78 20 69 6e 20 75 73 65 |X for (|x in use|
|00000ca0| 64 29 0a 58 20 20 20 20 | 69 66 20 28 6c 65 6e 67 |d).X |if (leng|
|00000cb0| 74 68 28 78 29 20 3e 20 | 31 30 29 20 40 7b 0a 58 |th(x) > |10) @{.X|
|00000cc0| 20 20 20 20 20 20 2b 2b | 6e 75 6d 5f 6c 6f 6e 67 | ++|num_long|
|00000cd0| 5f 77 6f 72 64 73 0a 58 | 20 20 20 20 20 20 70 72 |_words.X| pr|
|00000ce0| 69 6e 74 20 78 0a 58 20 | 20 40 7d 0a 58 20 20 70 |int x.X | @}.X p|
|00000cf0| 72 69 6e 74 20 6e 75 6d | 5f 6c 6f 6e 67 5f 77 6f |rint num|_long_wo|
|00000d00| 72 64 73 2c 20 22 77 6f | 72 64 73 20 6c 6f 6e 67 |rds, "wo|rds long|
|00000d10| 65 72 20 74 68 61 6e 20 | 31 30 20 63 68 61 72 61 |er than |10 chara|
|00000d20| 63 74 65 72 73 22 0a 58 | 40 7d 0a 58 40 65 6e 64 |cters".X|@}.X@end|
|00000d30| 20 65 78 61 6d 70 6c 65 | 0a 58 0a 58 40 6e 6f 69 | example|.X.X@noi|
|00000d40| 6e 64 65 6e 74 0a 58 40 | 78 72 65 66 7b 53 61 6d |ndent.X@|xref{Sam|
|00000d50| 70 6c 65 20 50 72 6f 67 | 72 61 6d 7d 2c 20 66 6f |ple Prog|ram}, fo|
|00000d60| 72 20 61 20 6d 6f 72 65 | 20 64 65 74 61 69 6c 65 |r a more| detaile|
|00000d70| 64 20 65 78 61 6d 70 6c | 65 20 6f 66 20 74 68 69 |d exampl|e of thi|
|00000d80| 73 20 74 79 70 65 2e 0a | 58 0a 58 54 68 65 20 6f |s type..|X.XThe o|
|00000d90| 72 64 65 72 20 69 6e 20 | 77 68 69 63 68 20 65 6c |rder in |which el|
|00000da0| 65 6d 65 6e 74 73 20 6f | 66 20 74 68 65 20 61 72 |ements o|f the ar|
|00000db0| 72 61 79 20 61 72 65 20 | 61 63 63 65 73 73 65 64 |ray are |accessed|
|00000dc0| 20 62 79 20 74 68 69 73 | 20 73 74 61 74 65 6d 65 | by this| stateme|
|00000dd0| 6e 74 0a 58 69 73 20 64 | 65 74 65 72 6d 69 6e 65 |nt.Xis d|etermine|
|00000de0| 64 20 62 79 20 74 68 65 | 20 69 6e 74 65 72 6e 61 |d by the| interna|
|00000df0| 6c 20 61 72 72 61 6e 67 | 65 6d 65 6e 74 20 6f 66 |l arrang|ement of|
|00000e00| 20 74 68 65 20 61 72 72 | 61 79 20 65 6c 65 6d 65 | the arr|ay eleme|
|00000e10| 6e 74 73 20 77 69 74 68 | 69 6e 0a 58 40 63 6f 64 |nts with|in.X@cod|
|00000e20| 65 7b 61 77 6b 7d 20 61 | 6e 64 20 63 61 6e 6e 6f |e{awk} a|nd canno|
|00000e30| 74 20 62 65 20 63 6f 6e | 74 72 6f 6c 6c 65 64 20 |t be con|trolled |
|00000e40| 6f 72 20 63 68 61 6e 67 | 65 64 2e 20 20 54 68 69 |or chang|ed. Thi|
|00000e50| 73 20 63 61 6e 20 6c 65 | 61 64 20 74 6f 0a 58 70 |s can le|ad to.Xp|
|00000e60| 72 6f 62 6c 65 6d 73 20 | 69 66 20 6e 65 77 20 65 |roblems |if new e|
|00000e70| 6c 65 6d 65 6e 74 73 20 | 61 72 65 20 61 64 64 65 |lements |are adde|
|00000e80| 64 20 74 6f 20 40 76 61 | 72 7b 61 72 72 61 79 7d |d to @va|r{array}|
|00000e90| 20 62 79 20 73 74 61 74 | 65 6d 65 6e 74 73 20 69 | by stat|ements i|
|00000ea0| 6e 0a 58 40 76 61 72 7b | 62 6f 64 79 7d 3b 20 79 |n.X@var{|body}; y|
|00000eb0| 6f 75 20 63 61 6e 6e 6f | 74 20 70 72 65 64 69 63 |ou canno|t predic|
|00000ec0| 74 20 77 68 65 74 68 65 | 72 20 6f 72 20 6e 6f 74 |t whethe|r or not|
|00000ed0| 20 74 68 65 20 40 63 6f | 64 65 7b 66 6f 72 7d 20 | the @co|de{for} |
|00000ee0| 6c 6f 6f 70 20 77 69 6c | 6c 0a 58 72 65 61 63 68 |loop wil|l.Xreach|
|00000ef0| 20 74 68 65 6d 2e 20 20 | 53 69 6d 69 6c 61 72 6c | them. |Similarl|
|00000f00| 79 2c 20 63 68 61 6e 67 | 69 6e 67 20 40 76 61 72 |y, chang|ing @var|
|00000f10| 7b 76 61 72 7d 20 69 6e | 73 69 64 65 20 74 68 65 |{var} in|side the|
|00000f20| 20 6c 6f 6f 70 20 63 61 | 6e 20 70 72 6f 64 75 63 | loop ca|n produc|
|00000f30| 65 0a 58 73 74 72 61 6e | 67 65 20 72 65 73 75 6c |e.Xstran|ge resul|
|00000f40| 74 73 2e 20 20 49 74 20 | 69 73 20 62 65 73 74 20 |ts. It |is best |
|00000f50| 74 6f 20 61 76 6f 69 64 | 20 73 75 63 68 20 74 68 |to avoid| such th|
|00000f60| 69 6e 67 73 2e 40 72 65 | 66 69 6c 6c 0a 58 0a 58 |ings.@re|fill.X.X|
|00000f70| 40 6e 6f 64 65 20 44 65 | 6c 65 74 65 2c 20 4d 75 |@node De|lete, Mu|
|00000f80| 6c 74 69 2d 64 69 6d 65 | 6e 73 69 6f 6e 61 6c 2c |lti-dime|nsional,|
|00000f90| 20 53 63 61 6e 6e 69 6e | 67 20 61 6e 20 41 72 72 | Scannin|g an Arr|
|00000fa0| 61 79 2c 20 41 72 72 61 | 79 73 0a 58 40 73 65 63 |ay, Arra|ys.X@sec|
|00000fb0| 74 69 6f 6e 20 54 68 65 | 20 40 63 6f 64 65 7b 64 |tion The| @code{d|
|00000fc0| 65 6c 65 74 65 7d 20 53 | 74 61 74 65 6d 65 6e 74 |elete} S|tatement|
|00000fd0| 0a 58 40 63 69 6e 64 65 | 78 20 40 63 6f 64 65 7b |.X@cinde|x @code{|
|00000fe0| 64 65 6c 65 74 65 7d 20 | 73 74 61 74 65 6d 65 6e |delete} |statemen|
|00000ff0| 74 0a 58 40 63 69 6e 64 | 65 78 20 64 65 6c 65 74 |t.X@cind|ex delet|
|00001000| 69 6e 67 20 65 6c 65 6d | 65 6e 74 73 20 6f 66 20 |ing elem|ents of |
|00001010| 61 72 72 61 79 73 0a 58 | 40 63 69 6e 64 65 78 20 |arrays.X|@cindex |
|00001020| 72 65 6d 6f 76 69 6e 67 | 20 65 6c 65 6d 65 6e 74 |removing| element|
|00001030| 73 20 6f 66 20 61 72 72 | 61 79 73 0a 58 40 63 69 |s of arr|ays.X@ci|
|00001040| 6e 64 65 78 20 61 72 72 | 61 79 73 2c 20 64 65 6c |ndex arr|ays, del|
|00001050| 65 74 69 6e 67 20 61 6e | 20 65 6c 65 6d 65 6e 74 |eting an| element|
|00001060| 0a 58 0a 58 59 6f 75 20 | 63 61 6e 20 72 65 6d 6f |.X.XYou |can remo|
|00001070| 76 65 20 61 6e 20 69 6e | 64 69 76 69 64 75 61 6c |ve an in|dividual|
|00001080| 20 65 6c 65 6d 65 6e 74 | 20 6f 66 20 61 6e 20 61 | element| of an a|
|00001090| 72 72 61 79 20 75 73 69 | 6e 67 20 74 68 65 20 40 |rray usi|ng the @|
|000010a0| 63 6f 64 65 7b 64 65 6c | 65 74 65 7d 0a 58 73 74 |code{del|ete}.Xst|
|000010b0| 61 74 65 6d 65 6e 74 3a | 0a 58 0a 58 40 65 78 61 |atement:|.X.X@exa|
|000010c0| 6d 70 6c 65 0a 58 64 65 | 6c 65 74 65 20 40 76 61 |mple.Xde|lete @va|
|000010d0| 72 7b 61 72 72 61 79 7d | 5b 40 76 61 72 7b 69 6e |r{array}|[@var{in|
|000010e0| 64 65 78 7d 5d 0a 58 40 | 65 6e 64 20 65 78 61 6d |dex}].X@|end exam|
|000010f0| 70 6c 65 0a 58 0a 58 57 | 68 65 6e 20 61 6e 20 61 |ple.X.XW|hen an a|
|00001100| 72 72 61 79 20 65 6c 65 | 6d 65 6e 74 20 69 73 20 |rray ele|ment is |
|00001110| 64 65 6c 65 74 65 64 2c | 20 69 74 20 69 73 20 61 |deleted,| it is a|
|00001120| 73 20 69 66 20 79 6f 75 | 20 68 61 64 20 6e 65 76 |s if you| had nev|
|00001130| 65 72 20 72 65 66 65 72 | 72 65 64 20 74 6f 20 69 |er refer|red to i|
|00001140| 74 0a 58 61 6e 64 20 68 | 61 64 20 6e 65 76 65 72 |t.Xand h|ad never|
|00001150| 20 67 69 76 65 6e 20 69 | 74 20 61 6e 79 20 76 61 | given i|t any va|
|00001160| 6c 75 65 2e 20 20 41 6e | 79 20 76 61 6c 75 65 20 |lue. An|y value |
|00001170| 74 68 65 20 65 6c 65 6d | 65 6e 74 20 66 6f 72 6d |the elem|ent form|
|00001180| 65 72 6c 79 20 68 61 64 | 0a 58 63 61 6e 20 6e 6f |erly had|.Xcan no|
|00001190| 20 6c 6f 6e 67 65 72 20 | 62 65 20 6f 62 74 61 69 | longer |be obtai|
|000011a0| 6e 65 64 2e 0a 58 0a 58 | 48 65 72 65 20 69 73 20 |ned..X.X|Here is |
|000011b0| 61 6e 20 65 78 61 6d 70 | 6c 65 20 6f 66 20 64 65 |an examp|le of de|
|000011c0| 6c 65 74 69 6e 67 20 65 | 6c 65 6d 65 6e 74 73 20 |leting e|lements |
|000011d0| 69 6e 20 61 6e 20 61 72 | 72 61 79 3a 0a 58 0a 58 |in an ar|ray:.X.X|
|000011e0| 40 65 78 61 6d 70 6c 65 | 0a 58 66 6f 72 20 28 69 |@example|.Xfor (i|
|000011f0| 20 69 6e 20 66 72 65 71 | 75 65 6e 63 69 65 73 29 | in freq|uencies)|
|00001200| 0a 58 20 20 64 65 6c 65 | 74 65 20 66 72 65 71 75 |.X dele|te frequ|
|00001210| 65 6e 63 69 65 73 5b 69 | 5d 0a 58 40 65 6e 64 20 |encies[i|].X@end |
|00001220| 65 78 61 6d 70 6c 65 0a | 58 0a 58 40 6e 6f 69 6e |example.|X.X@noin|
|00001230| 64 65 6e 74 0a 58 54 68 | 69 73 20 65 78 61 6d 70 |dent.XTh|is examp|
|00001240| 6c 65 20 72 65 6d 6f 76 | 65 73 20 61 6c 6c 20 74 |le remov|es all t|
|00001250| 68 65 20 65 6c 65 6d 65 | 6e 74 73 20 66 72 6f 6d |he eleme|nts from|
|00001260| 20 74 68 65 20 61 72 72 | 61 79 20 40 63 6f 64 65 | the arr|ay @code|
|00001270| 7b 66 72 65 71 75 65 6e | 63 69 65 73 7d 2e 0a 58 |{frequen|cies}..X|
|00001280| 0a 58 49 66 20 79 6f 75 | 20 64 65 6c 65 74 65 20 |.XIf you| delete |
|00001290| 61 6e 20 65 6c 65 6d 65 | 6e 74 2c 20 61 20 73 75 |an eleme|nt, a su|
|000012a0| 62 73 65 71 75 65 6e 74 | 20 40 63 6f 64 65 7b 66 |bsequent| @code{f|
|000012b0| 6f 72 7d 20 73 74 61 74 | 65 6d 65 6e 74 20 74 6f |or} stat|ement to|
|000012c0| 20 73 63 61 6e 20 74 68 | 65 20 61 72 72 61 79 0a | scan th|e array.|
|000012d0| 58 77 69 6c 6c 20 6e 6f | 74 20 72 65 70 6f 72 74 |Xwill no|t report|
|000012e0| 20 74 68 61 74 20 65 6c | 65 6d 65 6e 74 2c 20 61 | that el|ement, a|
|000012f0| 6e 64 20 74 68 65 20 40 | 63 6f 64 65 7b 69 6e 7d |nd the @|code{in}|
|00001300| 20 6f 70 65 72 61 74 6f | 72 20 74 6f 20 63 68 65 | operato|r to che|
|00001310| 63 6b 20 66 6f 72 0a 58 | 74 68 65 20 70 72 65 73 |ck for.X|the pres|
|00001320| 65 6e 63 65 20 6f 66 20 | 74 68 61 74 20 65 6c 65 |ence of |that ele|
|00001330| 6d 65 6e 74 20 77 69 6c | 6c 20 72 65 74 75 72 6e |ment wil|l return|
|00001340| 20 30 3a 0a 58 0a 58 40 | 65 78 61 6d 70 6c 65 0a | 0:.X.X@|example.|
|00001350| 58 64 65 6c 65 74 65 20 | 66 6f 6f 5b 34 5d 0a 58 |Xdelete |foo[4].X|
|00001360| 69 66 20 28 34 20 69 6e | 20 66 6f 6f 29 0a 58 20 |if (4 in| foo).X |
|00001370| 20 70 72 69 6e 74 20 22 | 54 68 69 73 20 77 69 6c | print "|This wil|
|00001380| 6c 20 6e 65 76 65 72 20 | 62 65 20 70 72 69 6e 74 |l never |be print|
|00001390| 65 64 22 0a 58 40 65 6e | 64 20 65 78 61 6d 70 6c |ed".X@en|d exampl|
|000013a0| 65 0a 58 0a 58 40 6e 6f | 64 65 20 4d 75 6c 74 69 |e.X.X@no|de Multi|
|000013b0| 2d 64 69 6d 65 6e 73 69 | 6f 6e 61 6c 2c 20 4d 75 |-dimensi|onal, Mu|
|000013c0| 6c 74 69 2d 73 63 61 6e | 6e 69 6e 67 2c 20 44 65 |lti-scan|ning, De|
|000013d0| 6c 65 74 65 2c 20 41 72 | 72 61 79 73 0a 58 40 73 |lete, Ar|rays.X@s|
|000013e0| 65 63 74 69 6f 6e 20 4d | 75 6c 74 69 2d 64 69 6d |ection M|ulti-dim|
|000013f0| 65 6e 73 69 6f 6e 61 6c | 20 41 72 72 61 79 73 0a |ensional| Arrays.|
|00001400| 58 0a 58 40 63 69 6e 64 | 65 78 20 73 75 62 73 63 |X.X@cind|ex subsc|
|00001410| 72 69 70 74 73 2c 20 6d | 75 6c 74 69 2d 64 69 6d |ripts, m|ulti-dim|
|00001420| 65 6e 73 69 6f 6e 61 6c | 20 69 6e 20 61 72 72 61 |ensional| in arra|
|00001430| 79 73 0a 58 40 63 69 6e | 64 65 78 20 61 72 72 61 |ys.X@cin|dex arra|
|00001440| 79 73 2c 20 6d 75 6c 74 | 69 2d 64 69 6d 65 6e 73 |ys, mult|i-dimens|
|00001450| 69 6f 6e 61 6c 20 73 75 | 62 73 63 72 69 70 74 73 |ional su|bscripts|
|00001460| 0a 58 40 63 69 6e 64 65 | 78 20 6d 75 6c 74 69 2d |.X@cinde|x multi-|
|00001470| 64 69 6d 65 6e 73 69 6f | 6e 61 6c 20 73 75 62 73 |dimensio|nal subs|
|00001480| 63 72 69 70 74 73 0a 58 | 41 20 6d 75 6c 74 69 2d |cripts.X|A multi-|
|00001490| 64 69 6d 65 6e 73 69 6f | 6e 61 6c 20 61 72 72 61 |dimensio|nal arra|
|000014a0| 79 20 69 73 20 61 6e 20 | 61 72 72 61 79 20 69 6e |y is an |array in|
|000014b0| 20 77 68 69 63 68 20 61 | 6e 20 65 6c 65 6d 65 6e | which a|n elemen|
|000014c0| 74 20 69 73 20 69 64 65 | 6e 74 69 66 69 65 64 0a |t is ide|ntified.|
|000014d0| 58 62 79 20 61 20 73 65 | 71 75 65 6e 63 65 20 6f |Xby a se|quence o|
|000014e0| 66 20 69 6e 64 69 63 65 | 73 2c 20 6e 6f 74 20 61 |f indice|s, not a|
|000014f0| 20 73 69 6e 67 6c 65 20 | 69 6e 64 65 78 2e 20 20 | single |index. |
|00001500| 46 6f 72 20 65 78 61 6d | 70 6c 65 2c 20 61 0a 58 |For exam|ple, a.X|
|00001510| 74 77 6f 2d 64 69 6d 65 | 6e 73 69 6f 6e 61 6c 20 |two-dime|nsional |
|00001520| 61 72 72 61 79 20 72 65 | 71 75 69 72 65 73 20 74 |array re|quires t|
|00001530| 77 6f 20 69 6e 64 69 63 | 65 73 2e 20 20 54 68 65 |wo indic|es. The|
|00001540| 20 75 73 75 61 6c 20 77 | 61 79 20 28 69 6e 20 6d | usual w|ay (in m|
|00001550| 6f 73 74 0a 58 6c 61 6e | 67 75 61 67 65 73 2c 20 |ost.Xlan|guages, |
|00001560| 69 6e 63 6c 75 64 69 6e | 67 20 40 63 6f 64 65 7b |includin|g @code{|
|00001570| 61 77 6b 7d 29 20 74 6f | 20 72 65 66 65 72 20 74 |awk}) to| refer t|
|00001580| 6f 20 61 6e 20 65 6c 65 | 6d 65 6e 74 20 6f 66 20 |o an ele|ment of |
|00001590| 61 0a 58 74 77 6f 2d 64 | 69 6d 65 6e 73 69 6f 6e |a.Xtwo-d|imension|
|000015a0| 61 6c 20 61 72 72 61 79 | 20 6e 61 6d 65 64 20 40 |al array| named @|
|000015b0| 63 6f 64 65 7b 67 72 69 | 64 7d 20 69 73 20 77 69 |code{gri|d} is wi|
|000015c0| 74 68 0a 58 40 63 6f 64 | 65 7b 67 72 69 64 5b 40 |th.X@cod|e{grid[@|
|000015d0| 76 61 72 7b 78 7d 2c 40 | 76 61 72 7b 79 7d 5d 7d |var{x},@|var{y}]}|
|000015e0| 2e 0a 58 0a 58 40 76 69 | 6e 64 65 78 20 53 55 42 |..X.X@vi|ndex SUB|
|000015f0| 53 45 50 0a 58 4d 75 6c | 74 69 2d 64 69 6d 65 6e |SEP.XMul|ti-dimen|
|00001600| 73 69 6f 6e 61 6c 20 61 | 72 72 61 79 73 20 61 72 |sional a|rrays ar|
|00001610| 65 20 73 75 70 70 6f 72 | 74 65 64 20 69 6e 20 40 |e suppor|ted in @|
|00001620| 63 6f 64 65 7b 61 77 6b | 7d 20 74 68 72 6f 75 67 |code{awk|} throug|
|00001630| 68 0a 58 63 6f 6e 63 61 | 74 65 6e 61 74 69 6f 6e |h.Xconca|tenation|
|00001640| 20 6f 66 20 69 6e 64 69 | 63 65 73 20 69 6e 74 6f | of indi|ces into|
|00001650| 20 6f 6e 65 20 73 74 72 | 69 6e 67 2e 20 20 57 68 | one str|ing. Wh|
|00001660| 61 74 20 68 61 70 70 65 | 6e 73 20 69 73 20 74 68 |at happe|ns is th|
|00001670| 61 74 0a 58 40 63 6f 64 | 65 7b 61 77 6b 7d 20 63 |at.X@cod|e{awk} c|
|00001680| 6f 6e 76 65 72 74 73 20 | 74 68 65 20 69 6e 64 69 |onverts |the indi|
|00001690| 63 65 73 20 69 6e 74 6f | 20 73 74 72 69 6e 67 73 |ces into| strings|
|000016a0| 20 28 40 70 78 72 65 66 | 7b 43 6f 6e 76 65 72 73 | (@pxref|{Convers|
|000016b0| 69 6f 6e 7d 29 20 61 6e | 64 0a 58 63 6f 6e 63 61 |ion}) an|d.Xconca|
|000016c0| 74 65 6e 61 74 65 73 20 | 74 68 65 6d 20 74 6f 67 |tenates |them tog|
|000016d0| 65 74 68 65 72 2c 20 77 | 69 74 68 20 61 20 73 65 |ether, w|ith a se|
|000016e0| 70 61 72 61 74 6f 72 20 | 62 65 74 77 65 65 6e 20 |parator |between |
|000016f0| 74 68 65 6d 2e 20 20 54 | 68 69 73 20 63 72 65 61 |them. T|his crea|
|00001700| 74 65 73 0a 58 61 20 73 | 69 6e 67 6c 65 20 73 74 |tes.Xa s|ingle st|
|00001710| 72 69 6e 67 20 74 68 61 | 74 20 64 65 73 63 72 69 |ring tha|t descri|
|00001720| 62 65 73 20 74 68 65 20 | 76 61 6c 75 65 73 20 6f |bes the |values o|
|00001730| 66 20 74 68 65 20 73 65 | 70 61 72 61 74 65 20 69 |f the se|parate i|
|00001740| 6e 64 69 63 65 73 2e 20 | 20 54 68 65 0a 58 63 6f |ndices. | The.Xco|
|00001750| 6d 62 69 6e 65 64 20 73 | 74 72 69 6e 67 20 69 73 |mbined s|tring is|
|00001760| 20 75 73 65 64 20 61 73 | 20 61 20 73 69 6e 67 6c | used as| a singl|
|00001770| 65 20 69 6e 64 65 78 20 | 69 6e 74 6f 20 61 6e 20 |e index |into an |
|00001780| 6f 72 64 69 6e 61 72 79 | 2c 0a 58 6f 6e 65 2d 64 |ordinary|,.Xone-d|
|00001790| 69 6d 65 6e 73 69 6f 6e | 61 6c 20 61 72 72 61 79 |imension|al array|
|000017a0| 2e 20 20 54 68 65 20 73 | 65 70 61 72 61 74 6f 72 |. The s|eparator|
|000017b0| 20 75 73 65 64 20 69 73 | 20 74 68 65 20 76 61 6c | used is| the val|
|000017c0| 75 65 20 6f 66 20 74 68 | 65 20 62 75 69 6c 74 2d |ue of th|e built-|
|000017d0| 69 6e 0a 58 76 61 72 69 | 61 62 6c 65 20 40 63 6f |in.Xvari|able @co|
|000017e0| 64 65 7b 53 55 42 53 45 | 50 7d 2e 0a 58 0a 58 46 |de{SUBSE|P}..X.XF|
|000017f0| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 20 73 75 70 70 |or examp|le, supp|
|00001800| 6f 73 65 20 77 65 20 65 | 76 61 6c 75 61 74 65 20 |ose we e|valuate |
|00001810| 74 68 65 20 65 78 70 72 | 65 73 73 69 6f 6e 20 40 |the expr|ession @|
|00001820| 63 6f 64 65 7b 66 6f 6f | 5b 35 2c 31 32 5d 3d 22 |code{foo|[5,12]="|
|00001830| 76 61 6c 75 65 22 7d 0a | 58 77 68 65 6e 20 74 68 |value"}.|Xwhen th|
|00001840| 65 20 76 61 6c 75 65 20 | 6f 66 20 40 63 6f 64 65 |e value |of @code|
|00001850| 7b 53 55 42 53 45 50 7d | 20 69 73 20 40 63 6f 64 |{SUBSEP}| is @cod|
|00001860| 65 7b 22 40 40 22 7d 2e | 20 20 54 68 65 20 6e 75 |e{"@@"}.| The nu|
|00001870| 6d 62 65 72 73 20 35 20 | 61 6e 64 20 31 32 20 61 |mbers 5 |and 12 a|
|00001880| 72 65 0a 58 63 6f 6e 63 | 61 74 65 6e 61 74 65 64 |re.Xconc|atenated|
|00001890| 20 77 69 74 68 20 61 20 | 63 6f 6d 6d 61 20 62 65 | with a |comma be|
|000018a0| 74 77 65 65 6e 20 74 68 | 65 6d 2c 20 79 69 65 6c |tween th|em, yiel|
|000018b0| 64 69 6e 67 20 40 63 6f | 64 65 7b 22 35 40 40 31 |ding @co|de{"5@@1|
|000018c0| 32 22 7d 3b 20 74 68 75 | 73 2c 0a 58 74 68 65 20 |2"}; thu|s,.Xthe |
|000018d0| 61 72 72 61 79 20 65 6c | 65 6d 65 6e 74 20 40 63 |array el|ement @c|
|000018e0| 6f 64 65 7b 66 6f 6f 5b | 22 35 40 40 31 32 22 5d |ode{foo[|"5@@12"]|
|000018f0| 7d 20 69 73 20 73 65 74 | 20 74 6f 20 40 63 6f 64 |} is set| to @cod|
|00001900| 65 7b 22 76 61 6c 75 65 | 22 7d 2e 0a 58 0a 58 4f |e{"value|"}..X.XO|
|00001910| 6e 63 65 20 74 68 65 20 | 65 6c 65 6d 65 6e 74 27 |nce the |element'|
|00001920| 73 20 76 61 6c 75 65 20 | 69 73 20 73 74 6f 72 65 |s value |is store|
|00001930| 64 2c 20 40 63 6f 64 65 | 7b 61 77 6b 7d 20 68 61 |d, @code|{awk} ha|
|00001940| 73 20 6e 6f 20 72 65 63 | 6f 72 64 20 6f 66 20 77 |s no rec|ord of w|
|00001950| 68 65 74 68 65 72 0a 58 | 69 74 20 77 61 73 20 73 |hether.X|it was s|
|00001960| 74 6f 72 65 64 20 77 69 | 74 68 20 61 20 73 69 6e |tored wi|th a sin|
|00001970| 67 6c 65 20 69 6e 64 65 | 78 20 6f 72 20 61 20 73 |gle inde|x or a s|
|00001980| 65 71 75 65 6e 63 65 20 | 6f 66 20 69 6e 64 69 63 |equence |of indic|
|00001990| 65 73 2e 20 20 54 68 65 | 20 74 77 6f 0a 58 65 78 |es. The| two.Xex|
|000019a0| 70 72 65 73 73 69 6f 6e | 73 20 40 63 6f 64 65 7b |pression|s @code{|
|000019b0| 66 6f 6f 5b 35 2c 31 32 | 5d 7d 20 61 6e 64 20 40 |foo[5,12|]} and @|
|000019c0| 77 7b 40 63 6f 64 65 7b | 66 6f 6f 5b 35 20 53 55 |w{@code{|foo[5 SU|
|000019d0| 42 53 45 50 20 31 32 5d | 7d 7d 20 61 6c 77 61 79 |BSEP 12]|}} alway|
|000019e0| 73 20 68 61 76 65 0a 58 | 74 68 65 20 73 61 6d 65 |s have.X|the same|
|000019f0| 20 76 61 6c 75 65 2e 0a | 58 0a 58 54 68 65 20 64 | value..|X.XThe d|
|00001a00| 65 66 61 75 6c 74 20 76 | 61 6c 75 65 20 6f 66 20 |efault v|alue of |
|00001a10| 40 63 6f 64 65 7b 53 55 | 42 53 45 50 7d 20 69 73 |@code{SU|BSEP} is|
|00001a20| 20 61 63 74 75 61 6c 6c | 79 20 74 68 65 20 73 74 | actuall|y the st|
|00001a30| 72 69 6e 67 20 40 63 6f | 64 65 7b 22 5c 30 33 34 |ring @co|de{"\034|
|00001a40| 22 7d 2c 0a 58 77 68 69 | 63 68 20 63 6f 6e 74 61 |"},.Xwhi|ch conta|
|00001a50| 69 6e 73 20 61 20 6e 6f | 6e 70 72 69 6e 74 69 6e |ins a no|nprintin|
|00001a60| 67 20 63 68 61 72 61 63 | 74 65 72 20 74 68 61 74 |g charac|ter that|
|00001a70| 20 69 73 20 75 6e 6c 69 | 6b 65 6c 79 20 74 6f 20 | is unli|kely to |
|00001a80| 61 70 70 65 61 72 20 69 | 6e 20 61 6e 0a 58 40 63 |appear i|n an.X@c|
|00001a90| 6f 64 65 7b 61 77 6b 7d | 20 70 72 6f 67 72 61 6d |ode{awk}| program|
|00001aa0| 20 6f 72 20 69 6e 20 74 | 68 65 20 69 6e 70 75 74 | or in t|he input|
|00001ab0| 20 64 61 74 61 2e 0a 58 | 0a 58 54 68 65 20 75 73 | data..X|.XThe us|
|00001ac0| 65 66 75 6c 6e 65 73 73 | 20 6f 66 20 63 68 6f 6f |efulness| of choo|
|00001ad0| 73 69 6e 67 20 61 6e 20 | 75 6e 6c 69 6b 65 6c 79 |sing an |unlikely|
|00001ae0| 20 63 68 61 72 61 63 74 | 65 72 20 63 6f 6d 65 73 | charact|er comes|
|00001af0| 20 66 72 6f 6d 20 74 68 | 65 20 66 61 63 74 0a 58 | from th|e fact.X|
|00001b00| 74 68 61 74 20 69 6e 64 | 65 78 20 76 61 6c 75 65 |that ind|ex value|
|00001b10| 73 20 74 68 61 74 20 63 | 6f 6e 74 61 69 6e 20 61 |s that c|ontain a|
|00001b20| 20 73 74 72 69 6e 67 20 | 6d 61 74 63 68 69 6e 67 | string |matching|
|00001b30| 20 40 63 6f 64 65 7b 53 | 55 42 53 45 50 7d 20 6c | @code{S|UBSEP} l|
|00001b40| 65 61 64 20 74 6f 0a 58 | 63 6f 6d 62 69 6e 65 64 |ead to.X|combined|
|00001b50| 20 73 74 72 69 6e 67 73 | 20 74 68 61 74 20 61 72 | strings| that ar|
|00001b60| 65 20 61 6d 62 69 67 75 | 6f 75 73 2e 20 20 53 75 |e ambigu|ous. Su|
|00001b70| 70 70 6f 73 65 20 74 68 | 61 74 20 40 63 6f 64 65 |ppose th|at @code|
|00001b80| 7b 53 55 42 53 45 50 7d | 20 77 65 72 65 0a 58 40 |{SUBSEP}| were.X@|
|00001b90| 63 6f 64 65 7b 22 40 40 | 22 7d 3b 20 74 68 65 6e |code{"@@|"}; then|
|00001ba0| 20 40 77 7b 40 63 6f 64 | 65 7b 66 6f 6f 5b 22 61 | @w{@cod|e{foo["a|
|00001bb0| 40 40 62 22 2c 20 22 63 | 22 5d 7d 7d 20 61 6e 64 |@@b", "c|"]}} and|
|00001bc0| 20 40 77 7b 40 63 6f 64 | 65 7b 66 6f 6f 5b 22 61 | @w{@cod|e{foo["a|
|00001bd0| 22 2c 0a 58 22 62 40 40 | 63 22 5d 7d 7d 20 77 6f |",.X"b@@|c"]}} wo|
|00001be0| 75 6c 64 20 62 65 20 69 | 6e 64 69 73 74 69 6e 67 |uld be i|ndisting|
|00001bf0| 75 69 73 68 61 62 6c 65 | 20 62 65 63 61 75 73 65 |uishable| because|
|00001c00| 20 62 6f 74 68 20 77 6f | 75 6c 64 20 61 63 74 75 | both wo|uld actu|
|00001c10| 61 6c 6c 79 20 62 65 0a | 58 73 74 6f 72 65 64 20 |ally be.|Xstored |
|00001c20| 61 73 20 40 63 6f 64 65 | 7b 66 6f 6f 5b 22 61 40 |as @code|{foo["a@|
|00001c30| 40 62 40 40 63 22 5d 7d | 2e 20 20 42 65 63 61 75 |@b@@c"]}|. Becau|
|00001c40| 73 65 20 40 63 6f 64 65 | 7b 53 55 42 53 45 50 7d |se @code|{SUBSEP}|
|00001c50| 20 69 73 0a 58 40 63 6f | 64 65 7b 22 5c 30 33 34 | is.X@co|de{"\034|
|00001c60| 22 7d 2c 20 73 75 63 68 | 20 63 6f 6e 66 75 73 69 |"}, such| confusi|
|00001c70| 6f 6e 20 63 61 6e 20 61 | 63 74 75 61 6c 6c 79 20 |on can a|ctually |
|00001c80| 68 61 70 70 65 6e 20 6f | 6e 6c 79 20 77 68 65 6e |happen o|nly when|
|00001c90| 20 61 6e 20 69 6e 64 65 | 78 0a 58 63 6f 6e 74 61 | an inde|x.Xconta|
|00001ca0| 69 6e 73 20 74 68 65 20 | 63 68 61 72 61 63 74 65 |ins the |characte|
|00001cb0| 72 20 77 69 74 68 20 41 | 53 43 49 49 20 63 6f 64 |r with A|SCII cod|
|00001cc0| 65 20 30 33 34 2c 20 77 | 68 69 63 68 20 69 73 20 |e 034, w|hich is |
|00001cd0| 61 20 72 61 72 65 0a 58 | 65 76 65 6e 74 2e 40 72 |a rare.X|event.@r|
|00001ce0| 65 66 69 6c 6c 0a 58 0a | 58 59 6f 75 20 63 61 6e |efill.X.|XYou can|
|00001cf0| 20 74 65 73 74 20 77 68 | 65 74 68 65 72 20 61 20 | test wh|ether a |
|00001d00| 70 61 72 74 69 63 75 6c | 61 72 20 69 6e 64 65 78 |particul|ar index|
|00001d10| 2d 73 65 71 75 65 6e 63 | 65 20 65 78 69 73 74 73 |-sequenc|e exists|
|00001d20| 20 69 6e 20 61 0a 58 60 | 60 6d 75 6c 74 69 2d 64 | in a.X`|`multi-d|
|00001d30| 69 6d 65 6e 73 69 6f 6e | 61 6c 27 27 20 61 72 72 |imension|al'' arr|
|00001d40| 61 79 20 77 69 74 68 20 | 74 68 65 20 73 61 6d 65 |ay with |the same|
|00001d50| 20 6f 70 65 72 61 74 6f | 72 20 40 63 6f 64 65 7b | operato|r @code{|
|00001d60| 69 6e 7d 20 75 73 65 64 | 20 66 6f 72 20 73 69 6e |in} used| for sin|
|00001d70| 67 6c 65 0a 58 64 69 6d | 65 6e 73 69 6f 6e 61 6c |gle.Xdim|ensional|
|00001d80| 20 61 72 72 61 79 73 2e | 20 20 49 6e 73 74 65 61 | arrays.| Instea|
|00001d90| 64 20 6f 66 20 61 20 73 | 69 6e 67 6c 65 20 69 6e |d of a s|ingle in|
|00001da0| 64 65 78 20 61 73 20 74 | 68 65 20 6c 65 66 74 2d |dex as t|he left-|
|00001db0| 68 61 6e 64 20 6f 70 65 | 72 61 6e 64 2c 0a 58 77 |hand ope|rand,.Xw|
|00001dc0| 72 69 74 65 20 74 68 65 | 20 77 68 6f 6c 65 20 73 |rite the| whole s|
|00001dd0| 65 71 75 65 6e 63 65 20 | 6f 66 20 69 6e 64 69 63 |equence |of indic|
|00001de0| 65 73 2c 20 73 65 70 61 | 72 61 74 65 64 20 62 79 |es, sepa|rated by|
|00001df0| 20 63 6f 6d 6d 61 73 2c | 20 69 6e 0a 58 70 61 72 | commas,| in.Xpar|
|00001e00| 65 6e 74 68 65 73 65 73 | 3a 40 72 65 66 69 6c 6c |entheses|:@refill|
|00001e10| 0a 58 0a 58 40 65 78 61 | 6d 70 6c 65 0a 58 28 40 |.X.X@exa|mple.X(@|
|00001e20| 76 61 72 7b 73 75 62 73 | 63 72 69 70 74 31 7d 2c |var{subs|cript1},|
|00001e30| 20 40 76 61 72 7b 73 75 | 62 73 63 72 69 70 74 32 | @var{su|bscript2|
|00001e40| 7d 2c 20 40 64 6f 74 73 | 7b 7d 29 20 69 6e 20 40 |}, @dots|{}) in @|
|00001e50| 76 61 72 7b 61 72 72 61 | 79 7d 0a 58 40 65 6e 64 |var{arra|y}.X@end|
|00001e60| 20 65 78 61 6d 70 6c 65 | 0a 58 0a 58 54 68 65 20 | example|.X.XThe |
|00001e70| 66 6f 6c 6c 6f 77 69 6e | 67 20 65 78 61 6d 70 6c |followin|g exampl|
|00001e80| 65 20 74 72 65 61 74 73 | 20 69 74 73 20 69 6e 70 |e treats| its inp|
|00001e90| 75 74 20 61 73 20 61 20 | 74 77 6f 2d 64 69 6d 65 |ut as a |two-dime|
|00001ea0| 6e 73 69 6f 6e 61 6c 20 | 61 72 72 61 79 20 6f 66 |nsional |array of|
|00001eb0| 0a 58 66 69 65 6c 64 73 | 3b 20 69 74 20 72 6f 74 |.Xfields|; it rot|
|00001ec0| 61 74 65 73 20 74 68 69 | 73 20 61 72 72 61 79 20 |ates thi|s array |
|00001ed0| 39 30 20 64 65 67 72 65 | 65 73 20 63 6c 6f 63 6b |90 degre|es clock|
|00001ee0| 77 69 73 65 20 61 6e 64 | 20 70 72 69 6e 74 73 20 |wise and| prints |
|00001ef0| 74 68 65 0a 58 72 65 73 | 75 6c 74 2e 20 20 49 74 |the.Xres|ult. It|
|00001f00| 20 61 73 73 75 6d 65 73 | 20 74 68 61 74 20 61 6c | assumes| that al|
|00001f10| 6c 20 6c 69 6e 65 73 20 | 68 61 76 65 20 74 68 65 |l lines |have the|
|00001f20| 20 73 61 6d 65 20 6e 75 | 6d 62 65 72 20 6f 66 0a | same nu|mber of.|
|00001f30| 58 65 6c 65 6d 65 6e 74 | 73 2e 0a 58 0a 58 40 65 |Xelement|s..X.X@e|
|00001f40| 78 61 6d 70 6c 65 0a 58 | 61 77 6b 20 27 40 7b 0a |xample.X|awk '@{.|
|00001f50| 58 20 20 20 20 20 69 66 | 20 28 6d 61 78 5f 6e 66 |X if| (max_nf|
|00001f60| 20 3c 20 4e 46 29 0a 58 | 20 20 20 20 20 20 20 20 | < NF).X| |
|00001f70| 20 20 6d 61 78 5f 6e 66 | 20 3d 20 4e 46 0a 58 20 | max_nf| = NF.X |
|00001f80| 20 20 20 20 6d 61 78 5f | 6e 72 20 3d 20 4e 52 0a | max_|nr = NR.|
|00001f90| 58 20 20 20 20 20 66 6f | 72 20 28 78 20 3d 20 31 |X fo|r (x = 1|
|00001fa0| 3b 20 78 20 3c 3d 20 4e | 46 3b 20 78 2b 2b 29 0a |; x <= N|F; x++).|
|00001fb0| 58 20 20 20 20 20 20 20 | 20 20 20 76 65 63 74 6f |X | vecto|
|00001fc0| 72 5b 78 2c 20 4e 52 5d | 20 3d 20 24 78 0a 58 40 |r[x, NR]| = $x.X@|
|00001fd0| 7d 0a 58 0a 58 45 4e 44 | 20 40 7b 0a 58 20 20 20 |}.X.XEND| @{.X |
|00001fe0| 20 20 66 6f 72 20 28 78 | 20 3d 20 31 3b 20 78 20 | for (x| = 1; x |
|00001ff0| 3c 3d 20 6d 61 78 5f 6e | 66 3b 20 78 2b 2b 29 20 |<= max_n|f; x++) |
|00002000| 40 7b 0a 58 20 20 20 20 | 20 20 20 20 20 20 66 6f |@{.X | fo|
|00002010| 72 20 28 79 20 3d 20 6d | 61 78 5f 6e 72 3b 20 79 |r (y = m|ax_nr; y|
|00002020| 20 3e 3d 20 31 3b 20 2d | 2d 79 29 0a 58 20 20 20 | >= 1; -|-y).X |
|00002030| 20 20 20 20 20 20 20 20 | 20 20 20 20 70 72 69 6e | | prin|
|00002040| 74 66 28 22 25 73 20 22 | 2c 20 76 65 63 74 6f 72 |tf("%s "|, vector|
|00002050| 5b 78 2c 20 79 5d 29 0a | 58 20 20 20 20 20 20 20 |[x, y]).|X |
|00002060| 20 20 20 70 72 69 6e 74 | 66 28 22 5c 6e 22 29 0a | print|f("\n").|
|00002070| 58 20 20 20 20 20 40 7d | 0a 58 40 7d 27 0a 58 40 |X @}|.X@}'.X@|
|00002080| 65 6e 64 20 65 78 61 6d | 70 6c 65 0a 58 0a 58 40 |end exam|ple.X.X@|
|00002090| 6e 6f 69 6e 64 65 6e 74 | 0a 58 57 68 65 6e 20 67 |noindent|.XWhen g|
|000020a0| 69 76 65 6e 20 74 68 65 | 20 69 6e 70 75 74 3a 0a |iven the| input:.|
|000020b0| 58 0a 58 40 65 78 61 6d | 70 6c 65 0a 58 31 20 32 |X.X@exam|ple.X1 2|
|000020c0| 20 33 20 34 20 35 20 36 | 0a 58 32 20 33 20 34 20 | 3 4 5 6|.X2 3 4 |
|000020d0| 35 20 36 20 31 0a 58 33 | 20 34 20 35 20 36 20 31 |5 6 1.X3| 4 5 6 1|
|000020e0| 20 32 0a 58 34 20 35 20 | 36 20 31 20 32 20 33 0a | 2.X4 5 |6 1 2 3.|
|000020f0| 58 40 65 6e 64 20 65 78 | 61 6d 70 6c 65 0a 58 0a |X@end ex|ample.X.|
|00002100| 58 40 6e 6f 69 6e 64 65 | 6e 74 0a 58 69 74 20 70 |X@noinde|nt.Xit p|
|00002110| 72 6f 64 75 63 65 73 3a | 0a 58 0a 58 40 65 78 61 |roduces:|.X.X@exa|
|00002120| 6d 70 6c 65 0a 58 34 20 | 33 20 32 20 31 0a 58 35 |mple.X4 |3 2 1.X5|
|00002130| 20 34 20 33 20 32 0a 58 | 36 20 35 20 34 20 33 0a | 4 3 2.X|6 5 4 3.|
|00002140| 58 31 20 36 20 35 20 34 | 0a 58 32 20 31 20 36 20 |X1 6 5 4|.X2 1 6 |
|00002150| 35 0a 58 33 20 32 20 31 | 20 36 0a 58 40 65 6e 64 |5.X3 2 1| 6.X@end|
|00002160| 20 65 78 61 6d 70 6c 65 | 0a 58 0a 58 40 6e 6f 64 | example|.X.X@nod|
|00002170| 65 20 4d 75 6c 74 69 2d | 73 63 61 6e 6e 69 6e 67 |e Multi-|scanning|
|00002180| 2c 20 2c 20 4d 75 6c 74 | 69 2d 64 69 6d 65 6e 73 |, , Mult|i-dimens|
|00002190| 69 6f 6e 61 6c 2c 20 41 | 72 72 61 79 73 0a 58 40 |ional, A|rrays.X@|
|000021a0| 73 65 63 74 69 6f 6e 20 | 53 63 61 6e 6e 69 6e 67 |section |Scanning|
|000021b0| 20 4d 75 6c 74 69 2d 64 | 69 6d 65 6e 73 69 6f 6e | Multi-d|imension|
|000021c0| 61 6c 20 41 72 72 61 79 | 73 0a 58 0a 58 54 68 65 |al Array|s.X.XThe|
|000021d0| 72 65 20 69 73 20 6e 6f | 20 73 70 65 63 69 61 6c |re is no| special|
|000021e0| 20 40 63 6f 64 65 7b 66 | 6f 72 7d 20 73 74 61 74 | @code{f|or} stat|
|000021f0| 65 6d 65 6e 74 20 66 6f | 72 20 73 63 61 6e 6e 69 |ement fo|r scanni|
|00002200| 6e 67 20 61 0a 58 60 60 | 6d 75 6c 74 69 2d 64 69 |ng a.X``|multi-di|
|00002210| 6d 65 6e 73 69 6f 6e 61 | 6c 27 27 20 61 72 72 61 |mensiona|l'' arra|
|00002220| 79 3b 20 74 68 65 72 65 | 20 63 61 6e 6e 6f 74 20 |y; there| cannot |
|00002230| 62 65 20 6f 6e 65 2c 20 | 62 65 63 61 75 73 65 20 |be one, |because |
|00002240| 69 6e 20 74 72 75 74 68 | 20 74 68 65 72 65 0a 58 |in truth| there.X|
|00002250| 61 72 65 20 6e 6f 20 6d | 75 6c 74 69 2d 64 69 6d |are no m|ulti-dim|
|00002260| 65 6e 73 69 6f 6e 61 6c | 20 61 72 72 61 79 73 20 |ensional| arrays |
|00002270| 6f 72 20 65 6c 65 6d 65 | 6e 74 73 3b 20 74 68 65 |or eleme|nts; the|
|00002280| 72 65 20 69 73 20 6f 6e | 6c 79 20 61 0a 58 6d 75 |re is on|ly a.Xmu|
|00002290| 6c 74 69 2d 64 69 6d 65 | 6e 73 69 6f 6e 61 6c 20 |lti-dime|nsional |
|000022a0| 40 65 6d 70 68 7b 77 61 | 79 20 6f 66 20 61 63 63 |@emph{wa|y of acc|
|000022b0| 65 73 73 69 6e 67 7d 20 | 61 6e 20 61 72 72 61 79 |essing} |an array|
|000022c0| 2e 0a 58 0a 58 48 6f 77 | 65 76 65 72 2c 20 69 66 |..X.XHow|ever, if|
|000022d0| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 68 61 | your pr|ogram ha|
|000022e0| 73 20 61 6e 20 61 72 72 | 61 79 20 74 68 61 74 20 |s an arr|ay that |
|000022f0| 69 73 20 61 6c 77 61 79 | 73 20 61 63 63 65 73 73 |is alway|s access|
|00002300| 65 64 20 61 73 0a 58 6d | 75 6c 74 69 2d 64 69 6d |ed as.Xm|ulti-dim|
|00002310| 65 6e 73 69 6f 6e 61 6c | 2c 20 79 6f 75 20 63 61 |ensional|, you ca|
|00002320| 6e 20 67 65 74 20 74 68 | 65 20 65 66 66 65 63 74 |n get th|e effect|
|00002330| 20 6f 66 20 73 63 61 6e | 6e 69 6e 67 20 69 74 20 | of scan|ning it |
|00002340| 62 79 20 63 6f 6d 62 69 | 6e 69 6e 67 0a 58 74 68 |by combi|ning.Xth|
|00002350| 65 20 73 63 61 6e 6e 69 | 6e 67 20 40 63 6f 64 65 |e scanni|ng @code|
|00002360| 7b 66 6f 72 7d 20 73 74 | 61 74 65 6d 65 6e 74 20 |{for} st|atement |
|00002370| 28 40 70 78 72 65 66 7b | 53 63 61 6e 6e 69 6e 67 |(@pxref{|Scanning|
|00002380| 20 61 6e 20 41 72 72 61 | 79 7d 29 20 77 69 74 68 | an Arra|y}) with|
|00002390| 20 74 68 65 0a 58 40 63 | 6f 64 65 7b 73 70 6c 69 | the.X@c|ode{spli|
|000023a0| 74 7d 20 62 75 69 6c 74 | 2d 69 6e 20 66 75 6e 63 |t} built|-in func|
|000023b0| 74 69 6f 6e 20 28 40 70 | 78 72 65 66 7b 53 74 72 |tion (@p|xref{Str|
|000023c0| 69 6e 67 20 46 75 6e 63 | 74 69 6f 6e 73 7d 29 2e |ing Func|tions}).|
|000023d0| 20 20 49 74 20 77 6f 72 | 6b 73 0a 58 6c 69 6b 65 | It wor|ks.Xlike|
|000023e0| 20 74 68 69 73 3a 0a 58 | 0a 58 40 65 78 61 6d 70 | this:.X|.X@examp|
|000023f0| 6c 65 0a 58 66 6f 72 20 | 28 63 6f 6d 62 69 6e 65 |le.Xfor |(combine|
|00002400| 64 20 69 6e 20 40 76 61 | 72 7b 61 72 72 61 79 7d |d in @va|r{array}|
|00002410| 29 20 40 7b 0a 58 20 20 | 73 70 6c 69 74 28 63 6f |) @{.X |split(co|
|00002420| 6d 62 69 6e 65 64 2c 20 | 73 65 70 61 72 61 74 65 |mbined, |separate|
|00002430| 2c 20 53 55 42 53 45 50 | 29 0a 58 20 20 40 64 6f |, SUBSEP|).X @do|
|00002440| 74 73 7b 7d 0a 58 40 7d | 0a 58 40 65 6e 64 20 65 |ts{}.X@}|.X@end e|
|00002450| 78 61 6d 70 6c 65 0a 58 | 0a 58 40 6e 6f 69 6e 64 |xample.X|.X@noind|
|00002460| 65 6e 74 0a 58 54 68 69 | 73 20 66 69 6e 64 73 20 |ent.XThi|s finds |
|00002470| 65 61 63 68 20 63 6f 6e | 63 61 74 65 6e 61 74 65 |each con|catenate|
|00002480| 64 2c 20 63 6f 6d 62 69 | 6e 65 64 20 69 6e 64 65 |d, combi|ned inde|
|00002490| 78 20 69 6e 20 74 68 65 | 20 61 72 72 61 79 2c 20 |x in the| array, |
|000024a0| 61 6e 64 20 73 70 6c 69 | 74 73 20 69 74 0a 58 69 |and spli|ts it.Xi|
|000024b0| 6e 74 6f 20 74 68 65 20 | 69 6e 64 69 76 69 64 75 |nto the |individu|
|000024c0| 61 6c 20 69 6e 64 69 63 | 65 73 20 62 79 20 62 72 |al indic|es by br|
|000024d0| 65 61 6b 69 6e 67 20 69 | 74 20 61 70 61 72 74 20 |eaking i|t apart |
|000024e0| 77 68 65 72 65 20 74 68 | 65 20 76 61 6c 75 65 20 |where th|e value |
|000024f0| 6f 66 0a 58 40 63 6f 64 | 65 7b 53 55 42 53 45 50 |of.X@cod|e{SUBSEP|
|00002500| 7d 20 61 70 70 65 61 72 | 73 2e 20 20 54 68 65 20 |} appear|s. The |
|00002510| 73 70 6c 69 74 2d 6f 75 | 74 20 69 6e 64 69 63 65 |split-ou|t indice|
|00002520| 73 20 62 65 63 6f 6d 65 | 20 74 68 65 20 65 6c 65 |s become| the ele|
|00002530| 6d 65 6e 74 73 20 6f 66 | 0a 58 74 68 65 20 61 72 |ments of|.Xthe ar|
|00002540| 72 61 79 20 40 63 6f 64 | 65 7b 73 65 70 61 72 61 |ray @cod|e{separa|
|00002550| 74 65 7d 2e 0a 58 0a 58 | 54 68 75 73 2c 20 73 75 |te}..X.X|Thus, su|
|00002560| 70 70 6f 73 65 20 79 6f | 75 20 68 61 76 65 20 70 |ppose yo|u have p|
|00002570| 72 65 76 69 6f 75 73 6c | 79 20 73 74 6f 72 65 64 |reviousl|y stored|
|00002580| 20 69 6e 20 40 63 6f 64 | 65 7b 40 76 61 72 7b 61 | in @cod|e{@var{a|
|00002590| 72 72 61 79 7d 5b 31 2c | 0a 58 22 66 6f 6f 22 5d |rray}[1,|.X"foo"]|
|000025a0| 7d 3b 20 74 68 65 6e 20 | 61 6e 20 65 6c 65 6d 65 |}; then |an eleme|
|000025b0| 6e 74 20 77 69 74 68 20 | 69 6e 64 65 78 20 40 63 |nt with |index @c|
|000025c0| 6f 64 65 7b 22 31 5c 30 | 33 34 66 6f 6f 22 7d 20 |ode{"1\0|34foo"} |
|000025d0| 65 78 69 73 74 73 20 69 | 6e 0a 58 40 76 61 72 7b |exists i|n.X@var{|
|000025e0| 61 72 72 61 79 7d 2e 20 | 20 28 52 65 63 61 6c 6c |array}. | (Recall|
|000025f0| 20 74 68 61 74 20 74 68 | 65 20 64 65 66 61 75 6c | that th|e defaul|
|00002600| 74 20 76 61 6c 75 65 20 | 6f 66 20 40 63 6f 64 65 |t value |of @code|
|00002610| 7b 53 55 42 53 45 50 7d | 20 63 6f 6e 74 61 69 6e |{SUBSEP}| contain|
|00002620| 73 0a 58 74 68 65 20 63 | 68 61 72 61 63 74 65 72 |s.Xthe c|haracter|
|00002630| 20 77 69 74 68 20 63 6f | 64 65 20 30 33 34 2e 29 | with co|de 034.)|
|00002640| 20 20 53 6f 6f 6e 65 72 | 20 6f 72 20 6c 61 74 65 | Sooner| or late|
|00002650| 72 20 74 68 65 20 40 63 | 6f 64 65 7b 66 6f 72 7d |r the @c|ode{for}|
|00002660| 20 73 74 61 74 65 6d 65 | 6e 74 0a 58 77 69 6c 6c | stateme|nt.Xwill|
|00002670| 20 66 69 6e 64 20 74 68 | 61 74 20 69 6e 64 65 78 | find th|at index|
|00002680| 20 61 6e 64 20 64 6f 20 | 61 6e 20 69 74 65 72 61 | and do |an itera|
|00002690| 74 69 6f 6e 20 77 69 74 | 68 20 40 63 6f 64 65 7b |tion wit|h @code{|
|000026a0| 63 6f 6d 62 69 6e 65 64 | 7d 20 73 65 74 20 74 6f |combined|} set to|
|000026b0| 0a 58 40 63 6f 64 65 7b | 22 31 5c 30 33 34 66 6f |.X@code{|"1\034fo|
|000026c0| 6f 22 7d 2e 20 20 54 68 | 65 6e 20 74 68 65 20 40 |o"}. Th|en the @|
|000026d0| 63 6f 64 65 7b 73 70 6c | 69 74 7d 20 66 75 6e 63 |code{spl|it} func|
|000026e0| 74 69 6f 6e 20 69 73 20 | 63 61 6c 6c 65 64 20 61 |tion is |called a|
|000026f0| 73 0a 58 66 6f 6c 6c 6f | 77 73 3a 0a 58 0a 58 40 |s.Xfollo|ws:.X.X@|
|00002700| 65 78 61 6d 70 6c 65 0a | 58 73 70 6c 69 74 28 22 |example.|Xsplit("|
|00002710| 31 5c 30 33 34 66 6f 6f | 22 2c 20 73 65 70 61 72 |1\034foo|", separ|
|00002720| 61 74 65 2c 20 22 5c 30 | 33 34 22 29 0a 58 40 65 |ate, "\0|34").X@e|
|00002730| 6e 64 20 65 78 61 6d 70 | 6c 65 0a 58 0a 58 40 6e |nd examp|le.X.X@n|
|00002740| 6f 69 6e 64 65 6e 74 0a | 58 54 68 65 20 72 65 73 |oindent.|XThe res|
|00002750| 75 6c 74 20 6f 66 20 74 | 68 69 73 20 69 73 20 74 |ult of t|his is t|
|00002760| 6f 20 73 65 74 20 40 63 | 6f 64 65 7b 73 65 70 61 |o set @c|ode{sepa|
|00002770| 72 61 74 65 5b 31 5d 7d | 20 74 6f 20 31 20 61 6e |rate[1]}| to 1 an|
|00002780| 64 20 40 63 6f 64 65 7b | 73 65 70 61 72 61 74 65 |d @code{|separate|
|00002790| 5b 32 5d 7d 0a 58 74 6f | 20 40 63 6f 64 65 7b 22 |[2]}.Xto| @code{"|
|000027a0| 66 6f 6f 22 7d 2e 20 20 | 50 72 65 73 74 6f 2c 20 |foo"}. |Presto, |
|000027b0| 74 68 65 20 6f 72 69 67 | 69 6e 61 6c 20 73 65 71 |the orig|inal seq|
|000027c0| 75 65 6e 63 65 20 6f 66 | 20 73 65 70 61 72 61 74 |uence of| separat|
|000027d0| 65 20 69 6e 64 69 63 65 | 73 20 68 61 73 0a 58 62 |e indice|s has.Xb|
|000027e0| 65 65 6e 20 72 65 63 6f | 76 65 72 65 64 2e 0a 58 |een reco|vered..X|
|000027f0| 0a 58 40 6e 6f 64 65 20 | 42 75 69 6c 74 2d 69 6e |.X@node |Built-in|
|00002800| 2c 20 55 73 65 72 2d 64 | 65 66 69 6e 65 64 2c 20 |, User-d|efined, |
|00002810| 41 72 72 61 79 73 2c 20 | 54 6f 70 0a 58 40 63 68 |Arrays, |Top.X@ch|
|00002820| 61 70 74 65 72 20 42 75 | 69 6c 74 2d 69 6e 20 46 |apter Bu|ilt-in F|
|00002830| 75 6e 63 74 69 6f 6e 73 | 0a 58 0a 58 40 63 69 6e |unctions|.X.X@cin|
|00002840| 64 65 78 20 62 75 69 6c | 74 2d 69 6e 20 66 75 6e |dex buil|t-in fun|
|00002850| 63 74 69 6f 6e 73 0a 58 | 40 64 66 6e 7b 42 75 69 |ctions.X|@dfn{Bui|
|00002860| 6c 74 2d 69 6e 7d 20 66 | 75 6e 63 74 69 6f 6e 73 |lt-in} f|unctions|
|00002870| 20 61 72 65 20 66 75 6e | 63 74 69 6f 6e 73 20 74 | are fun|ctions t|
|00002880| 68 61 74 20 61 72 65 20 | 61 6c 77 61 79 73 20 61 |hat are |always a|
|00002890| 76 61 69 6c 61 62 6c 65 | 20 66 6f 72 0a 58 79 6f |vailable| for.Xyo|
|000028a0| 75 72 20 40 63 6f 64 65 | 7b 61 77 6b 7d 20 70 72 |ur @code|{awk} pr|
|000028b0| 6f 67 72 61 6d 20 74 6f | 20 63 61 6c 6c 2e 20 20 |ogram to| call. |
|000028c0| 54 68 69 73 20 63 68 61 | 70 74 65 72 20 64 65 66 |This cha|pter def|
|000028d0| 69 6e 65 73 20 61 6c 6c | 20 74 68 65 20 62 75 69 |ines all| the bui|
|000028e0| 6c 74 2d 69 6e 0a 58 66 | 75 6e 63 74 69 6f 6e 73 |lt-in.Xf|unctions|
|000028f0| 20 69 6e 20 40 63 6f 64 | 65 7b 61 77 6b 7d 3b 20 | in @cod|e{awk}; |
|00002900| 73 6f 6d 65 20 6f 66 20 | 74 68 65 6d 20 61 72 65 |some of |them are|
|00002910| 20 6d 65 6e 74 69 6f 6e | 65 64 20 69 6e 20 6f 74 | mention|ed in ot|
|00002920| 68 65 72 20 73 65 63 74 | 69 6f 6e 73 2c 0a 58 62 |her sect|ions,.Xb|
|00002930| 75 74 20 74 68 65 79 20 | 61 72 65 20 73 75 6d 6d |ut they |are summ|
|00002940| 61 72 69 7a 65 64 20 68 | 65 72 65 20 66 6f 72 20 |arized h|ere for |
|00002950| 79 6f 75 72 20 63 6f 6e | 76 65 6e 69 65 6e 63 65 |your con|venience|
|00002960| 2e 20 20 28 59 6f 75 20 | 63 61 6e 20 61 6c 73 6f |. (You |can also|
|00002970| 20 64 65 66 69 6e 65 0a | 58 6e 65 77 20 66 75 6e | define.|Xnew fun|
|00002980| 63 74 69 6f 6e 73 20 79 | 6f 75 72 73 65 6c 66 2e |ctions y|ourself.|
|00002990| 20 20 40 78 72 65 66 7b | 55 73 65 72 2d 64 65 66 | @xref{|User-def|
|000029a0| 69 6e 65 64 7d 2e 29 0a | 58 0a 58 40 6d 65 6e 75 |ined}.).|X.X@menu|
|000029b0| 0a 58 2a 20 43 61 6c 6c | 69 6e 67 20 42 75 69 6c |.X* Call|ing Buil|
|000029c0| 74 2d 69 6e 3a 3a 20 20 | 20 48 6f 77 20 74 6f 20 |t-in:: | How to |
|000029d0| 63 61 6c 6c 20 62 75 69 | 6c 74 2d 69 6e 20 66 75 |call bui|lt-in fu|
|000029e0| 6e 63 74 69 6f 6e 73 2e | 0a 58 0a 58 2a 20 4e 75 |nctions.|.X.X* Nu|
|000029f0| 6d 65 72 69 63 20 46 75 | 6e 63 74 69 6f 6e 73 3a |meric Fu|nctions:|
|00002a00| 3a 20 20 46 75 6e 63 74 | 69 6f 6e 73 20 74 68 61 |: Funct|ions tha|
|00002a10| 74 20 77 6f 72 6b 20 77 | 69 74 68 20 6e 75 6d 62 |t work w|ith numb|
|00002a20| 65 72 73 2c 0a 58 20 20 | 20 20 20 20 20 20 20 20 |ers,.X | |
|00002a30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 69 6e 63 | | inc|
|00002a40| 6c 75 64 69 6e 67 20 40 | 63 6f 64 65 7b 69 6e 74 |luding @|code{int|
|00002a50| 7d 2c 20 40 63 6f 64 65 | 7b 73 69 6e 7d 20 61 6e |}, @code|{sin} an|
|00002a60| 64 20 40 63 6f 64 65 7b | 72 61 6e 64 7d 2e 0a 58 |d @code{|rand}..X|
|00002a70| 0a 58 2a 20 53 74 72 69 | 6e 67 20 46 75 6e 63 74 |.X* Stri|ng Funct|
|00002a80| 69 6f 6e 73 3a 3a 20 20 | 20 46 75 6e 63 74 69 6f |ions:: | Functio|
|00002a90| 6e 73 20 66 6f 72 20 73 | 74 72 69 6e 67 20 6d 61 |ns for s|tring ma|
|00002aa0| 6e 69 70 75 6c 61 74 69 | 6f 6e 2c 0a 58 20 20 20 |nipulati|on,.X |
|00002ab0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002ac0| 20 20 20 20 73 75 63 68 | 20 61 73 20 40 63 6f 64 | such| as @cod|
|00002ad0| 65 7b 73 70 6c 69 74 7d | 2c 20 40 63 6f 64 65 7b |e{split}|, @code{|
|00002ae0| 6d 61 74 63 68 7d 2c 20 | 61 6e 64 20 40 63 6f 64 |match}, |and @cod|
|00002af0| 65 7b 73 70 72 69 6e 74 | 66 7d 2e 0a 58 0a 58 2a |e{sprint|f}..X.X*|
|00002b00| 20 49 2f 4f 20 46 75 6e | 63 74 69 6f 6e 73 3a 3a | I/O Fun|ctions::|
|00002b10| 20 20 20 20 20 20 46 75 | 6e 63 74 69 6f 6e 73 20 | Fu|nctions |
|00002b20| 66 6f 72 20 66 69 6c 65 | 73 20 61 6e 64 20 73 68 |for file|s and sh|
|00002b30| 65 6c 6c 20 63 6f 6d 6d | 61 6e 64 73 0a 58 40 65 |ell comm|ands.X@e|
|00002b40| 6e 64 20 6d 65 6e 75 0a | 58 0a 58 40 6e 6f 64 65 |nd menu.|X.X@node|
|00002b50| 20 43 61 6c 6c 69 6e 67 | 20 42 75 69 6c 74 2d 69 | Calling| Built-i|
|00002b60| 6e 2c 20 4e 75 6d 65 72 | 69 63 20 46 75 6e 63 74 |n, Numer|ic Funct|
|00002b70| 69 6f 6e 73 2c 20 42 75 | 69 6c 74 2d 69 6e 2c 20 |ions, Bu|ilt-in, |
|00002b80| 42 75 69 6c 74 2d 69 6e | 0a 58 40 73 65 63 74 69 |Built-in|.X@secti|
|00002b90| 6f 6e 20 43 61 6c 6c 69 | 6e 67 20 42 75 69 6c 74 |on Calli|ng Built|
|00002ba0| 2d 69 6e 20 46 75 6e 63 | 74 69 6f 6e 73 0a 58 0a |-in Func|tions.X.|
|00002bb0| 58 54 6f 20 63 61 6c 6c | 20 61 20 62 75 69 6c 74 |XTo call| a built|
|00002bc0| 2d 69 6e 20 66 75 6e 63 | 74 69 6f 6e 2c 20 77 72 |-in func|tion, wr|
|00002bd0| 69 74 65 20 74 68 65 20 | 6e 61 6d 65 20 6f 66 20 |ite the |name of |
|00002be0| 74 68 65 20 66 75 6e 63 | 74 69 6f 6e 20 66 6f 6c |the func|tion fol|
|00002bf0| 6c 6f 77 65 64 0a 58 62 | 79 20 61 72 67 75 6d 65 |lowed.Xb|y argume|
|00002c00| 6e 74 73 20 69 6e 20 70 | 61 72 65 6e 74 68 65 73 |nts in p|arenthes|
|00002c10| 65 73 2e 20 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |es. For| example|
|00002c20| 2c 20 40 63 6f 64 65 7b | 61 74 61 6e 32 28 79 20 |, @code{|atan2(y |
|00002c30| 2b 20 7a 2c 20 31 29 7d | 0a 58 69 73 20 61 20 63 |+ z, 1)}|.Xis a c|
|00002c40| 61 6c 6c 20 74 6f 20 74 | 68 65 20 66 75 6e 63 74 |all to t|he funct|
|00002c50| 69 6f 6e 20 40 63 6f 64 | 65 7b 61 74 61 6e 32 7d |ion @cod|e{atan2}|
|00002c60| 2c 20 77 69 74 68 20 74 | 77 6f 20 61 72 67 75 6d |, with t|wo argum|
|00002c70| 65 6e 74 73 2e 0a 58 0a | 58 57 68 69 74 65 73 70 |ents..X.|XWhitesp|
|00002c80| 61 63 65 20 69 73 20 69 | 67 6e 6f 72 65 64 20 62 |ace is i|gnored b|
|00002c90| 65 74 77 65 65 6e 20 74 | 68 65 20 62 75 69 6c 74 |etween t|he built|
|00002ca0| 2d 69 6e 20 66 75 6e 63 | 74 69 6f 6e 20 6e 61 6d |-in func|tion nam|
|00002cb0| 65 20 61 6e 64 20 74 68 | 65 0a 58 6f 70 65 6e 2d |e and th|e.Xopen-|
|00002cc0| 70 61 72 65 6e 74 68 65 | 73 69 73 2c 20 62 75 74 |parenthe|sis, but|
|00002cd0| 20 77 65 20 72 65 63 6f | 6d 6d 65 6e 64 20 74 68 | we reco|mmend th|
|00002ce0| 61 74 20 79 6f 75 20 61 | 76 6f 69 64 20 75 73 69 |at you a|void usi|
|00002cf0| 6e 67 20 77 68 69 74 65 | 73 70 61 63 65 0a 58 74 |ng white|space.Xt|
|00002d00| 68 65 72 65 2e 20 20 55 | 73 65 72 2d 64 65 66 69 |here. U|ser-defi|
|00002d10| 6e 65 64 20 66 75 6e 63 | 74 69 6f 6e 73 20 64 6f |ned func|tions do|
|00002d20| 20 6e 6f 74 20 70 65 72 | 6d 69 74 20 77 68 69 74 | not per|mit whit|
|00002d30| 65 73 70 61 63 65 20 69 | 6e 20 74 68 69 73 20 77 |espace i|n this w|
|00002d40| 61 79 2c 20 61 6e 64 0a | 58 79 6f 75 20 77 69 6c |ay, and.|Xyou wil|
|00002d50| 6c 20 66 69 6e 64 20 69 | 74 20 65 61 73 69 65 72 |l find i|t easier|
|00002d60| 20 74 6f 20 61 76 6f 69 | 64 20 6d 69 73 74 61 6b | to avoi|d mistak|
|00002d70| 65 73 20 62 79 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |es by fo|llowing |
|00002d80| 61 20 73 69 6d 70 6c 65 | 0a 58 63 6f 6e 76 65 6e |a simple|.Xconven|
|00002d90| 74 69 6f 6e 20 77 68 69 | 63 68 20 61 6c 77 61 79 |tion whi|ch alway|
|00002da0| 73 20 77 6f 72 6b 73 3a | 20 6e 6f 20 77 68 69 74 |s works:| no whit|
|00002db0| 65 73 70 61 63 65 20 61 | 66 74 65 72 20 61 20 66 |espace a|fter a f|
|00002dc0| 75 6e 63 74 69 6f 6e 20 | 6e 61 6d 65 2e 0a 58 0a |unction |name..X.|
|00002dd0| 58 45 61 63 68 20 62 75 | 69 6c 74 2d 69 6e 20 66 |XEach bu|ilt-in f|
|00002de0| 75 6e 63 74 69 6f 6e 20 | 61 63 63 65 70 74 73 20 |unction |accepts |
|00002df0| 61 20 63 65 72 74 61 69 | 6e 20 6e 75 6d 62 65 72 |a certai|n number|
|00002e00| 20 6f 66 20 61 72 67 75 | 6d 65 6e 74 73 2e 20 20 | of argu|ments. |
|00002e10| 49 6e 20 6d 6f 73 74 0a | 58 63 61 73 65 73 2c 20 |In most.|Xcases, |
|00002e20| 61 6e 79 20 65 78 74 72 | 61 20 61 72 67 75 6d 65 |any extr|a argume|
|00002e30| 6e 74 73 20 67 69 76 65 | 6e 20 74 6f 20 62 75 69 |nts give|n to bui|
|00002e40| 6c 74 2d 69 6e 20 66 75 | 6e 63 74 69 6f 6e 73 20 |lt-in fu|nctions |
|00002e50| 61 72 65 20 69 67 6e 6f | 72 65 64 2e 20 20 54 68 |are igno|red. Th|
|00002e60| 65 0a 58 64 65 66 61 75 | 6c 74 73 20 66 6f 72 20 |e.Xdefau|lts for |
|00002e70| 6f 6d 69 74 74 65 64 20 | 61 72 67 75 6d 65 6e 74 |omitted |argument|
|00002e80| 73 20 76 61 72 79 20 66 | 72 6f 6d 20 66 75 6e 63 |s vary f|rom func|
|00002e90| 74 69 6f 6e 20 74 6f 20 | 66 75 6e 63 74 69 6f 6e |tion to |function|
|00002ea0| 20 61 6e 64 20 61 72 65 | 0a 58 64 65 73 63 72 69 | and are|.Xdescri|
|00002eb0| 62 65 64 20 75 6e 64 65 | 72 20 74 68 65 20 69 6e |bed unde|r the in|
|00002ec0| 64 69 76 69 64 75 61 6c | 20 66 75 6e 63 74 69 6f |dividual| functio|
|00002ed0| 6e 73 2e 0a 58 0a 58 57 | 68 65 6e 20 61 20 66 75 |ns..X.XW|hen a fu|
|00002ee0| 6e 63 74 69 6f 6e 20 69 | 73 20 63 61 6c 6c 65 64 |nction i|s called|
|00002ef0| 2c 20 65 78 70 72 65 73 | 73 69 6f 6e 73 20 74 68 |, expres|sions th|
|00002f00| 61 74 20 63 72 65 61 74 | 65 20 74 68 65 20 66 75 |at creat|e the fu|
|00002f10| 6e 63 74 69 6f 6e 27 73 | 20 61 63 74 75 61 6c 0a |nction's| actual.|
|00002f20| 58 70 61 72 61 6d 65 74 | 65 72 73 20 61 72 65 20 |Xparamet|ers are |
|00002f30| 65 76 61 6c 75 61 74 65 | 64 20 63 6f 6d 70 6c 65 |evaluate|d comple|
|00002f40| 74 65 6c 79 20 62 65 66 | 6f 72 65 20 74 68 65 20 |tely bef|ore the |
|00002f50| 66 75 6e 63 74 69 6f 6e | 20 63 61 6c 6c 20 69 73 |function| call is|
|00002f60| 20 70 65 72 66 6f 72 6d | 65 64 2e 0a 58 46 6f 72 | perform|ed..XFor|
|00002f70| 20 65 78 61 6d 70 6c 65 | 2c 20 69 6e 20 74 68 65 | example|, in the|
|00002f80| 20 63 6f 64 65 20 66 72 | 61 67 6d 65 6e 74 3a 0a | code fr|agment:.|
|00002f90| 58 0a 58 40 65 78 61 6d | 70 6c 65 0a 58 69 20 3d |X.X@exam|ple.Xi =|
|00002fa0| 20 34 0a 58 6a 20 3d 20 | 73 71 72 74 28 69 2b 2b | 4.Xj = |sqrt(i++|
|00002fb0| 29 0a 58 40 65 6e 64 20 | 65 78 61 6d 70 6c 65 0a |).X@end |example.|
|00002fc0| 58 0a 58 40 6e 6f 69 6e | 64 65 6e 74 0a 58 74 68 |X.X@noin|dent.Xth|
|00002fd0| 65 20 76 61 72 69 61 62 | 6c 65 20 40 63 6f 64 65 |e variab|le @code|
|00002fe0| 7b 69 7d 20 69 73 20 73 | 65 74 20 74 6f 20 35 20 |{i} is s|et to 5 |
|00002ff0| 62 65 66 6f 72 65 20 40 | 63 6f 64 65 7b 73 71 72 |before @|code{sqr|
|00003000| 74 7d 20 69 73 20 63 61 | 6c 6c 65 64 0a 58 77 69 |t} is ca|lled.Xwi|
|00003010| 74 68 20 61 20 76 61 6c | 75 65 20 6f 66 20 34 20 |th a val|ue of 4 |
|00003020| 66 6f 72 20 69 74 73 20 | 61 63 74 75 61 6c 20 70 |for its |actual p|
|00003030| 61 72 61 6d 65 74 65 72 | 2e 0a 58 0a 58 40 6e 6f |arameter|..X.X@no|
|00003040| 64 65 20 4e 75 6d 65 72 | 69 63 20 46 75 6e 63 74 |de Numer|ic Funct|
|00003050| 69 6f 6e 73 2c 20 53 74 | 72 69 6e 67 20 46 75 6e |ions, St|ring Fun|
|00003060| 63 74 69 6f 6e 73 2c 20 | 43 61 6c 6c 69 6e 67 20 |ctions, |Calling |
|00003070| 42 75 69 6c 74 2d 69 6e | 2c 20 42 75 69 6c 74 2d |Built-in|, Built-|
|00003080| 69 6e 0a 58 40 73 65 63 | 74 69 6f 6e 20 4e 75 6d |in.X@sec|tion Num|
|00003090| 65 72 69 63 20 42 75 69 | 6c 74 2d 69 6e 20 46 75 |eric Bui|lt-in Fu|
|000030a0| 6e 63 74 69 6f 6e 73 0a | 58 0a 58 48 65 72 65 20 |nctions.|X.XHere |
|000030b0| 69 73 20 61 20 66 75 6c | 6c 20 6c 69 73 74 20 6f |is a ful|l list o|
|000030c0| 66 20 62 75 69 6c 74 2d | 69 6e 20 66 75 6e 63 74 |f built-|in funct|
|000030d0| 69 6f 6e 73 20 74 68 61 | 74 20 77 6f 72 6b 20 77 |ions tha|t work w|
|000030e0| 69 74 68 20 6e 75 6d 62 | 65 72 73 3a 0a 58 0a 58 |ith numb|ers:.X.X|
|000030f0| 40 74 61 62 6c 65 20 40 | 63 6f 64 65 0a 58 40 69 |@table @|code.X@i|
|00003100| 74 65 6d 20 69 6e 74 28 | 40 76 61 72 7b 78 7d 29 |tem int(|@var{x})|
|00003110| 0a 58 54 68 69 73 20 67 | 69 76 65 73 20 79 6f 75 |.XThis g|ives you|
|00003120| 20 74 68 65 20 69 6e 74 | 65 67 65 72 20 70 61 72 | the int|eger par|
|00003130| 74 20 6f 66 20 40 76 61 | 72 7b 78 7d 2c 20 74 72 |t of @va|r{x}, tr|
|00003140| 75 6e 63 61 74 65 64 20 | 74 6f 77 61 72 64 20 30 |uncated |toward 0|
|00003150| 2e 20 20 54 68 69 73 0a | 58 70 72 6f 64 75 63 65 |. This.|Xproduce|
|00003160| 73 20 74 68 65 20 6e 65 | 61 72 65 73 74 20 69 6e |s the ne|arest in|
|00003170| 74 65 67 65 72 20 74 6f | 20 40 76 61 72 7b 78 7d |teger to| @var{x}|
|00003180| 2c 20 6c 6f 63 61 74 65 | 64 20 62 65 74 77 65 65 |, locate|d betwee|
|00003190| 6e 20 40 76 61 72 7b 78 | 7d 20 61 6e 64 20 30 2e |n @var{x|} and 0.|
|000031a0| 0a 58 0a 58 46 6f 72 20 | 65 78 61 6d 70 6c 65 2c |.X.XFor |example,|
|000031b0| 20 40 63 6f 64 65 7b 69 | 6e 74 28 33 29 7d 20 69 | @code{i|nt(3)} i|
|000031c0| 73 20 33 2c 20 40 63 6f | 64 65 7b 69 6e 74 28 33 |s 3, @co|de{int(3|
|000031d0| 2e 39 29 7d 20 69 73 20 | 33 2c 20 40 63 6f 64 65 |.9)} is |3, @code|
|000031e0| 7b 69 6e 74 28 2d 33 2e | 39 29 7d 0a 58 69 73 20 |{int(-3.|9)}.Xis |
|000031f0| 40 6d 69 6e 75 73 7b 7d | 33 2c 20 61 6e 64 20 40 |@minus{}|3, and @|
|00003200| 63 6f 64 65 7b 69 6e 74 | 28 2d 33 29 7d 20 69 73 |code{int|(-3)} is|
|00003210| 20 40 6d 69 6e 75 73 7b | 7d 33 20 61 73 20 77 65 | @minus{|}3 as we|
|00003220| 6c 6c 2e 40 72 65 66 69 | 6c 6c 0a 58 0a 58 40 69 |ll.@refi|ll.X.X@i|
|00003230| 74 65 6d 20 73 71 72 74 | 28 40 76 61 72 7b 78 7d |tem sqrt|(@var{x}|
|00003240| 29 0a 58 54 68 69 73 20 | 67 69 76 65 73 20 79 6f |).XThis |gives yo|
|00003250| 75 20 74 68 65 20 70 6f | 73 69 74 69 76 65 20 73 |u the po|sitive s|
|00003260| 71 75 61 72 65 20 72 6f | 6f 74 20 6f 66 20 40 76 |quare ro|ot of @v|
|00003270| 61 72 7b 78 7d 2e 20 20 | 49 74 20 72 65 70 6f 72 |ar{x}. |It repor|
|00003280| 74 73 20 61 6e 20 65 72 | 72 6f 72 0a 58 69 66 20 |ts an er|ror.Xif |
|00003290| 40 76 61 72 7b 78 7d 20 | 69 73 20 6e 65 67 61 74 |@var{x} |is negat|
|000032a0| 69 76 65 2e 20 20 54 68 | 75 73 2c 20 40 63 6f 64 |ive. Th|us, @cod|
|000032b0| 65 7b 73 71 72 74 28 34 | 29 7d 20 69 73 20 32 2e |e{sqrt(4|)} is 2.|
|000032c0| 40 72 65 66 69 6c 6c 0a | 58 0a 58 40 69 74 65 6d |@refill.|X.X@item|
|000032d0| 20 65 78 70 28 40 76 61 | 72 7b 78 7d 29 0a 58 54 | exp(@va|r{x}).XT|
|000032e0| 68 69 73 20 67 69 76 65 | 73 20 79 6f 75 20 74 68 |his give|s you th|
|000032f0| 65 20 65 78 70 6f 6e 65 | 6e 74 69 61 6c 20 6f 66 |e expone|ntial of|
|00003300| 20 40 76 61 72 7b 78 7d | 2c 20 6f 72 20 72 65 70 | @var{x}|, or rep|
|00003310| 6f 72 74 73 20 61 6e 20 | 65 72 72 6f 72 20 69 66 |orts an |error if|
|00003320| 0a 58 40 76 61 72 7b 78 | 7d 20 69 73 20 6f 75 74 |.X@var{x|} is out|
|00003330| 20 6f 66 20 72 61 6e 67 | 65 2e 20 20 54 68 65 20 | of rang|e. The |
|00003340| 72 61 6e 67 65 20 6f 66 | 20 76 61 6c 75 65 73 20 |range of| values |
|00003350| 40 76 61 72 7b 78 7d 20 | 63 61 6e 20 68 61 76 65 |@var{x} |can have|
|00003360| 20 64 65 70 65 6e 64 73 | 0a 58 6f 6e 20 79 6f 75 | depends|.Xon you|
|00003370| 72 20 6d 61 63 68 69 6e | 65 27 73 20 66 6c 6f 61 |r machin|e's floa|
|00003380| 74 69 6e 67 20 70 6f 69 | 6e 74 20 72 65 70 72 65 |ting poi|nt repre|
|00003390| 73 65 6e 74 61 74 69 6f | 6e 2e 40 72 65 66 69 6c |sentatio|n.@refil|
|000033a0| 6c 0a 58 0a 58 40 69 74 | 65 6d 20 6c 6f 67 28 40 |l.X.X@it|em log(@|
|000033b0| 76 61 72 7b 78 7d 29 0a | 58 54 68 69 73 20 67 69 |var{x}).|XThis gi|
|000033c0| 76 65 73 20 79 6f 75 20 | 74 68 65 20 6e 61 74 75 |ves you |the natu|
|000033d0| 72 61 6c 20 6c 6f 67 61 | 72 69 74 68 6d 20 6f 66 |ral loga|rithm of|
|000033e0| 20 40 76 61 72 7b 78 7d | 2c 20 69 66 20 40 76 61 | @var{x}|, if @va|
|000033f0| 72 7b 78 7d 20 69 73 20 | 70 6f 73 69 74 69 76 65 |r{x} is |positive|
|00003400| 3b 0a 58 6f 74 68 65 72 | 77 69 73 65 2c 20 69 74 |;.Xother|wise, it|
|00003410| 20 72 65 70 6f 72 74 73 | 20 61 6e 20 65 72 72 6f | reports| an erro|
|00003420| 72 2e 40 72 65 66 69 6c | 6c 0a 58 0a 58 40 69 74 |r.@refil|l.X.X@it|
|00003430| 65 6d 20 73 69 6e 28 40 | 76 61 72 7b 78 7d 29 0a |em sin(@|var{x}).|
|00003440| 58 54 68 69 73 20 67 69 | 76 65 73 20 79 6f 75 20 |XThis gi|ves you |
|00003450| 74 68 65 20 73 69 6e 65 | 20 6f 66 20 40 76 61 72 |the sine| of @var|
|00003460| 7b 78 7d 2c 20 77 69 74 | 68 20 40 76 61 72 7b 78 |{x}, wit|h @var{x|
|00003470| 7d 20 69 6e 20 72 61 64 | 69 61 6e 73 2e 0a 58 0a |} in rad|ians..X.|
|00003480| 58 40 69 74 65 6d 20 63 | 6f 73 28 40 76 61 72 7b |X@item c|os(@var{|
|00003490| 78 7d 29 0a 58 54 68 69 | 73 20 67 69 76 65 73 20 |x}).XThi|s gives |
|000034a0| 79 6f 75 20 74 68 65 20 | 63 6f 73 69 6e 65 20 6f |you the |cosine o|
|000034b0| 66 20 40 76 61 72 7b 78 | 7d 2c 20 77 69 74 68 20 |f @var{x|}, with |
|000034c0| 40 76 61 72 7b 78 7d 20 | 69 6e 20 72 61 64 69 61 |@var{x} |in radia|
|000034d0| 6e 73 2e 0a 58 0a 58 40 | 69 74 65 6d 20 61 74 61 |ns..X.X@|item ata|
|000034e0| 6e 32 28 40 76 61 72 7b | 79 7d 2c 20 40 76 61 72 |n2(@var{|y}, @var|
|000034f0| 7b 78 7d 29 0a 58 54 68 | 69 73 20 67 69 76 65 73 |{x}).XTh|is gives|
|00003500| 20 79 6f 75 20 74 68 65 | 20 61 72 63 74 61 6e 67 | you the| arctang|
|00003510| 65 6e 74 20 6f 66 20 40 | 63 6f 64 65 7b 40 76 61 |ent of @|code{@va|
|00003520| 72 7b 79 7d 20 2f 20 40 | 76 61 72 7b 78 7d 7d 2c |r{y} / @|var{x}},|
|00003530| 20 77 69 74 68 20 74 68 | 65 0a 58 71 75 6f 74 69 | with th|e.Xquoti|
|00003540| 65 6e 74 20 75 6e 64 65 | 72 73 74 6f 6f 64 20 69 |ent unde|rstood i|
|00003550| 6e 20 72 61 64 69 61 6e | 73 2e 0a 58 0a 58 40 69 |n radian|s..X.X@i|
|00003560| 74 65 6d 20 72 61 6e 64 | 28 29 0a 58 54 68 69 73 |tem rand|().XThis|
|00003570| 20 67 69 76 65 73 20 79 | 6f 75 20 61 20 72 61 6e | gives y|ou a ran|
|00003580| 64 6f 6d 20 6e 75 6d 62 | 65 72 2e 20 20 54 68 65 |dom numb|er. The|
|00003590| 20 76 61 6c 75 65 73 20 | 6f 66 20 40 63 6f 64 65 | values |of @code|
|000035a0| 7b 72 61 6e 64 7d 20 61 | 72 65 0a 58 75 6e 69 66 |{rand} a|re.Xunif|
|000035b0| 6f 72 6d 6c 79 2d 64 69 | 73 74 72 69 62 75 74 65 |ormly-di|stribute|
|000035c0| 64 20 62 65 74 77 65 65 | 6e 20 30 20 61 6e 64 20 |d betwee|n 0 and |
|000035d0| 31 2e 20 20 54 68 65 20 | 76 61 6c 75 65 20 69 73 |1. The |value is|
|000035e0| 20 6e 65 76 65 72 20 30 | 20 61 6e 64 20 6e 65 76 | never 0| and nev|
|000035f0| 65 72 0a 58 31 2e 0a 58 | 0a 58 4f 66 74 65 6e 20 |er.X1..X|.XOften |
|00003600| 79 6f 75 20 77 61 6e 74 | 20 72 61 6e 64 6f 6d 20 |you want| random |
|00003610| 69 6e 74 65 67 65 72 73 | 20 69 6e 73 74 65 61 64 |integers| instead|
|00003620| 2e 20 20 48 65 72 65 20 | 69 73 20 61 20 75 73 65 |. Here |is a use|
|00003630| 72 2d 64 65 66 69 6e 65 | 64 20 66 75 6e 63 74 69 |r-define|d functi|
|00003640| 6f 6e 0a 58 79 6f 75 20 | 63 61 6e 20 75 73 65 20 |on.Xyou |can use |
|00003650| 74 6f 20 6f 62 74 61 69 | 6e 20 61 20 72 61 6e 64 |to obtai|n a rand|
|00003660| 6f 6d 20 6e 6f 6e 6e 65 | 67 61 74 69 76 65 20 69 |om nonne|gative i|
|00003670| 6e 74 65 67 65 72 20 6c | 65 73 73 20 74 68 61 6e |nteger l|ess than|
|00003680| 20 40 76 61 72 7b 6e 7d | 3a 0a 58 0a 58 40 65 78 | @var{n}|:.X.X@ex|
|00003690| 61 6d 70 6c 65 0a 58 66 | 75 6e 63 74 69 6f 6e 20 |ample.Xf|unction |
|000036a0| 72 61 6e 64 69 6e 74 28 | 6e 29 20 40 7b 0a 58 20 |randint(|n) @{.X |
|000036b0| 20 20 20 20 72 65 74 75 | 72 6e 20 69 6e 74 28 6e | retu|rn int(n|
|000036c0| 20 2a 20 72 61 6e 64 28 | 29 29 0a 58 40 7d 0a 58 | * rand(|)).X@}.X|
|000036d0| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 58 0a 58 |@end exa|mple.X.X|
|000036e0| 40 6e 6f 69 6e 64 65 6e | 74 0a 58 54 68 65 20 6d |@noinden|t.XThe m|
|000036f0| 75 6c 74 69 70 6c 69 63 | 61 74 69 6f 6e 20 70 72 |ultiplic|ation pr|
|00003700| 6f 64 75 63 65 73 20 61 | 20 72 61 6e 64 6f 6d 20 |oduces a| random |
|00003710| 72 65 61 6c 20 6e 75 6d | 62 65 72 20 67 72 65 61 |real num|ber grea|
|00003720| 74 65 72 20 74 68 61 6e | 20 30 20 61 6e 64 20 6c |ter than| 0 and l|
|00003730| 65 73 73 0a 58 74 68 61 | 6e 20 40 76 61 72 7b 6e |ess.Xtha|n @var{n|
|00003740| 7d 2e 20 20 57 65 20 74 | 68 65 6e 20 6d 61 6b 65 |}. We t|hen make|
|00003750| 20 69 74 20 61 6e 20 69 | 6e 74 65 67 65 72 20 28 | it an i|nteger (|
|00003760| 75 73 69 6e 67 20 40 63 | 6f 64 65 7b 69 6e 74 7d |using @c|ode{int}|
|00003770| 29 20 62 65 74 77 65 65 | 6e 20 30 0a 58 61 6e 64 |) betwee|n 0.Xand|
|00003780| 20 40 63 6f 64 65 7b 40 | 76 61 72 7b 6e 7d 20 40 | @code{@|var{n} @|
|00003790| 6d 69 6e 75 73 7b 7d 20 | 31 7d 2e 0a 58 0a 58 48 |minus{} |1}..X.XH|
|000037a0| 65 72 65 20 69 73 20 61 | 6e 20 65 78 61 6d 70 6c |ere is a|n exampl|
|000037b0| 65 20 77 68 65 72 65 20 | 61 20 73 69 6d 69 6c 61 |e where |a simila|
|000037c0| 72 20 66 75 6e 63 74 69 | 6f 6e 20 69 73 20 75 73 |r functi|on is us|
|000037d0| 65 64 20 74 6f 20 70 72 | 6f 64 75 63 65 0a 58 72 |ed to pr|oduce.Xr|
|000037e0| 61 6e 64 6f 6d 20 69 6e | 74 65 67 65 72 73 20 62 |andom in|tegers b|
|000037f0| 65 74 77 65 65 6e 20 31 | 20 61 6e 64 20 40 76 61 |etween 1| and @va|
|00003800| 72 7b 6e 7d 3a 0a 58 0a | 58 40 65 78 61 6d 70 6c |r{n}:.X.|X@exampl|
|00003810| 65 0a 58 61 77 6b 20 27 | 0a 58 23 20 46 75 6e 63 |e.Xawk '|.X# Func|
|00003820| 74 69 6f 6e 20 74 6f 20 | 72 6f 6c 6c 20 61 20 73 |tion to |roll a s|
|00003830| 69 6d 75 6c 61 74 65 64 | 20 64 69 65 2e 0a 58 66 |imulated| die..Xf|
|00003840| 75 6e 63 74 69 6f 6e 20 | 72 6f 6c 6c 28 6e 29 20 |unction |roll(n) |
|00003850| 40 7b 20 72 65 74 75 72 | 6e 20 31 20 2b 20 69 6e |@{ retur|n 1 + in|
|00003860| 74 28 72 61 6e 64 28 29 | 20 2a 20 6e 29 20 40 7d |t(rand()| * n) @}|
|00003870| 0a 58 0a 58 23 20 52 6f | 6c 6c 20 33 20 73 69 78 |.X.X# Ro|ll 3 six|
|00003880| 2d 73 69 64 65 64 20 64 | 69 63 65 20 61 6e 64 20 |-sided d|ice and |
|00003890| 70 72 69 6e 74 20 74 6f | 74 61 6c 20 6e 75 6d 62 |print to|tal numb|
|000038a0| 65 72 20 6f 66 20 70 6f | 69 6e 74 73 2e 0a 58 40 |er of po|ints..X@|
|000038b0| 7b 0a 58 20 20 20 20 20 | 20 70 72 69 6e 74 66 28 |{.X | printf(|
|000038c0| 22 25 64 20 70 6f 69 6e | 74 73 5c 6e 22 2c 20 72 |"%d poin|ts\n", r|
|000038d0| 6f 6c 6c 28 36 29 2b 72 | 6f 6c 6c 28 36 29 2b 72 |oll(6)+r|oll(6)+r|
|000038e0| 6f 6c 6c 28 36 29 29 0a | 58 40 7d 27 0a 58 40 65 |oll(6)).|X@}'.X@e|
|000038f0| 6e 64 20 65 78 61 6d 70 | 6c 65 0a 58 0a 58 40 73 |nd examp|le.X.X@s|
|00003900| 74 72 6f 6e 67 7b 4e 6f | 74 65 3a 7d 20 40 63 6f |trong{No|te:} @co|
|00003910| 64 65 7b 72 61 6e 64 7d | 20 73 74 61 72 74 73 20 |de{rand}| starts |
|00003920| 67 65 6e 65 72 61 74 69 | 6e 67 20 6e 75 6d 62 65 |generati|ng numbe|
|00003930| 72 73 20 66 72 6f 6d 20 | 74 68 65 20 73 61 6d 65 |rs from |the same|
|00003940| 0a 58 70 6f 69 6e 74 2c | 20 6f 72 20 40 64 66 6e |.Xpoint,| or @dfn|
|00003950| 7b 73 65 65 64 7d 2c 20 | 65 61 63 68 20 74 69 6d |{seed}, |each tim|
|00003960| 65 20 79 6f 75 20 72 75 | 6e 20 40 63 6f 64 65 7b |e you ru|n @code{|
|00003970| 61 77 6b 7d 2e 20 20 54 | 68 69 73 20 6d 65 61 6e |awk}. T|his mean|
|00003980| 73 20 74 68 61 74 0a 58 | 61 20 70 72 6f 67 72 61 |s that.X|a progra|
|00003990| 6d 20 77 69 6c 6c 20 70 | 72 6f 64 75 63 65 20 74 |m will p|roduce t|
|000039a0| 68 65 20 73 61 6d 65 20 | 72 65 73 75 6c 74 73 20 |he same |results |
|000039b0| 65 61 63 68 20 74 69 6d | 65 20 79 6f 75 20 72 75 |each tim|e you ru|
|000039c0| 6e 20 69 74 2e 0a 58 54 | 68 65 20 6e 75 6d 62 65 |n it..XT|he numbe|
|000039d0| 72 73 20 61 72 65 20 72 | 61 6e 64 6f 6d 20 77 69 |rs are r|andom wi|
|000039e0| 74 68 69 6e 20 6f 6e 65 | 20 40 63 6f 64 65 7b 61 |thin one| @code{a|
|000039f0| 77 6b 7d 20 72 75 6e 2c | 20 62 75 74 20 70 72 65 |wk} run,| but pre|
|00003a00| 64 69 63 74 61 62 6c 65 | 0a 58 66 72 6f 6d 20 72 |dictable|.Xfrom r|
|00003a10| 75 6e 20 74 6f 20 72 75 | 6e 2e 20 20 54 68 69 73 |un to ru|n. This|
|00003a20| 20 69 73 20 63 6f 6e 76 | 65 6e 69 65 6e 74 20 66 | is conv|enient f|
|00003a30| 6f 72 20 64 65 62 75 67 | 67 69 6e 67 2c 20 62 75 |or debug|ging, bu|
|00003a40| 74 20 69 66 20 79 6f 75 | 20 77 61 6e 74 0a 58 61 |t if you| want.Xa|
|00003a50| 20 70 72 6f 67 72 61 6d | 20 74 6f 20 64 6f 20 64 | program| to do d|
|00003a60| 69 66 66 65 72 65 6e 74 | 20 74 68 69 6e 67 73 20 |ifferent| things |
|00003a70| 65 61 63 68 20 74 69 6d | 65 20 69 74 20 69 73 20 |each tim|e it is |
|00003a80| 75 73 65 64 2c 20 79 6f | 75 20 6d 75 73 74 20 63 |used, yo|u must c|
|00003a90| 68 61 6e 67 65 0a 58 74 | 68 65 20 73 65 65 64 20 |hange.Xt|he seed |
|00003aa0| 74 6f 20 61 20 76 61 6c | 75 65 20 74 68 61 74 20 |to a val|ue that |
|00003ab0| 77 69 6c 6c 20 62 65 20 | 64 69 66 66 65 72 65 6e |will be |differen|
|00003ac0| 74 20 69 6e 20 65 61 63 | 68 20 72 75 6e 2e 20 20 |t in eac|h run. |
|00003ad0| 54 6f 20 64 6f 20 74 68 | 69 73 2c 0a 58 75 73 65 |To do th|is,.Xuse|
|00003ae0| 20 40 63 6f 64 65 7b 73 | 72 61 6e 64 7d 2e 0a 58 | @code{s|rand}..X|
|00003af0| 0a 58 40 69 74 65 6d 20 | 73 72 61 6e 64 28 40 76 |.X@item |srand(@v|
|00003b00| 61 72 7b 78 7d 29 0a 58 | 54 68 65 20 66 75 6e 63 |ar{x}).X|The func|
|00003b10| 74 69 6f 6e 20 40 63 6f | 64 65 7b 73 72 61 6e 64 |tion @co|de{srand|
|00003b20| 7d 20 73 65 74 73 20 74 | 68 65 20 73 74 61 72 74 |} sets t|he start|
|00003b30| 69 6e 67 20 70 6f 69 6e | 74 2c 20 6f 72 20 40 64 |ing poin|t, or @d|
|00003b40| 66 6e 7b 73 65 65 64 7d | 2c 0a 58 66 6f 72 20 67 |fn{seed}|,.Xfor g|
|00003b50| 65 6e 65 72 61 74 69 6e | 67 20 72 61 6e 64 6f 6d |eneratin|g random|
|00003b60| 20 6e 75 6d 62 65 72 73 | 20 74 6f 20 74 68 65 20 | numbers| to the |
|00003b70| 76 61 6c 75 65 20 40 76 | 61 72 7b 78 7d 2e 0a 58 |value @v|ar{x}..X|
|00003b80| 0a 58 45 61 63 68 20 73 | 65 65 64 20 76 61 6c 75 |.XEach s|eed valu|
|00003b90| 65 20 6c 65 61 64 73 20 | 74 6f 20 61 20 70 61 72 |e leads |to a par|
|00003ba0| 74 69 63 75 6c 61 72 20 | 73 65 71 75 65 6e 63 65 |ticular |sequence|
|00003bb0| 20 6f 66 20 60 60 72 61 | 6e 64 6f 6d 27 27 20 6e | of ``ra|ndom'' n|
|00003bc0| 75 6d 62 65 72 73 2e 0a | 58 54 68 75 73 2c 20 69 |umbers..|XThus, i|
|00003bd0| 66 20 79 6f 75 20 73 65 | 74 20 74 68 65 20 73 65 |f you se|t the se|
|00003be0| 65 64 20 74 6f 20 74 68 | 65 20 73 61 6d 65 20 76 |ed to th|e same v|
|00003bf0| 61 6c 75 65 20 61 20 73 | 65 63 6f 6e 64 20 74 69 |alue a s|econd ti|
|00003c00| 6d 65 2c 20 79 6f 75 20 | 77 69 6c 6c 20 67 65 74 |me, you |will get|
|00003c10| 0a 58 74 68 65 20 73 61 | 6d 65 20 73 65 71 75 65 |.Xthe sa|me seque|
|00003c20| 6e 63 65 20 6f 66 20 60 | 60 72 61 6e 64 6f 6d 27 |nce of `|`random'|
|00003c30| 27 20 6e 75 6d 62 65 72 | 73 20 61 67 61 69 6e 2e |' number|s again.|
|00003c40| 0a 58 0a 58 49 66 20 79 | 6f 75 20 6f 6d 69 74 20 |.X.XIf y|ou omit |
|00003c50| 74 68 65 20 61 72 67 75 | 6d 65 6e 74 20 40 76 61 |the argu|ment @va|
|00003c60| 72 7b 78 7d 2c 20 61 73 | 20 69 6e 20 40 63 6f 64 |r{x}, as| in @cod|
|00003c70| 65 7b 73 72 61 6e 64 28 | 29 7d 2c 20 74 68 65 6e |e{srand(|)}, then|
|00003c80| 20 74 68 65 20 63 75 72 | 72 65 6e 74 0a 58 64 61 | the cur|rent.Xda|
|00003c90| 74 65 20 61 6e 64 20 74 | 69 6d 65 20 6f 66 20 64 |te and t|ime of d|
|00003ca0| 61 79 20 61 72 65 20 75 | 73 65 64 20 66 6f 72 20 |ay are u|sed for |
|00003cb0| 61 20 73 65 65 64 2e 20 | 20 54 68 69 73 20 69 73 |a seed. | This is|
|00003cc0| 20 74 68 65 20 77 61 79 | 20 74 6f 20 67 65 74 20 | the way| to get |
|00003cd0| 72 61 6e 64 6f 6d 0a 58 | 6e 75 6d 62 65 72 73 20 |random.X|numbers |
|00003ce0| 74 68 61 74 20 61 72 65 | 20 74 72 75 6c 79 20 75 |that are| truly u|
|00003cf0| 6e 70 72 65 64 69 63 74 | 61 62 6c 65 2e 0a 58 0a |npredict|able..X.|
|00003d00| 58 54 68 65 20 72 65 74 | 75 72 6e 20 76 61 6c 75 |XThe ret|urn valu|
|00003d10| 65 20 6f 66 20 40 63 6f | 64 65 7b 73 72 61 6e 64 |e of @co|de{srand|
|00003d20| 7d 20 69 73 20 74 68 65 | 20 70 72 65 76 69 6f 75 |} is the| previou|
|00003d30| 73 20 73 65 65 64 2e 20 | 20 54 68 69 73 20 6d 61 |s seed. | This ma|
|00003d40| 6b 65 73 20 69 74 0a 58 | 65 61 73 79 20 74 6f 20 |kes it.X|easy to |
|00003d50| 6b 65 65 70 20 74 72 61 | 63 6b 20 6f 66 20 74 68 |keep tra|ck of th|
|00003d60| 65 20 73 65 65 64 73 20 | 66 6f 72 20 75 73 65 20 |e seeds |for use |
|00003d70| 69 6e 20 63 6f 6e 73 69 | 73 74 65 6e 74 6c 79 20 |in consi|stently |
|00003d80| 72 65 70 72 6f 64 75 63 | 69 6e 67 0a 58 73 65 71 |reproduc|ing.Xseq|
|00003d90| 75 65 6e 63 65 73 20 6f | 66 20 72 61 6e 64 6f 6d |uences o|f random|
|00003da0| 20 6e 75 6d 62 65 72 73 | 2e 0a 58 40 65 6e 64 20 | numbers|..X@end |
|00003db0| 74 61 62 6c 65 0a 58 0a | 58 40 6e 6f 64 65 20 53 |table.X.|X@node S|
|00003dc0| 74 72 69 6e 67 20 46 75 | 6e 63 74 69 6f 6e 73 2c |tring Fu|nctions,|
|00003dd0| 20 49 2f 4f 20 46 75 6e | 63 74 69 6f 6e 73 2c 20 | I/O Fun|ctions, |
|00003de0| 4e 75 6d 65 72 69 63 20 | 46 75 6e 63 74 69 6f 6e |Numeric |Function|
|00003df0| 73 2c 20 42 75 69 6c 74 | 2d 69 6e 0a 58 40 73 65 |s, Built|-in.X@se|
|00003e00| 63 74 69 6f 6e 20 42 75 | 69 6c 74 2d 69 6e 20 46 |ction Bu|ilt-in F|
|00003e10| 75 6e 63 74 69 6f 6e 73 | 20 66 6f 72 20 53 74 72 |unctions| for Str|
|00003e20| 69 6e 67 20 4d 61 6e 69 | 70 75 6c 61 74 69 6f 6e |ing Mani|pulation|
|00003e30| 0a 58 0a 58 20 20 54 68 | 65 20 66 75 6e 63 74 69 |.X.X Th|e functi|
|00003e40| 6f 6e 73 20 69 6e 20 74 | 68 69 73 20 73 65 63 74 |ons in t|his sect|
|00003e50| 69 6f 6e 20 6c 6f 6f 6b | 20 61 74 20 74 68 65 20 |ion look| at the |
|00003e60| 74 65 78 74 20 6f 66 20 | 6f 6e 65 20 6f 72 20 6d |text of |one or m|
|00003e70| 6f 72 65 0a 58 73 74 72 | 69 6e 67 73 2e 0a 58 0a |ore.Xstr|ings..X.|
|00003e80| 58 40 74 61 62 6c 65 20 | 40 63 6f 64 65 0a 58 40 |X@table |@code.X@|
|00003e90| 69 74 65 6d 20 69 6e 64 | 65 78 28 40 76 61 72 7b |item ind|ex(@var{|
|00003ea0| 69 6e 7d 2c 20 40 76 61 | 72 7b 66 69 6e 64 7d 29 |in}, @va|r{find})|
|00003eb0| 0a 58 40 66 69 6e 64 65 | 78 20 6d 61 74 63 68 0a |.X@finde|x match.|
|00003ec0| 58 54 68 69 73 20 73 65 | 61 72 63 68 65 73 20 74 |XThis se|arches t|
|00003ed0| 68 65 20 73 74 72 69 6e | 67 20 40 76 61 72 7b 69 |he strin|g @var{i|
|00003ee0| 6e 7d 20 66 6f 72 20 74 | 68 65 20 66 69 72 73 74 |n} for t|he first|
|00003ef0| 20 6f 63 63 75 72 72 65 | 6e 63 65 20 6f 66 20 74 | occurre|nce of t|
|00003f00| 68 65 20 73 74 72 69 6e | 67 0a 58 40 76 61 72 7b |he strin|g.X@var{|
|00003f10| 66 69 6e 64 7d 2c 20 61 | 6e 64 20 72 65 74 75 72 |find}, a|nd retur|
|00003f20| 6e 73 20 74 68 65 20 70 | 6f 73 69 74 69 6f 6e 20 |ns the p|osition |
|00003f30| 77 68 65 72 65 20 74 68 | 61 74 20 6f 63 63 75 72 |where th|at occur|
|00003f40| 72 65 6e 63 65 20 62 65 | 67 69 6e 73 20 69 6e 20 |rence be|gins in |
|00003f50| 74 68 65 0a 58 73 74 72 | 69 6e 67 20 40 76 61 72 |the.Xstr|ing @var|
|00003f60| 7b 69 6e 7d 2e 20 20 46 | 6f 72 20 65 78 61 6d 70 |{in}. F|or examp|
|00003f70| 6c 65 3a 40 72 65 66 69 | 6c 6c 0a 58 0a 58 40 65 |le:@refi|ll.X.X@e|
|00003f80| 78 61 6d 70 6c 65 0a 58 | 61 77 6b 20 27 42 45 47 |xample.X|awk 'BEG|
|00003f90| 49 4e 20 40 7b 20 70 72 | 69 6e 74 20 69 6e 64 65 |IN @{ pr|int inde|
|00003fa0| 78 28 22 70 65 61 6e 75 | 74 22 2c 20 22 61 6e 22 |x("peanu|t", "an"|
|00003fb0| 29 20 40 7d 27 0a 58 40 | 65 6e 64 20 65 78 61 6d |) @}'.X@|end exam|
|00003fc0| 70 6c 65 0a 58 0a 58 40 | 6e 6f 69 6e 64 65 6e 74 |ple.X.X@|noindent|
|00003fd0| 0a 58 70 72 69 6e 74 73 | 20 40 73 61 6d 70 7b 33 |.Xprints| @samp{3|
|00003fe0| 7d 2e 20 20 49 66 20 40 | 76 61 72 7b 66 69 6e 64 |}. If @|var{find|
|00003ff0| 7d 20 69 73 20 6e 6f 74 | 20 66 6f 75 6e 64 2c 20 |} is not| found, |
|00004000| 40 63 6f 64 65 7b 69 6e | 64 65 78 7d 20 72 65 74 |@code{in|dex} ret|
|00004010| 75 72 6e 73 20 30 2e 0a | 58 0a 58 40 69 74 65 6d |urns 0..|X.X@item|
|00004020| 20 6c 65 6e 67 74 68 28 | 40 76 61 72 7b 73 74 72 | length(|@var{str|
|00004030| 69 6e 67 7d 29 0a 58 40 | 66 69 6e 64 65 78 20 6c |ing}).X@|findex l|
|00004040| 65 6e 67 74 68 0a 58 54 | 68 69 73 20 67 69 76 65 |ength.XT|his give|
|00004050| 73 20 79 6f 75 20 74 68 | 65 20 6e 75 6d 62 65 72 |s you th|e number|
|00004060| 20 6f 66 20 63 68 61 72 | 61 63 74 65 72 73 20 69 | of char|acters i|
|00004070| 6e 20 40 76 61 72 7b 73 | 74 72 69 6e 67 7d 2e 20 |n @var{s|tring}. |
|00004080| 20 49 66 0a 58 40 76 61 | 72 7b 73 74 72 69 6e 67 | If.X@va|r{string|
|00004090| 7d 20 69 73 20 61 20 6e | 75 6d 62 65 72 2c 20 74 |} is a n|umber, t|
|000040a0| 68 65 20 6c 65 6e 67 74 | 68 20 6f 66 20 74 68 65 |he lengt|h of the|
|000040b0| 20 64 69 67 69 74 20 73 | 74 72 69 6e 67 20 72 65 | digit s|tring re|
|000040c0| 70 72 65 73 65 6e 74 69 | 6e 67 0a 58 74 68 61 74 |presenti|ng.Xthat|
|000040d0| 20 6e 75 6d 62 65 72 20 | 69 73 20 72 65 74 75 72 | number |is retur|
|000040e0| 6e 65 64 2e 20 20 46 6f | 72 20 65 78 61 6d 70 6c |ned. Fo|r exampl|
|000040f0| 65 2c 20 40 63 6f 64 65 | 7b 6c 65 6e 67 74 68 28 |e, @code|{length(|
|00004100| 22 61 62 63 64 65 22 29 | 7d 20 69 73 20 35 2e 20 |"abcde")|} is 5. |
|00004110| 20 42 79 0a 58 63 6f 6e | 74 72 61 73 74 2c 20 40 | By.Xcon|trast, @|
|00004120| 63 6f 64 65 7b 6c 65 6e | 67 74 68 28 31 35 20 2a |code{len|gth(15 *|
|00004130| 20 33 35 29 7d 20 77 6f | 72 6b 73 20 6f 75 74 20 | 35)} wo|rks out |
|00004140| 74 6f 20 33 2e 20 20 48 | 6f 77 3f 20 20 57 65 6c |to 3. H|ow? Wel|
|00004150| 6c 2c 20 31 35 20 2a 20 | 33 35 20 3d 0a 58 35 32 |l, 15 * |35 =.X52|
|00004160| 35 2c 20 61 6e 64 20 35 | 32 35 20 69 73 20 74 68 |5, and 5|25 is th|
|00004170| 65 6e 20 63 6f 6e 76 65 | 72 74 65 64 20 74 6f 20 |en conve|rted to |
|00004180| 74 68 65 20 73 74 72 69 | 6e 67 20 40 73 61 6d 70 |the stri|ng @samp|
|00004190| 7b 22 35 32 35 22 7d 2c | 20 77 68 69 63 68 20 68 |{"525"},| which h|
|000041a0| 61 73 0a 58 74 68 72 65 | 65 20 63 68 61 72 61 63 |as.Xthre|e charac|
|000041b0| 74 65 72 73 2e 0a 58 0a | 58 49 66 20 6e 6f 20 61 |ters..X.|XIf no a|
|000041c0| 72 67 75 6d 65 6e 74 20 | 69 73 20 73 75 70 70 6c |rgument |is suppl|
|000041d0| 69 65 64 2c 20 40 63 6f | 64 65 7b 6c 65 6e 67 74 |ied, @co|de{lengt|
|000041e0| 68 7d 20 72 65 74 75 72 | 6e 73 20 74 68 65 20 6c |h} retur|ns the l|
|000041f0| 65 6e 67 74 68 20 6f 66 | 20 40 63 6f 64 65 7b 24 |ength of| @code{$|
|00004200| 30 7d 2e 0a 58 0a 58 40 | 69 74 65 6d 20 6d 61 74 |0}..X.X@|item mat|
|00004210| 63 68 28 40 76 61 72 7b | 73 74 72 69 6e 67 7d 2c |ch(@var{|string},|
|00004220| 20 40 76 61 72 7b 72 65 | 67 65 78 70 7d 29 0a 58 | @var{re|gexp}).X|
|00004230| 40 66 69 6e 64 65 78 20 | 6d 61 74 63 68 0a 58 54 |@findex |match.XT|
|00004240| 68 65 20 40 63 6f 64 65 | 7b 6d 61 74 63 68 7d 20 |he @code|{match} |
|00004250| 66 75 6e 63 74 69 6f 6e | 20 73 65 61 72 63 68 65 |function| searche|
|00004260| 73 20 74 68 65 20 73 74 | 72 69 6e 67 2c 20 40 76 |s the st|ring, @v|
|00004270| 61 72 7b 73 74 72 69 6e | 67 7d 2c 20 66 6f 72 20 |ar{strin|g}, for |
|00004280| 74 68 65 0a 58 6c 6f 6e | 67 65 73 74 2c 20 6c 65 |the.Xlon|gest, le|
|00004290| 66 74 6d 6f 73 74 20 73 | 75 62 73 74 72 69 6e 67 |ftmost s|ubstring|
|000042a0| 20 6d 61 74 63 68 65 64 | 20 62 79 20 74 68 65 20 | matched| by the |
|000042b0| 72 65 67 75 6c 61 72 20 | 65 78 70 72 65 73 73 69 |regular |expressi|
|000042c0| 6f 6e 2c 0a 58 40 76 61 | 72 7b 72 65 67 65 78 70 |on,.X@va|r{regexp|
|000042d0| 7d 2e 20 20 49 74 20 72 | 65 74 75 72 6e 73 20 74 |}. It r|eturns t|
|000042e0| 68 65 20 63 68 61 72 61 | 63 74 65 72 20 70 6f 73 |he chara|cter pos|
|000042f0| 69 74 69 6f 6e 2c 20 6f | 72 20 40 64 66 6e 7b 69 |ition, o|r @dfn{i|
|00004300| 6e 64 65 78 7d 2c 20 6f | 66 0a 58 77 68 65 72 65 |ndex}, o|f.Xwhere|
|00004310| 20 74 68 61 74 20 73 75 | 62 73 74 72 69 6e 67 20 | that su|bstring |
|00004320| 62 65 67 69 6e 73 20 28 | 31 2c 20 69 66 20 69 74 |begins (|1, if it|
|00004330| 20 73 74 61 72 74 73 20 | 61 74 20 74 68 65 20 62 | starts |at the b|
|00004340| 65 67 69 6e 6e 69 6e 67 | 20 6f 66 0a 58 40 76 61 |eginning| of.X@va|
|00004350| 72 7b 73 74 72 69 6e 67 | 7d 29 2e 20 20 49 66 20 |r{string|}). If |
|00004360| 6e 6f 20 6d 61 74 63 68 | 20 69 66 20 66 6f 75 6e |no match| if foun|
|00004370| 64 2c 20 69 74 20 72 65 | 74 75 72 6e 73 20 30 2e |d, it re|turns 0.|
|00004380| 0a 58 0a 58 40 76 69 6e | 64 65 78 20 52 53 54 41 |.X.X@vin|dex RSTA|
|00004390| 52 54 0a 58 40 76 69 6e | 64 65 78 20 52 4c 45 4e |RT.X@vin|dex RLEN|
|000043a0| 47 54 48 0a 58 54 68 65 | 20 40 63 6f 64 65 7b 6d |GTH.XThe| @code{m|
|000043b0| 61 74 63 68 7d 20 66 75 | 6e 63 74 69 6f 6e 20 73 |atch} fu|nction s|
|000043c0| 65 74 73 20 74 68 65 20 | 62 75 69 6c 74 2d 69 6e |ets the |built-in|
|000043d0| 20 76 61 72 69 61 62 6c | 65 20 40 63 6f 64 65 7b | variabl|e @code{|
|000043e0| 52 53 54 41 52 54 7d 20 | 74 6f 0a 58 74 68 65 20 |RSTART} |to.Xthe |
|000043f0| 69 6e 64 65 78 2e 20 20 | 49 74 20 61 6c 73 6f 20 |index. |It also |
|00004400| 73 65 74 73 20 74 68 65 | 20 62 75 69 6c 74 2d 69 |sets the| built-i|
|00004410| 6e 20 76 61 72 69 61 62 | 6c 65 20 40 63 6f 64 65 |n variab|le @code|
|00004420| 7b 52 4c 45 4e 47 54 48 | 7d 20 74 6f 20 74 68 65 |{RLENGTH|} to the|
|00004430| 0a 58 6c 65 6e 67 74 68 | 20 6f 66 20 74 68 65 20 |.Xlength| of the |
|00004440| 6d 61 74 63 68 65 64 20 | 73 75 62 73 74 72 69 6e |matched |substrin|
|00004450| 67 2e 20 20 49 66 20 6e | 6f 20 6d 61 74 63 68 20 |g. If n|o match |
|00004460| 69 73 20 66 6f 75 6e 64 | 2c 20 40 63 6f 64 65 7b |is found|, @code{|
|00004470| 52 53 54 41 52 54 7d 0a | 58 69 73 20 73 65 74 20 |RSTART}.|Xis set |
|00004480| 74 6f 20 30 2c 20 61 6e | 64 20 40 63 6f 64 65 7b |to 0, an|d @code{|
|00004490| 52 4c 45 4e 47 54 48 7d | 20 74 6f 20 40 6d 69 6e |RLENGTH}| to @min|
|000044a0| 75 73 7b 7d 31 2e 0a 58 | 0a 58 46 6f 72 20 65 78 |us{}1..X|.XFor ex|
|000044b0| 61 6d 70 6c 65 3a 0a 58 | 0a 58 40 65 78 61 6d 70 |ample:.X|.X@examp|
|000044c0| 6c 65 0a 58 61 77 6b 20 | 27 40 7b 0a 58 20 20 20 |le.Xawk |'@{.X |
|000044d0| 20 20 20 20 69 66 20 28 | 24 31 20 3d 3d 20 22 46 | if (|$1 == "F|
|000044e0| 49 4e 44 22 29 0a 58 20 | 20 20 20 20 20 20 20 20 |IND").X | |
|000044f0| 72 65 67 65 78 20 3d 20 | 24 32 0a 58 20 20 20 20 |regex = |$2.X |
|00004500| 20 20 20 65 6c 73 65 20 | 40 7b 0a 58 20 20 20 20 | else |@{.X |
|00004510| 20 20 20 20 20 77 68 65 | 72 65 20 3d 20 6d 61 74 | whe|re = mat|
|00004520| 63 68 28 24 30 2c 20 72 | 65 67 65 78 29 0a 58 20 |ch($0, r|egex).X |
|00004530| 20 20 20 20 20 20 20 20 | 69 66 20 28 77 68 65 72 | |if (wher|
|00004540| 65 29 0a 58 20 20 20 20 | 20 20 20 20 20 20 20 70 |e).X | p|
|00004550| 72 69 6e 74 20 22 4d 61 | 74 63 68 20 6f 66 22 2c |rint "Ma|tch of",|
|00004560| 20 72 65 67 65 78 2c 20 | 22 66 6f 75 6e 64 20 61 | regex, |"found a|
|00004570| 74 22 2c 20 77 68 65 72 | 65 2c 20 22 69 6e 22 2c |t", wher|e, "in",|
|00004580| 20 24 30 0a 58 20 20 20 | 20 20 20 20 40 7d 0a 58 | $0.X | @}.X|
|00004590| 40 7d 27 0a 58 40 65 6e | 64 20 65 78 61 6d 70 6c |@}'.X@en|d exampl|
|000045a0| 65 0a 58 0a 58 40 6e 6f | 69 6e 64 65 6e 74 0a 58 |e.X.X@no|indent.X|
|000045b0| 54 68 69 73 20 70 72 6f | 67 72 61 6d 20 6c 6f 6f |This pro|gram loo|
|000045c0| 6b 73 20 66 6f 72 20 6c | 69 6e 65 73 20 74 68 61 |ks for l|ines tha|
|000045d0| 74 20 6d 61 74 63 68 20 | 74 68 65 20 72 65 67 75 |t match |the regu|
|000045e0| 6c 61 72 20 65 78 70 72 | 65 73 73 69 6f 6e 20 73 |lar expr|ession s|
|000045f0| 74 6f 72 65 64 20 69 6e | 0a 58 74 68 65 20 76 61 |tored in|.Xthe va|
|00004600| 72 69 61 62 6c 65 20 40 | 63 6f 64 65 7b 72 65 67 |riable @|code{reg|
|00004610| 65 78 7d 2e 20 20 54 68 | 69 73 20 72 65 67 75 6c |ex}. Th|is regul|
|00004620| 61 72 20 65 78 70 72 65 | 73 73 69 6f 6e 20 63 61 |ar expre|ssion ca|
|00004630| 6e 20 62 65 20 63 68 61 | 6e 67 65 64 2e 20 20 49 |n be cha|nged. I|
|00004640| 66 20 74 68 65 0a 58 66 | 69 72 73 74 20 77 6f 72 |f the.Xf|irst wor|
|00004650| 64 20 6f 6e 20 61 20 6c | 69 6e 65 20 69 73 20 40 |d on a l|ine is @|
|00004660| 73 61 6d 70 7b 46 49 4e | 44 7d 2c 20 40 63 6f 64 |samp{FIN|D}, @cod|
|00004670| 65 7b 72 65 67 65 78 7d | 20 69 73 20 63 68 61 6e |e{regex}| is chan|
|00004680| 67 65 64 20 74 6f 20 62 | 65 20 74 68 65 0a 58 73 |ged to b|e the.Xs|
|00004690| 65 63 6f 6e 64 20 77 6f | 72 64 20 6f 6e 20 74 68 |econd wo|rd on th|
|000046a0| 61 74 20 6c 69 6e 65 2e | 20 20 54 68 65 72 65 66 |at line.| Theref|
|000046b0| 6f 72 65 2c 20 67 69 76 | 65 6e 3a 0a 58 0a 58 40 |ore, giv|en:.X.X@|
|000046c0| 65 78 61 6d 70 6c 65 0a | 58 46 49 4e 44 20 66 6f |example.|XFIND fo|
|000046d0| 2a 62 61 72 0a 58 4d 79 | 20 70 72 6f 67 72 61 6d |*bar.XMy| program|
|000046e0| 20 77 61 73 20 61 20 66 | 6f 6f 62 61 72 0a 58 42 | was a f|oobar.XB|
|000046f0| 75 74 20 6e 6f 6e 65 20 | 6f 66 20 69 74 20 77 6f |ut none |of it wo|
|00004700| 75 6c 64 20 64 6f 6f 62 | 61 72 0a 58 46 49 4e 44 |uld doob|ar.XFIND|
|00004710| 20 4d 65 6c 76 69 6e 0a | 58 4a 46 2b 4b 4d 0a 58 | Melvin.|XJF+KM.X|
|00004720| 54 68 69 73 20 6c 69 6e | 65 20 69 73 20 70 72 6f |This lin|e is pro|
|00004730| 70 65 72 74 79 20 6f 66 | 20 54 68 65 20 52 65 61 |perty of| The Rea|
|00004740| 6c 69 74 79 20 45 6e 67 | 69 6e 65 65 72 69 6e 67 |lity Eng|ineering|
|00004750| 20 43 6f 2e 0a 58 54 68 | 69 73 20 66 69 6c 65 20 | Co..XTh|is file |
|00004760| 63 72 65 61 74 65 64 20 | 62 79 20 4d 65 6c 76 69 |created |by Melvi|
|00004770| 6e 2e 0a 58 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |n..X@end| example|
|00004780| 0a 58 0a 58 40 6e 6f 69 | 6e 64 65 6e 74 0a 58 40 |.X.X@noi|ndent.X@|
|00004790| 63 6f 64 65 7b 61 77 6b | 7d 20 70 72 69 6e 74 73 |code{awk|} prints|
|000047a0| 3a 0a 58 0a 58 40 65 78 | 61 6d 70 6c 65 0a 58 4d |:.X.X@ex|ample.XM|
|000047b0| 61 74 63 68 20 6f 66 20 | 66 6f 2a 62 61 72 20 66 |atch of |fo*bar f|
|000047c0| 6f 75 6e 64 20 61 74 20 | 31 38 20 69 6e 20 4d 79 |ound at |18 in My|
|000047d0| 20 70 72 6f 67 72 61 6d | 20 77 61 73 20 61 20 66 | program| was a f|
|000047e0| 6f 6f 62 61 72 0a 58 4d | 61 74 63 68 20 6f 66 20 |oobar.XM|atch of |
|000047f0| 4d 65 6c 76 69 6e 20 66 | 6f 75 6e 64 20 61 74 20 |Melvin f|ound at |
|00004800| 32 36 20 69 6e 20 54 68 | 69 73 20 66 69 6c 65 20 |26 in Th|is file |
|00004810| 63 72 65 61 74 65 64 20 | 62 79 20 4d 65 6c 76 69 |created |by Melvi|
|00004820| 6e 2e 0a 58 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |n..X@end| example|
|00004830| 0a 58 0a 58 40 69 74 65 | 6d 20 73 70 6c 69 74 28 |.X.X@ite|m split(|
|00004840| 40 76 61 72 7b 73 74 72 | 69 6e 67 7d 2c 20 40 76 |@var{str|ing}, @v|
|00004850| 61 72 7b 61 72 72 61 79 | 7d 2c 20 40 76 61 72 7b |ar{array|}, @var{|
|00004860| 66 69 65 6c 64 73 65 70 | 7d 29 0a 58 40 66 69 6e |fieldsep|}).X@fin|
|00004870| 64 65 78 20 73 70 6c 69 | 74 0a 58 54 68 69 73 20 |dex spli|t.XThis |
|00004880| 64 69 76 69 64 65 73 20 | 40 76 61 72 7b 73 74 72 |divides |@var{str|
|00004890| 69 6e 67 7d 20 75 70 20 | 69 6e 74 6f 20 70 69 65 |ing} up |into pie|
|000048a0| 63 65 73 20 73 65 70 61 | 72 61 74 65 64 20 62 79 |ces sepa|rated by|
|000048b0| 20 40 76 61 72 7b 66 69 | 65 6c 64 73 65 70 7d 2c | @var{fi|eldsep},|
|000048c0| 0a 58 61 6e 64 20 73 74 | 6f 72 65 73 20 74 68 65 |.Xand st|ores the|
|000048d0| 20 70 69 65 63 65 73 20 | 69 6e 20 40 76 61 72 7b | pieces |in @var{|
|000048e0| 61 72 72 61 79 7d 2e 20 | 20 54 68 65 20 66 69 72 |array}. | The fir|
|000048f0| 73 74 20 70 69 65 63 65 | 20 69 73 20 73 74 6f 72 |st piece| is stor|
|00004900| 65 64 20 69 6e 0a 58 40 | 63 6f 64 65 7b 40 76 61 |ed in.X@|code{@va|
|00004910| 72 7b 61 72 72 61 79 7d | 5b 31 5d 7d 2c 20 74 68 |r{array}|[1]}, th|
|00004920| 65 20 73 65 63 6f 6e 64 | 20 70 69 65 63 65 20 69 |e second| piece i|
|00004930| 6e 20 40 63 6f 64 65 7b | 40 76 61 72 7b 61 72 72 |n @code{|@var{arr|
|00004940| 61 79 7d 5b 32 5d 7d 2c | 20 61 6e 64 20 73 6f 0a |ay}[2]},| and so.|
|00004950| 58 66 6f 72 74 68 2e 20 | 20 54 68 65 20 73 74 72 |Xforth. | The str|
|00004960| 69 6e 67 20 76 61 6c 75 | 65 20 6f 66 20 74 68 65 |ing valu|e of the|
|00004970| 20 74 68 69 72 64 20 61 | 72 67 75 6d 65 6e 74 2c | third a|rgument,|
|00004980| 20 40 76 61 72 7b 66 69 | 65 6c 64 73 65 70 7d 2c | @var{fi|eldsep},|
|00004990| 20 69 73 20 75 73 65 64 | 0a 58 61 73 20 61 20 72 | is used|.Xas a r|
|000049a0| 65 67 65 78 70 20 74 6f | 20 73 65 61 72 63 68 20 |egexp to| search |
|000049b0| 66 6f 72 20 74 6f 20 66 | 69 6e 64 20 74 68 65 20 |for to f|ind the |
|000049c0| 70 6c 61 63 65 73 20 74 | 6f 20 73 70 6c 69 74 20 |places t|o split |
|000049d0| 40 76 61 72 7b 73 74 72 | 69 6e 67 7d 2e 20 20 49 |@var{str|ing}. I|
|000049e0| 66 0a 58 74 68 65 20 40 | 76 61 72 7b 66 69 65 6c |f.Xthe @|var{fiel|
|000049f0| 64 73 65 70 7d 20 69 73 | 20 6f 6d 69 74 74 65 64 |dsep} is| omitted|
|00004a00| 2c 20 74 68 65 20 76 61 | 6c 75 65 20 6f 66 20 40 |, the va|lue of @|
|00004a10| 63 6f 64 65 7b 46 53 7d | 20 69 73 20 75 73 65 64 |code{FS}| is used|
|00004a20| 2e 0a 58 40 63 6f 64 65 | 7b 73 70 6c 69 74 7d 20 |..X@code|{split} |
|00004a30| 72 65 74 75 72 6e 73 20 | 74 68 65 20 6e 75 6d 62 |returns |the numb|
|00004a40| 65 72 20 6f 66 20 65 6c | 65 6d 65 6e 74 73 20 63 |er of el|ements c|
|00004a50| 72 65 61 74 65 64 2e 40 | 72 65 66 69 6c 6c 0a 58 |reated.@|refill.X|
|00004a60| 0a 58 54 68 65 20 40 63 | 6f 64 65 7b 73 70 6c 69 |.XThe @c|ode{spli|
|00004a70| 74 7d 20 66 75 6e 63 74 | 69 6f 6e 2c 20 74 68 65 |t} funct|ion, the|
|00004a80| 6e 2c 20 73 70 6c 69 74 | 73 20 73 74 72 69 6e 67 |n, split|s string|
|00004a90| 73 20 69 6e 74 6f 20 70 | 69 65 63 65 73 20 69 6e |s into p|ieces in|
|00004aa0| 20 61 0a 58 6d 61 6e 6e | 65 72 20 73 69 6d 69 6c | a.Xmann|er simil|
|00004ab0| 61 72 20 74 6f 20 74 68 | 65 20 77 61 79 20 69 6e |ar to th|e way in|
|00004ac0| 70 75 74 20 6c 69 6e 65 | 73 20 61 72 65 20 73 70 |put line|s are sp|
|00004ad0| 6c 69 74 20 69 6e 74 6f | 20 66 69 65 6c 64 73 2e |lit into| fields.|
|00004ae0| 20 20 46 6f 72 20 65 78 | 61 6d 70 6c 65 3a 0a 58 | For ex|ample:.X|
|00004af0| 0a 58 40 65 78 61 6d 70 | 6c 65 0a 58 73 70 6c 69 |.X@examp|le.Xspli|
|00004b00| 74 28 22 61 75 74 6f 2d | 64 61 2d 66 65 22 2c 20 |t("auto-|da-fe", |
|00004b10| 61 2c 20 22 2d 22 29 0a | 58 40 65 6e 64 20 65 78 |a, "-").|X@end ex|
|00004b20| 61 6d 70 6c 65 0a 58 0a | 58 40 6e 6f 69 6e 64 65 |ample.X.|X@noinde|
|00004b30| 6e 74 0a 58 73 70 6c 69 | 74 73 20 74 68 65 20 73 |nt.Xspli|ts the s|
|00004b40| 74 72 69 6e 67 20 40 73 | 61 6d 70 7b 61 75 74 6f |tring @s|amp{auto|
|00004b50| 2d 64 61 2d 66 65 7d 20 | 69 6e 74 6f 20 74 68 72 |-da-fe} |into thr|
|00004b60| 65 65 20 66 69 65 6c 64 | 73 20 75 73 69 6e 67 20 |ee field|s using |
|00004b70| 40 73 61 6d 70 7b 2d 7d | 20 61 73 20 74 68 65 0a |@samp{-}| as the.|
|00004b80| 58 73 65 70 61 72 61 74 | 6f 72 2e 20 20 49 74 20 |Xseparat|or. It |
|00004b90| 73 65 74 73 20 74 68 65 | 20 63 6f 6e 74 65 6e 74 |sets the| content|
|00004ba0| 73 20 6f 66 20 74 68 65 | 20 61 72 72 61 79 20 40 |s of the| array @|
|00004bb0| 63 6f 64 65 7b 61 7d 20 | 61 73 20 66 6f 6c 6c 6f |code{a} |as follo|
|00004bc0| 77 73 3a 0a 58 0a 58 40 | 65 78 61 6d 70 6c 65 0a |ws:.X.X@|example.|
|00004bd0| 58 61 5b 31 5d 20 3d 20 | 22 61 75 74 6f 22 0a 58 |Xa[1] = |"auto".X|
|00004be0| 61 5b 32 5d 20 3d 20 22 | 64 61 22 0a 58 61 5b 33 |a[2] = "|da".Xa[3|
|00004bf0| 5d 20 3d 20 22 66 65 22 | 0a 58 40 65 6e 64 20 65 |] = "fe"|.X@end e|
|00004c00| 78 61 6d 70 6c 65 0a 58 | 0a 58 40 6e 6f 69 6e 64 |xample.X|.X@noind|
|00004c10| 65 6e 74 0a 58 54 68 65 | 20 76 61 6c 75 65 20 72 |ent.XThe| value r|
|00004c20| 65 74 75 72 6e 65 64 20 | 62 79 20 74 68 69 73 20 |eturned |by this |
|00004c30| 63 61 6c 6c 20 74 6f 20 | 40 63 6f 64 65 7b 73 70 |call to |@code{sp|
|00004c40| 6c 69 74 7d 20 69 73 20 | 33 2e 0a 58 0a 58 40 69 |lit} is |3..X.X@i|
|00004c50| 74 65 6d 20 73 70 72 69 | 6e 74 66 28 40 76 61 72 |tem spri|ntf(@var|
|00004c60| 7b 66 6f 72 6d 61 74 7d | 2c 20 40 76 61 72 7b 65 |{format}|, @var{e|
|00004c70| 78 70 72 65 73 73 69 6f | 6e 31 7d 2c 40 64 6f 74 |xpressio|n1},@dot|
|00004c80| 73 7b 7d 29 0a 58 40 66 | 69 6e 64 65 78 20 73 70 |s{}).X@f|index sp|
|00004c90| 72 69 6e 74 66 0a 58 54 | 68 69 73 20 72 65 74 75 |rintf.XT|his retu|
|00004ca0| 72 6e 73 20 28 77 69 74 | 68 6f 75 74 20 70 72 69 |rns (wit|hout pri|
|00004cb0| 6e 74 69 6e 67 29 20 74 | 68 65 20 73 74 72 69 6e |nting) t|he strin|
|00004cc0| 67 20 74 68 61 74 20 40 | 63 6f 64 65 7b 70 72 69 |g that @|code{pri|
|00004cd0| 6e 74 66 7d 20 77 6f 75 | 6c 64 0a 58 68 61 76 65 |ntf} wou|ld.Xhave|
|00004ce0| 20 70 72 69 6e 74 65 64 | 20 6f 75 74 20 77 69 74 | printed| out wit|
|00004cf0| 68 20 74 68 65 20 73 61 | 6d 65 20 61 72 67 75 6d |h the sa|me argum|
|00004d00| 65 6e 74 73 20 28 40 70 | 78 72 65 66 7b 50 72 69 |ents (@p|xref{Pri|
|00004d10| 6e 74 66 7d 29 2e 20 20 | 46 6f 72 0a 58 65 78 61 |ntf}). |For.Xexa|
|00004d20| 6d 70 6c 65 3a 0a 58 0a | 58 40 65 78 61 6d 70 6c |mple:.X.|X@exampl|
|00004d30| 65 0a 58 73 70 72 69 6e | 74 66 28 22 70 69 20 3d |e.Xsprin|tf("pi =|
|00004d40| 20 25 2e 32 66 20 28 61 | 70 70 72 6f 78 2e 29 22 | %.2f (a|pprox.)"|
|00004d50| 2c 20 32 32 2f 37 29 0a | 58 40 65 6e 64 20 65 78 |, 22/7).|X@end ex|
|00004d60| 61 6d 70 6c 65 0a 58 0a | 58 40 6e 6f 69 6e 64 65 |ample.X.|X@noinde|
|00004d70| 6e 74 0a 58 72 65 74 75 | 72 6e 73 20 74 68 65 20 |nt.Xretu|rns the |
|00004d80| 73 74 72 69 6e 67 20 40 | 77 7b 40 63 6f 64 65 7b |string @|w{@code{|
|00004d90| 22 70 69 20 3d 20 33 2e | 31 34 20 28 61 70 70 72 |"pi = 3.|14 (appr|
|00004da0| 6f 78 2e 29 22 7d 7d 2e | 0a 58 0a 58 40 69 74 65 |ox.)"}}.|.X.X@ite|
|00004db0| 6d 20 73 75 62 28 40 76 | 61 72 7b 72 65 67 65 78 |m sub(@v|ar{regex|
|00004dc0| 70 7d 2c 20 40 76 61 72 | 7b 72 65 70 6c 61 63 65 |p}, @var|{replace|
|00004dd0| 6d 65 6e 74 7d 2c 20 40 | 76 61 72 7b 74 61 72 67 |ment}, @|var{targ|
|00004de0| 65 74 7d 29 0a 58 40 66 | 69 6e 64 65 78 20 73 75 |et}).X@f|index su|
|00004df0| 62 0a 58 54 68 65 20 40 | 63 6f 64 65 7b 73 75 62 |b.XThe @|code{sub|
|00004e00| 7d 20 66 75 6e 63 74 69 | 6f 6e 20 61 6c 74 65 72 |} functi|on alter|
|00004e10| 73 20 74 68 65 20 76 61 | 6c 75 65 20 6f 66 20 40 |s the va|lue of @|
|00004e20| 76 61 72 7b 74 61 72 67 | 65 74 7d 2e 0a 58 49 74 |var{targ|et}..XIt|
|00004e30| 20 73 65 61 72 63 68 65 | 73 20 74 68 69 73 20 76 | searche|s this v|
|00004e40| 61 6c 75 65 2c 20 77 68 | 69 63 68 20 73 68 6f 75 |alue, wh|ich shou|
|00004e50| 6c 64 20 62 65 20 61 20 | 73 74 72 69 6e 67 2c 20 |ld be a |string, |
|00004e60| 66 6f 72 20 74 68 65 0a | 58 6c 65 66 74 6d 6f 73 |for the.|Xleftmos|
|00004e70| 74 20 73 75 62 73 74 72 | 69 6e 67 20 6d 61 74 63 |t substr|ing matc|
|00004e80| 68 65 64 20 62 79 20 74 | 68 65 20 72 65 67 75 6c |hed by t|he regul|
|00004e90| 61 72 20 65 78 70 72 65 | 73 73 69 6f 6e 2c 20 40 |ar expre|ssion, @|
|00004ea0| 76 61 72 7b 72 65 67 65 | 78 70 7d 2c 0a 58 65 78 |var{rege|xp},.Xex|
|00004eb0| 74 65 6e 64 69 6e 67 20 | 74 68 69 73 20 6d 61 74 |tending |this mat|
|00004ec0| 63 68 20 61 73 20 66 61 | 72 20 61 73 20 70 6f 73 |ch as fa|r as pos|
|00004ed0| 73 69 62 6c 65 2e 20 20 | 54 68 65 6e 20 74 68 65 |sible. |Then the|
|00004ee0| 20 65 6e 74 69 72 65 20 | 73 74 72 69 6e 67 20 69 | entire |string i|
|00004ef0| 73 0a 58 63 68 61 6e 67 | 65 64 20 62 79 20 72 65 |s.Xchang|ed by re|
|00004f00| 70 6c 61 63 69 6e 67 20 | 74 68 65 20 6d 61 74 63 |placing |the matc|
|00004f10| 68 65 64 20 74 65 78 74 | 20 77 69 74 68 20 40 76 |hed text| with @v|
|00004f20| 61 72 7b 72 65 70 6c 61 | 63 65 6d 65 6e 74 7d 2e |ar{repla|cement}.|
|00004f30| 0a 58 54 68 65 20 6d 6f | 64 69 66 69 65 64 20 73 |.XThe mo|dified s|
|00004f40| 74 72 69 6e 67 20 62 65 | 63 6f 6d 65 73 20 74 68 |tring be|comes th|
|00004f50| 65 20 6e 65 77 20 76 61 | 6c 75 65 20 6f 66 20 40 |e new va|lue of @|
|00004f60| 76 61 72 7b 74 61 72 67 | 65 74 7d 2e 0a 58 0a 58 |var{targ|et}..X.X|
|00004f70| 54 68 69 73 20 66 75 6e | 63 74 69 6f 6e 20 69 73 |This fun|ction is|
|00004f80| 20 70 65 63 75 6c 69 61 | 72 20 62 65 63 61 75 73 | peculia|r becaus|
|00004f90| 65 20 40 76 61 72 7b 74 | 61 72 67 65 74 7d 20 69 |e @var{t|arget} i|
|00004fa0| 73 20 6e 6f 74 20 73 69 | 6d 70 6c 79 0a 58 75 73 |s not si|mply.Xus|
|00004fb0| 65 64 20 74 6f 20 63 6f | 6d 70 75 74 65 20 61 20 |ed to co|mpute a |
|00004fc0| 76 61 6c 75 65 2c 20 61 | 6e 64 20 6e 6f 74 20 6a |value, a|nd not j|
|00004fd0| 75 73 74 20 61 6e 79 20 | 65 78 70 72 65 73 73 69 |ust any |expressi|
|00004fe0| 6f 6e 20 77 69 6c 6c 20 | 64 6f 3a 20 69 74 0a 58 |on will |do: it.X|
|00004ff0| 6d 75 73 74 20 62 65 20 | 61 20 76 61 72 69 61 62 |must be |a variab|
|00005000| 6c 65 2c 20 66 69 65 6c | 64 20 6f 72 20 61 72 72 |le, fiel|d or arr|
|00005010| 61 79 20 72 65 66 65 72 | 65 6e 63 65 2c 20 73 6f |ay refer|ence, so|
|00005020| 20 74 68 61 74 20 40 63 | 6f 64 65 7b 73 75 62 7d | that @c|ode{sub}|
|00005030| 20 63 61 6e 0a 58 73 74 | 6f 72 65 20 61 20 6d 6f | can.Xst|ore a mo|
|00005040| 64 69 66 69 65 64 20 76 | 61 6c 75 65 20 74 68 65 |dified v|alue the|
|00005050| 72 65 2e 20 20 49 66 20 | 74 68 69 73 20 61 72 67 |re. If |this arg|
|00005060| 75 6d 65 6e 74 20 69 73 | 20 6f 6d 69 74 74 65 64 |ument is| omitted|
|00005070| 2c 20 74 68 65 6e 20 74 | 68 65 0a 58 64 65 66 61 |, then t|he.Xdefa|
|00005080| 75 6c 74 20 69 73 20 74 | 6f 20 75 73 65 20 61 6e |ult is t|o use an|
|00005090| 64 20 61 6c 74 65 72 20 | 40 63 6f 64 65 7b 24 30 |d alter |@code{$0|
|000050a0| 7d 2e 0a 58 0a 58 46 6f | 72 20 65 78 61 6d 70 6c |}..X.XFo|r exampl|
|000050b0| 65 3a 40 72 65 66 69 6c | 6c 0a 58 0a 58 40 65 78 |e:@refil|l.X.X@ex|
|000050c0| 61 6d 70 6c 65 0a 58 73 | 74 72 20 3d 20 22 77 61 |ample.Xs|tr = "wa|
|000050d0| 74 65 72 2c 20 77 61 74 | 65 72 2c 20 65 76 65 72 |ter, wat|er, ever|
|000050e0| 79 77 68 65 72 65 22 0a | 58 73 75 62 28 2f 61 74 |ywhere".|Xsub(/at|
|000050f0| 2f 2c 20 22 69 74 68 22 | 2c 20 73 74 72 29 0a 58 |/, "ith"|, str).X|
|00005100| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 58 0a 58 |@end exa|mple.X.X|
|00005110| 40 6e 6f 69 6e 64 65 6e | 74 0a 58 73 65 74 73 20 |@noinden|t.Xsets |
|00005120| 40 63 6f 64 65 7b 73 74 | 72 7d 20 74 6f 20 40 77 |@code{st|r} to @w|
|00005130| 7b 40 63 6f 64 65 7b 22 | 77 69 74 68 65 72 2c 20 |{@code{"|wither, |
|00005140| 77 61 74 65 72 2c 20 65 | 76 65 72 79 77 68 65 72 |water, e|verywher|
|00005150| 65 22 7d 7d 2c 20 62 79 | 20 72 65 70 6c 61 63 69 |e"}}, by| replaci|
|00005160| 6e 67 20 74 68 65 0a 58 | 6c 65 66 74 6d 6f 73 74 |ng the.X|leftmost|
|00005170| 2c 20 6c 6f 6e 67 65 73 | 74 20 6f 63 63 75 72 72 |, longes|t occurr|
|00005180| 65 6e 63 65 20 6f 66 20 | 40 73 61 6d 70 7b 61 74 |ence of |@samp{at|
|00005190| 7d 20 77 69 74 68 20 40 | 73 61 6d 70 7b 69 74 68 |} with @|samp{ith|
|000051a0| 7d 2e 0a 58 0a 58 54 68 | 65 20 40 63 6f 64 65 7b |}..X.XTh|e @code{|
|000051b0| 73 75 62 7d 20 66 75 6e | 63 74 69 6f 6e 20 72 65 |sub} fun|ction re|
|000051c0| 74 75 72 6e 73 20 74 68 | 65 20 6e 75 6d 62 65 72 |turns th|e number|
|000051d0| 20 6f 66 20 73 75 62 73 | 74 69 74 75 74 69 6f 6e | of subs|titution|
|000051e0| 73 20 6d 61 64 65 20 28 | 65 69 74 68 65 72 0a 58 |s made (|either.X|
|000051f0| 6f 6e 65 20 6f 72 20 7a | 65 72 6f 29 2e 0a 58 0a |one or z|ero)..X.|
|00005200| 58 49 66 20 74 68 65 20 | 73 70 65 63 69 61 6c 20 |XIf the |special |
|00005210| 63 68 61 72 61 63 74 65 | 72 20 40 73 61 6d 70 7b |characte|r @samp{|
|00005220| 26 7d 20 61 70 70 65 61 | 72 73 20 69 6e 20 40 76 |&} appea|rs in @v|
|00005230| 61 72 7b 72 65 70 6c 61 | 63 65 6d 65 6e 74 7d 2c |ar{repla|cement},|
|00005240| 20 69 74 0a 58 73 74 61 | 6e 64 73 20 66 6f 72 20 | it.Xsta|nds for |
|00005250| 74 68 65 20 70 72 65 63 | 69 73 65 20 73 75 62 73 |the prec|ise subs|
|00005260| 74 72 69 6e 67 20 74 68 | 61 74 20 77 61 73 20 6d |tring th|at was m|
|00005270| 61 74 63 68 65 64 20 62 | 79 20 40 76 61 72 7b 72 |atched b|y @var{r|
|00005280| 65 67 65 78 70 7d 2e 20 | 20 28 49 66 0a 58 74 68 |egexp}. | (If.Xth|
|00005290| 65 20 72 65 67 65 78 70 | 20 63 61 6e 20 6d 61 74 |e regexp| can mat|
|000052a0| 63 68 20 6d 6f 72 65 20 | 74 68 61 6e 20 6f 6e 65 |ch more |than one|
|000052b0| 20 73 74 72 69 6e 67 2c | 20 74 68 65 6e 20 74 68 | string,| then th|
|000052c0| 69 73 20 70 72 65 63 69 | 73 65 20 73 75 62 73 74 |is preci|se subst|
|000052d0| 72 69 6e 67 0a 58 6d 61 | 79 20 76 61 72 79 2e 29 |ring.Xma|y vary.)|
|000052e0| 20 20 46 6f 72 20 65 78 | 61 6d 70 6c 65 3a 40 72 | For ex|ample:@r|
|000052f0| 65 66 69 6c 6c 0a 58 0a | 58 40 65 78 61 6d 70 6c |efill.X.|X@exampl|
|00005300| 65 0a 58 61 77 6b 20 27 | 40 7b 20 73 75 62 28 2f |e.Xawk '|@{ sub(/|
|00005310| 63 61 6e 64 69 64 61 74 | 65 2f 2c 20 22 26 20 61 |candidat|e/, "& a|
|00005320| 6e 64 20 68 69 73 20 77 | 69 66 65 22 29 3b 20 70 |nd his w|ife"); p|
|00005330| 72 69 6e 74 20 40 7d 27 | 0a 58 40 65 6e 64 20 65 |rint @}'|.X@end e|
|00005340| 78 61 6d 70 6c 65 0a 58 | 0a 58 40 6e 6f 69 6e 64 |xample.X|.X@noind|
|00005350| 65 6e 74 0a 58 63 68 61 | 6e 67 65 73 20 74 68 65 |ent.Xcha|nges the|
|00005360| 20 66 69 72 73 74 20 6f | 63 63 75 72 72 65 6e 63 | first o|ccurrenc|
|00005370| 65 20 6f 66 20 40 73 61 | 6d 70 7b 63 61 6e 64 69 |e of @sa|mp{candi|
|00005380| 64 61 74 65 7d 20 74 6f | 20 40 73 61 6d 70 7b 63 |date} to| @samp{c|
|00005390| 61 6e 64 69 64 61 74 65 | 0a 58 61 6e 64 20 68 69 |andidate|.Xand hi|
|000053a0| 73 20 77 69 66 65 7d 20 | 6f 6e 20 65 61 63 68 20 |s wife} |on each |
|000053b0| 69 6e 70 75 74 20 6c 69 | 6e 65 2e 0a 58 0a 58 54 |input li|ne..X.XT|
|000053c0| 68 65 20 65 66 66 65 63 | 74 20 6f 66 20 74 68 69 |he effec|t of thi|
|000053d0| 73 20 73 70 65 63 69 61 | 6c 20 63 68 61 72 61 63 |s specia|l charac|
|000053e0| 74 65 72 20 63 61 6e 20 | 62 65 20 74 75 72 6e 65 |ter can |be turne|
|000053f0| 64 20 6f 66 66 20 62 79 | 20 70 75 74 74 69 6e 67 |d off by| putting|
|00005400| 20 61 0a 58 62 61 63 6b | 73 6c 61 73 68 20 62 65 | a.Xback|slash be|
|00005410| 66 6f 72 65 20 69 74 20 | 69 6e 20 74 68 65 20 73 |fore it |in the s|
|00005420| 74 72 69 6e 67 2e 20 20 | 41 73 20 75 73 75 61 6c |tring. |As usual|
|00005430| 2c 20 74 6f 20 69 6e 73 | 65 72 74 20 6f 6e 65 20 |, to ins|ert one |
|00005440| 62 61 63 6b 73 6c 61 73 | 68 20 69 6e 0a 58 74 68 |backslas|h in.Xth|
|00005450| 65 20 73 74 72 69 6e 67 | 2c 20 79 6f 75 20 6d 75 |e string|, you mu|
|00005460| 73 74 20 77 72 69 74 65 | 20 74 77 6f 20 62 61 63 |st write| two bac|
|00005470| 6b 73 6c 61 73 68 65 73 | 2e 20 20 54 68 65 72 65 |kslashes|. There|
|00005480| 66 6f 72 65 2c 20 77 72 | 69 74 65 20 40 73 61 6d |fore, wr|ite @sam|
|00005490| 70 7b 5c 5c 26 7d 0a 58 | 69 6e 20 61 20 73 74 72 |p{\\&}.X|in a str|
|000054a0| 69 6e 67 20 63 6f 6e 73 | 74 61 6e 74 20 74 6f 20 |ing cons|tant to |
|000054b0| 69 6e 63 6c 75 64 65 20 | 61 20 6c 69 74 65 72 61 |include |a litera|
|000054c0| 6c 20 40 73 61 6d 70 7b | 26 7d 20 69 6e 20 74 68 |l @samp{|&} in th|
|000054d0| 65 20 72 65 70 6c 61 63 | 65 6d 65 6e 74 2e 0a 58 |e replac|ement..X|
|000054e0| 46 6f 72 20 65 78 61 6d | 70 6c 65 2c 20 68 65 72 |For exam|ple, her|
|000054f0| 65 20 69 73 20 68 6f 77 | 20 74 6f 20 72 65 70 6c |e is how| to repl|
|00005500| 61 63 65 20 74 68 65 20 | 66 69 72 73 74 20 40 73 |ace the |first @s|
|00005510| 61 6d 70 7b 7c 7d 20 6f | 6e 20 65 61 63 68 20 6c |amp{|} o|n each l|
|00005520| 69 6e 65 20 77 69 74 68 | 0a 58 61 6e 20 40 73 61 |ine with|.Xan @sa|
|00005530| 6d 70 7b 26 7d 3a 40 72 | 65 66 69 6c 6c 0a 58 0a |mp{&}:@r|efill.X.|
|00005540| 58 40 65 78 61 6d 70 6c | 65 0a 58 61 77 6b 20 27 |X@exampl|e.Xawk '|
|00005550| 40 7b 20 73 75 62 28 2f | 5c 7c 2f 2c 20 22 5c 5c |@{ sub(/|\|/, "\\|
|00005560| 26 22 29 3b 20 70 72 69 | 6e 74 20 40 7d 27 0a 58 |&"); pri|nt @}'.X|
|00005570| 40 65 6e 64 20 65 78 61 | 6d 70 6c 65 0a 58 0a 58 |@end exa|mple.X.X|
|00005580| 40 73 74 72 6f 6e 67 7b | 4e 6f 74 65 3a 7d 20 61 |@strong{|Note:} a|
|00005590| 73 20 6d 65 6e 74 69 6f | 6e 65 64 20 61 62 6f 76 |s mentio|ned abov|
|000055a0| 65 2c 20 74 68 65 20 74 | 68 69 72 64 20 61 72 67 |e, the t|hird arg|
|000055b0| 75 6d 65 6e 74 20 74 6f | 20 40 63 6f 64 65 7b 73 |ument to| @code{s|
|000055c0| 75 62 7d 20 6d 75 73 74 | 0a 58 62 65 20 61 6e 20 |ub} must|.Xbe an |
|000055d0| 6c 76 61 6c 75 65 2e 20 | 20 53 6f 6d 65 20 76 65 |lvalue. | Some ve|
|000055e0| 72 73 69 6f 6e 73 20 6f | 66 20 40 63 6f 64 65 7b |rsions o|f @code{|
|000055f0| 61 77 6b 7d 20 61 6c 6c | 6f 77 20 74 68 65 20 74 |awk} all|ow the t|
|00005600| 68 69 72 64 20 61 72 67 | 75 6d 65 6e 74 20 74 6f |hird arg|ument to|
|00005610| 0a 58 62 65 20 61 6e 20 | 65 78 70 72 65 73 73 69 |.Xbe an |expressi|
|00005620| 6f 6e 20 77 68 69 63 68 | 20 69 73 20 6e 6f 74 20 |on which| is not |
|00005630| 61 6e 20 6c 76 61 6c 75 | 65 2e 20 20 49 6e 20 73 |an lvalu|e. In s|
|00005640| 75 63 68 20 61 20 63 61 | 73 65 2c 20 40 63 6f 64 |uch a ca|se, @cod|
|00005650| 65 7b 73 75 62 7d 0a 58 | 77 6f 75 6c 64 20 73 74 |e{sub}.X|would st|
|00005660| 69 6c 6c 20 73 65 61 72 | 63 68 20 66 6f 72 20 74 |ill sear|ch for t|
|00005670| 68 65 20 70 61 74 74 65 | 72 6e 20 61 6e 64 20 72 |he patte|rn and r|
|00005680| 65 74 75 72 6e 20 30 20 | 6f 72 20 31 2c 20 62 75 |eturn 0 |or 1, bu|
|00005690| 74 20 74 68 65 20 72 65 | 73 75 6c 74 20 6f 66 0a |t the re|sult of.|
|000056a0| 58 74 68 65 20 73 75 62 | 73 74 69 74 75 74 69 6f |Xthe sub|stitutio|
|000056b0| 6e 20 28 69 66 20 61 6e | 79 29 20 77 6f 75 6c 64 |n (if an|y) would|
|000056c0| 20 62 65 20 74 68 72 6f | 77 6e 20 61 77 61 79 20 | be thro|wn away |
|000056d0| 62 65 63 61 75 73 65 20 | 74 68 65 72 65 20 69 73 |because |there is|
|000056e0| 20 6e 6f 20 70 6c 61 63 | 65 0a 58 74 6f 20 70 75 | no plac|e.Xto pu|
|000056f0| 74 20 69 74 2e 20 20 53 | 75 63 68 20 76 65 72 73 |t it. S|uch vers|
|00005700| 69 6f 6e 73 20 6f 66 20 | 40 63 6f 64 65 7b 61 77 |ions of |@code{aw|
|00005710| 6b 7d 20 61 63 63 65 70 | 74 20 65 78 70 72 65 73 |k} accep|t expres|
|00005720| 73 69 6f 6e 73 20 6c 69 | 6b 65 0a 58 74 68 69 73 |sions li|ke.Xthis|
|00005730| 3a 40 72 65 66 69 6c 6c | 0a 58 0a 58 40 65 78 61 |:@refill|.X.X@exa|
|00005740| 6d 70 6c 65 0a 58 73 75 | 62 28 2f 55 53 41 2f 2c |mple.Xsu|b(/USA/,|
|00005750| 20 22 55 6e 69 74 65 64 | 20 53 74 61 74 65 73 22 | "United| States"|
|00005760| 2c 20 22 74 68 65 20 55 | 53 41 20 61 6e 64 20 43 |, "the U|SA and C|
|00005770| 61 6e 61 64 61 22 29 0a | 58 40 65 6e 64 20 65 78 |anada").|X@end ex|
|00005780| 61 6d 70 6c 65 0a 58 0a | 58 40 6e 6f 69 6e 64 65 |ample.X.|X@noinde|
|00005790| 6e 74 0a 58 42 75 74 20 | 74 68 61 74 20 69 73 20 |nt.XBut |that is |
|000057a0| 63 6f 6e 73 69 64 65 72 | 65 64 20 65 72 72 6f 6e |consider|ed erron|
|000057b0| 65 6f 75 73 20 69 6e 20 | 40 63 6f 64 65 7b 67 61 |eous in |@code{ga|
|000057c0| 77 6b 7d 2e 0a 58 0a 58 | 40 69 74 65 6d 20 67 73 |wk}..X.X|@item gs|
|000057d0| 75 62 28 40 76 61 72 7b | 72 65 67 65 78 70 7d 2c |ub(@var{|regexp},|
|000057e0| 20 40 76 61 72 7b 72 65 | 70 6c 61 63 65 6d 65 6e | @var{re|placemen|
|000057f0| 74 7d 2c 20 40 76 61 72 | 7b 74 61 72 67 65 74 7d |t}, @var|{target}|
|00005800| 29 0a 58 40 66 69 6e 64 | 65 78 20 67 73 75 62 0a |).X@find|ex gsub.|
|00005810| 58 54 68 69 73 20 69 73 | 20 73 69 6d 69 6c 61 72 |XThis is| similar|
|00005820| 20 74 6f 20 74 68 65 20 | 40 63 6f 64 65 7b 73 75 | to the |@code{su|
|00005830| 62 7d 20 66 75 6e 63 74 | 69 6f 6e 2c 20 65 78 63 |b} funct|ion, exc|
|00005840| 65 70 74 20 40 63 6f 64 | 65 7b 67 73 75 62 7d 20 |ept @cod|e{gsub} |
|00005850| 72 65 70 6c 61 63 65 73 | 0a 58 40 65 6d 70 68 7b |replaces|.X@emph{|
|00005860| 61 6c 6c 7d 20 6f 66 20 | 74 68 65 20 6c 6f 6e 67 |all} of |the long|
|00005870| 65 73 74 2c 20 6c 65 66 | 74 6d 6f 73 74 2c 20 40 |est, lef|tmost, @|
|00005880| 65 6d 70 68 7b 6e 6f 6e | 6f 76 65 72 6c 61 70 70 |emph{non|overlapp|
|00005890| 69 6e 67 7d 20 6d 61 74 | 63 68 69 6e 67 0a 58 73 |ing} mat|ching.Xs|
|000058a0| 75 62 73 74 72 69 6e 67 | 73 20 69 74 20 63 61 6e |ubstring|s it can|
|000058b0| 20 66 69 6e 64 2e 20 20 | 54 68 65 20 40 73 61 6d | find. |The @sam|
|000058c0| 70 7b 67 7d 20 69 6e 20 | 40 63 6f 64 65 7b 67 73 |p{g} in |@code{gs|
|000058d0| 75 62 7d 20 73 74 61 6e | 64 73 20 66 6f 72 0a 58 |ub} stan|ds for.X|
|000058e0| 60 60 67 6c 6f 62 61 6c | 27 27 2c 20 77 68 69 63 |``global|'', whic|
|000058f0| 68 20 6d 65 61 6e 73 20 | 72 65 70 6c 61 63 65 20 |h means |replace |
|00005900| 65 76 65 72 79 77 68 65 | 72 65 2e 20 20 46 6f 72 |everywhe|re. For|
|00005910| 20 65 78 61 6d 70 6c 65 | 3a 40 72 65 66 69 6c 6c | example|:@refill|
|00005920| 0a 58 0a 58 40 65 78 61 | 6d 70 6c 65 0a 58 61 77 |.X.X@exa|mple.Xaw|
|00005930| 6b 20 27 40 7b 20 67 73 | 75 62 28 2f 42 72 69 74 |k '@{ gs|ub(/Brit|
|00005940| 61 69 6e 2f 2c 20 22 55 | 6e 69 74 65 64 20 4b 69 |ain/, "U|nited Ki|
|00005950| 6e 67 64 6f 6d 22 29 3b | 20 70 72 69 6e 74 20 40 |ngdom");| print @|
|00005960| 7d 27 0a 58 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |}'.X@end| example|
|00005970| 0a 58 0a 58 40 6e 6f 69 | 6e 64 65 6e 74 0a 58 72 |.X.X@noi|ndent.Xr|
|00005980| 65 70 6c 61 63 65 73 20 | 61 6c 6c 20 6f 63 63 75 |eplaces |all occu|
|00005990| 72 72 65 6e 63 65 73 20 | 6f 66 20 74 68 65 20 73 |rrences |of the s|
|000059a0| 74 72 69 6e 67 20 40 73 | 61 6d 70 7b 42 72 69 74 |tring @s|amp{Brit|
|000059b0| 61 69 6e 7d 20 77 69 74 | 68 20 40 73 61 6d 70 7b |ain} wit|h @samp{|
|000059c0| 55 6e 69 74 65 64 0a 58 | 4b 69 6e 67 64 6f 6d 7d |United.X|Kingdom}|
|000059d0| 20 66 6f 72 20 61 6c 6c | 20 69 6e 70 75 74 20 72 | for all| input r|
|000059e0| 65 63 6f 72 64 73 2e 40 | 72 65 66 69 6c 6c 0a 58 |ecords.@|refill.X|
|000059f0| 0a 58 54 68 65 20 40 63 | 6f 64 65 7b 67 73 75 62 |.XThe @c|ode{gsub|
|00005a00| 7d 20 66 75 6e 63 74 69 | 6f 6e 20 72 65 74 75 72 |} functi|on retur|
|00005a10| 6e 73 20 74 68 65 20 6e | 75 6d 62 65 72 20 6f 66 |ns the n|umber of|
|00005a20| 20 73 75 62 73 74 69 74 | 75 74 69 6f 6e 73 20 6d | substit|utions m|
|00005a30| 61 64 65 2e 20 20 49 66 | 0a 58 74 68 65 20 76 61 |ade. If|.Xthe va|
|00005a40| 72 69 61 62 6c 65 20 74 | 6f 20 62 65 20 73 65 61 |riable t|o be sea|
|00005a50| 72 63 68 65 64 20 61 6e | 64 20 61 6c 74 65 72 65 |rched an|d altere|
|00005a60| 64 2c 20 40 76 61 72 7b | 74 61 72 67 65 74 7d 2c |d, @var{|target},|
|00005a70| 20 69 73 0a 58 6f 6d 69 | 74 74 65 64 2c 20 74 68 | is.Xomi|tted, th|
|00005a80| 65 6e 20 74 68 65 20 65 | 6e 74 69 72 65 20 69 6e |en the e|ntire in|
|00005a90| 70 75 74 20 72 65 63 6f | 72 64 2c 20 40 63 6f 64 |put reco|rd, @cod|
|00005aa0| 65 7b 24 30 7d 2c 20 69 | 73 20 75 73 65 64 2e 40 |e{$0}, i|s used.@|
|00005ab0| 72 65 66 69 6c 6c 0a 58 | 0a 58 41 73 20 69 6e 20 |refill.X|.XAs in |
|00005ac0| 40 63 6f 64 65 7b 73 75 | 62 7d 2c 20 74 68 65 20 |@code{su|b}, the |
|00005ad0| 63 68 61 72 61 63 74 65 | 72 73 20 40 73 61 6d 70 |characte|rs @samp|
|00005ae0| 7b 26 7d 20 61 6e 64 20 | 40 73 61 6d 70 7b 5c 7d |{&} and |@samp{\}|
|00005af0| 20 61 72 65 20 73 70 65 | 63 69 61 6c 2c 20 61 6e | are spe|cial, an|
|00005b00| 64 0a 58 74 68 65 20 74 | 68 69 72 64 20 61 72 67 |d.Xthe t|hird arg|
|00005b10| 75 6d 65 6e 74 20 6d 75 | 73 74 20 62 65 20 61 6e |ument mu|st be an|
|00005b20| 20 6c 76 61 6c 75 65 2e | 0a 58 0a 58 40 69 74 65 | lvalue.|.X.X@ite|
|00005b30| 6d 20 73 75 62 73 74 72 | 28 40 76 61 72 7b 73 74 |m substr|(@var{st|
|00005b40| 72 69 6e 67 7d 2c 20 40 | 76 61 72 7b 73 74 61 72 |ring}, @|var{star|
|00005b50| 74 7d 2c 20 40 76 61 72 | 7b 6c 65 6e 67 74 68 7d |t}, @var|{length}|
|00005b60| 29 0a 58 40 66 69 6e 64 | 65 78 20 73 75 62 73 74 |).X@find|ex subst|
|00005b70| 72 0a 58 54 68 69 73 20 | 72 65 74 75 72 6e 73 20 |r.XThis |returns |
|00005b80| 61 20 40 76 61 72 7b 6c | 65 6e 67 74 68 7d 2d 63 |a @var{l|ength}-c|
|00005b90| 68 61 72 61 63 74 65 72 | 2d 6c 6f 6e 67 20 73 75 |haracter|-long su|
|00005ba0| 62 73 74 72 69 6e 67 20 | 6f 66 20 40 76 61 72 7b |bstring |of @var{|
|00005bb0| 73 74 72 69 6e 67 7d 2c | 0a 58 73 74 61 72 74 69 |string},|.Xstarti|
|00005bc0| 6e 67 20 61 74 20 63 68 | 61 72 61 63 74 65 72 20 |ng at ch|aracter |
|00005bd0| 6e 75 6d 62 65 72 20 40 | 76 61 72 7b 73 74 61 72 |number @|var{star|
|00005be0| 74 7d 2e 20 20 54 68 65 | 20 66 69 72 73 74 20 63 |t}. The| first c|
|00005bf0| 68 61 72 61 63 74 65 72 | 20 6f 66 20 61 0a 58 73 |haracter| of a.Xs|
|00005c00| 74 72 69 6e 67 20 69 73 | 20 63 68 61 72 61 63 74 |tring is| charact|
|00005c10| 65 72 20 6e 75 6d 62 65 | 72 20 6f 6e 65 2e 20 20 |er numbe|r one. |
|00005c20| 46 6f 72 20 65 78 61 6d | 70 6c 65 2c 0a 58 40 63 |For exam|ple,.X@c|
|00005c30| 6f 64 65 7b 73 75 62 73 | 74 72 28 22 77 61 73 68 |ode{subs|tr("wash|
|00005c40| 69 6e 67 74 6f 6e 22 2c | 20 35 2c 20 33 29 7d 20 |ington",| 5, 3)} |
|00005c50| 72 65 74 75 72 6e 73 20 | 40 63 6f 64 65 7b 22 69 |returns |@code{"i|
|00005c60| 6e 67 22 7d 2e 40 72 65 | 66 69 6c 6c 0a 58 0a 58 |ng"}.@re|fill.X.X|
|00005c70| 49 66 20 40 76 61 72 7b | 6c 65 6e 67 74 68 7d 20 |If @var{|length} |
|00005c80| 69 73 20 6e 6f 74 20 70 | 72 65 73 65 6e 74 2c 20 |is not p|resent, |
|00005c90| 74 68 69 73 20 66 75 6e | 63 74 69 6f 6e 20 72 65 |this fun|ction re|
|00005ca0| 74 75 72 6e 73 20 74 68 | 65 20 77 68 6f 6c 65 20 |turns th|e whole |
|00005cb0| 73 75 66 66 69 78 20 6f | 66 0a 58 40 76 61 72 7b |suffix o|f.X@var{|
|00005cc0| 73 74 72 69 6e 67 7d 20 | 74 68 61 74 20 62 65 67 |string} |that beg|
|00005cd0| 69 6e 73 20 61 74 20 63 | 68 61 72 61 63 74 65 72 |ins at c|haracter|
|00005ce0| 20 6e 75 6d 62 65 72 20 | 40 76 61 72 7b 73 74 61 | number |@var{sta|
|00005cf0| 72 74 7d 2e 20 20 46 6f | 72 20 65 78 61 6d 70 6c |rt}. Fo|r exampl|
|00005d00| 65 2c 0a 58 40 63 6f 64 | 65 7b 73 75 62 73 74 72 |e,.X@cod|e{substr|
|00005d10| 28 22 77 61 73 68 69 6e | 67 74 6f 6e 22 2c 20 35 |("washin|gton", 5|
|00005d20| 29 7d 20 72 65 74 75 72 | 6e 73 20 40 63 6f 64 65 |)} retur|ns @code|
|00005d30| 7b 22 69 6e 67 74 6f 6e | 22 7d 2e 0a 58 0a 58 40 |{"ington|"}..X.X@|
|00005d40| 69 74 65 6d 20 74 6f 6c | 6f 77 65 72 28 40 76 61 |item tol|ower(@va|
|00005d50| 72 7b 73 74 72 69 6e 67 | 7d 29 0a 58 40 66 69 6e |r{string|}).X@fin|
|00005d60| 64 65 78 20 74 6f 6c 6f | 77 65 72 0a 58 54 68 69 |dex tolo|wer.XThi|
|00005d70| 73 20 72 65 74 75 72 6e | 73 20 61 20 63 6f 70 79 |s return|s a copy|
|00005d80| 20 6f 66 20 40 76 61 72 | 7b 73 74 72 69 6e 67 7d | of @var|{string}|
|00005d90| 2c 20 77 69 74 68 20 65 | 61 63 68 20 75 70 70 65 |, with e|ach uppe|
|00005da0| 72 2d 63 61 73 65 20 63 | 68 61 72 61 63 74 65 72 |r-case c|haracter|
|00005db0| 0a 58 69 6e 20 74 68 65 | 20 73 74 72 69 6e 67 20 |.Xin the| string |
|00005dc0| 72 65 70 6c 61 63 65 64 | 20 77 69 74 68 20 69 74 |replaced| with it|
|00005dd0| 73 20 63 6f 72 72 65 73 | 70 6f 6e 64 69 6e 67 20 |s corres|ponding |
|00005de0| 6c 6f 77 65 72 2d 63 61 | 73 65 20 63 68 61 72 61 |lower-ca|se chara|
|00005df0| 63 74 65 72 2e 0a 58 4e | 6f 6e 61 6c 70 68 61 62 |cter..XN|onalphab|
|00005e00| 65 74 69 63 20 63 68 61 | 72 61 63 74 65 72 73 20 |etic cha|racters |
|00005e10| 61 72 65 20 6c 65 66 74 | 20 75 6e 63 68 61 6e 67 |are left| unchang|
|00005e20| 65 64 2e 20 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |ed. For| example|
|00005e30| 2c 0a 58 40 63 6f 64 65 | 7b 74 6f 6c 6f 77 65 72 |,.X@code|{tolower|
|00005e40| 28 22 4d 69 58 65 44 20 | 63 41 73 45 20 31 32 33 |("MiXeD |cAsE 123|
|00005e50| 22 29 7d 20 72 65 74 75 | 72 6e 73 20 40 63 6f 64 |")} retu|rns @cod|
|00005e60| 65 7b 22 6d 69 78 65 64 | 20 63 61 73 65 20 31 32 |e{"mixed| case 12|
|00005e70| 33 22 7d 2e 0a 58 0a 58 | 40 69 74 65 6d 20 74 6f |3"}..X.X|@item to|
|00005e80| 75 70 70 65 72 28 40 76 | 61 72 7b 73 74 72 69 6e |upper(@v|ar{strin|
|00005e90| 67 7d 29 0a 58 40 66 69 | 6e 64 65 78 20 74 6f 75 |g}).X@fi|ndex tou|
|00005ea0| 70 70 65 72 0a 58 54 68 | 69 73 20 72 65 74 75 72 |pper.XTh|is retur|
|00005eb0| 6e 73 20 61 20 63 6f 70 | 79 20 6f 66 20 40 76 61 |ns a cop|y of @va|
|00005ec0| 72 7b 73 74 72 69 6e 67 | 7d 2c 20 77 69 74 68 20 |r{string|}, with |
|00005ed0| 65 61 63 68 20 6c 6f 77 | 65 72 2d 63 61 73 65 20 |each low|er-case |
|00005ee0| 63 68 61 72 61 63 74 65 | 72 0a 58 69 6e 20 74 68 |characte|r.Xin th|
|00005ef0| 65 20 73 74 72 69 6e 67 | 20 72 65 70 6c 61 63 65 |e string| replace|
|00005f00| 64 20 77 69 74 68 20 69 | 74 73 20 63 6f 72 72 65 |d with i|ts corre|
|00005f10| 73 70 6f 6e 64 69 6e 67 | 20 75 70 70 65 72 2d 63 |sponding| upper-c|
|00005f20| 61 73 65 20 63 68 61 72 | 61 63 74 65 72 2e 0a 58 |ase char|acter..X|
|00005f30| 4e 6f 6e 61 6c 70 68 61 | 62 65 74 69 63 20 63 68 |Nonalpha|betic ch|
|00005f40| 61 72 61 63 74 65 72 73 | 20 61 72 65 20 6c 65 66 |aracters| are lef|
|00005f50| 74 20 75 6e 63 68 61 6e | 67 65 64 2e 20 20 46 6f |t unchan|ged. Fo|
|00005f60| 72 20 65 78 61 6d 70 6c | 65 2c 0a 58 40 63 6f 64 |r exampl|e,.X@cod|
|00005f70| 65 7b 74 6f 75 70 70 65 | 72 28 22 4d 69 58 65 44 |e{touppe|r("MiXeD|
|00005f80| 20 63 41 73 45 20 31 32 | 33 22 29 7d 20 72 65 74 | cAsE 12|3")} ret|
|00005f90| 75 72 6e 73 20 40 63 6f | 64 65 7b 22 4d 49 58 45 |urns @co|de{"MIXE|
|00005fa0| 44 20 43 41 53 45 20 31 | 32 33 22 7d 2e 0a 58 40 |D CASE 1|23"}..X@|
|00005fb0| 65 6e 64 20 74 61 62 6c | 65 0a 58 0a 58 40 6e 6f |end tabl|e.X.X@no|
|00005fc0| 64 65 20 49 2f 4f 20 46 | 75 6e 63 74 69 6f 6e 73 |de I/O F|unctions|
|00005fd0| 2c 20 2c 20 53 74 72 69 | 6e 67 20 46 75 6e 63 74 |, , Stri|ng Funct|
|00005fe0| 69 6f 6e 73 2c 20 42 75 | 69 6c 74 2d 69 6e 0a 58 |ions, Bu|ilt-in.X|
|00005ff0| 40 73 65 63 74 69 6f 6e | 20 42 75 69 6c 74 2d 69 |@section| Built-i|
|00006000| 6e 20 46 75 6e 63 74 69 | 6f 6e 73 20 46 6f 72 20 |n Functi|ons For |
|00006010| 49 6e 70 75 74 2f 4f 75 | 74 70 75 74 0a 58 0a 58 |Input/Ou|tput.X.X|
|00006020| 40 74 61 62 6c 65 20 40 | 63 6f 64 65 0a 58 40 69 |@table @|code.X@i|
|00006030| 74 65 6d 20 63 6c 6f 73 | 65 28 40 76 61 72 7b 66 |tem clos|e(@var{f|
|00006040| 69 6c 65 6e 61 6d 65 7d | 29 0a 58 43 6c 6f 73 65 |ilename}|).XClose|
|00006050| 20 74 68 65 20 66 69 6c | 65 20 40 76 61 72 7b 66 | the fil|e @var{f|
|00006060| 69 6c 65 6e 61 6d 65 7d | 2c 20 66 6f 72 20 69 6e |ilename}|, for in|
|00006070| 70 75 74 20 6f 72 20 6f | 75 74 70 75 74 2e 20 20 |put or o|utput. |
|00006080| 54 68 65 20 61 72 67 75 | 6d 65 6e 74 20 6d 61 79 |The argu|ment may|
|00006090| 0a 58 61 6c 74 65 72 6e | 61 74 69 76 65 6c 79 20 |.Xaltern|atively |
|000060a0| 62 65 20 61 20 73 68 65 | 6c 6c 20 63 6f 6d 6d 61 |be a she|ll comma|
|000060b0| 6e 64 20 74 68 61 74 20 | 77 61 73 20 75 73 65 64 |nd that |was used|
|000060c0| 20 66 6f 72 20 72 65 64 | 69 72 65 63 74 69 6e 67 | for red|irecting|
|000060d0| 20 74 6f 20 6f 72 0a 58 | 66 72 6f 6d 20 61 20 70 | to or.X|from a p|
|000060e0| 69 70 65 3b 20 74 68 65 | 6e 20 74 68 65 20 70 69 |ipe; the|n the pi|
|000060f0| 70 65 20 69 73 20 63 6c | 6f 73 65 64 2e 0a 58 0a |pe is cl|osed..X.|
|00006100| 58 40 78 72 65 66 7b 43 | 6c 6f 73 65 20 49 6e 70 |X@xref{C|lose Inp|
|00006110| 75 74 7d 2c 20 72 65 67 | 61 72 64 69 6e 67 20 63 |ut}, reg|arding c|
|00006120| 6c 6f 73 69 6e 67 20 69 | 6e 70 75 74 20 66 69 6c |losing i|nput fil|
|00006130| 65 73 20 61 6e 64 20 70 | 69 70 65 73 2e 0a 58 40 |es and p|ipes..X@|
|00006140| 78 72 65 66 7b 43 6c 6f | 73 65 20 4f 75 74 70 75 |xref{Clo|se Outpu|
|00006150| 74 7d 2c 20 72 65 67 61 | 72 64 69 6e 67 20 63 6c |t}, rega|rding cl|
|00006160| 6f 73 69 6e 67 20 6f 75 | 74 70 75 74 20 66 69 6c |osing ou|tput fil|
|00006170| 65 73 20 61 6e 64 20 70 | 69 70 65 73 2e 0a 58 0a |es and p|ipes..X.|
|00006180| 58 40 69 74 65 6d 20 73 | 79 73 74 65 6d 28 40 76 |X@item s|ystem(@v|
|00006190| 61 72 7b 63 6f 6d 6d 61 | 6e 64 7d 29 0a 58 40 66 |ar{comma|nd}).X@f|
|000061a0| 69 6e 64 65 78 20 73 79 | 73 74 65 6d 0a 58 40 63 |index sy|stem.X@c|
|000061b0| 69 6e 64 65 78 20 69 6e | 74 65 72 61 63 74 69 6f |index in|teractio|
|000061c0| 6e 20 6f 66 20 40 63 6f | 64 65 7b 61 77 6b 7d 20 |n of @co|de{awk} |
|000061d0| 77 69 74 68 20 6f 74 68 | 65 72 20 70 72 6f 67 72 |with oth|er progr|
|000061e0| 61 6d 73 0a 58 54 68 65 | 20 73 79 73 74 65 6d 20 |ams.XThe| system |
|000061f0| 66 75 6e 63 74 69 6f 6e | 20 61 6c 6c 6f 77 73 20 |function| allows |
|00006200| 74 68 65 20 75 73 65 72 | 20 74 6f 20 65 78 65 63 |the user| to exec|
|00006210| 75 74 65 20 6f 70 65 72 | 61 74 69 6e 67 20 73 79 |ute oper|ating sy|
|00006220| 73 74 65 6d 20 63 6f 6d | 6d 61 6e 64 73 0a 58 61 |stem com|mands.Xa|
|00006230| 6e 64 20 74 68 65 6e 20 | 72 65 74 75 72 6e 20 74 |nd then |return t|
|00006240| 6f 20 74 68 65 20 40 63 | 6f 64 65 7b 61 77 6b 7d |o the @c|ode{awk}|
|00006250| 20 70 72 6f 67 72 61 6d | 2e 20 20 54 68 65 20 40 | program|. The @|
|00006260| 63 6f 64 65 7b 73 79 73 | 74 65 6d 7d 20 66 75 6e |code{sys|tem} fun|
|00006270| 63 74 69 6f 6e 0a 58 65 | 78 65 63 75 74 65 73 20 |ction.Xe|xecutes |
|00006280| 74 68 65 20 63 6f 6d 6d | 61 6e 64 20 67 69 76 65 |the comm|and give|
|00006290| 6e 20 62 79 20 74 68 65 | 20 73 74 72 69 6e 67 20 |n by the| string |
|000062a0| 40 76 61 72 7b 63 6f 6d | 6d 61 6e 64 7d 2e 20 20 |@var{com|mand}. |
|000062b0| 49 74 20 72 65 74 75 72 | 6e 73 2c 20 61 73 0a 58 |It retur|ns, as.X|
|000062c0| 69 74 73 20 76 61 6c 75 | 65 2c 20 74 68 65 20 73 |its valu|e, the s|
|000062d0| 74 61 74 75 73 20 72 65 | 74 75 72 6e 65 64 20 62 |tatus re|turned b|
|000062e0| 79 20 74 68 65 20 63 6f | 6d 6d 61 6e 64 20 74 68 |y the co|mmand th|
|000062f0| 61 74 20 77 61 73 20 65 | 78 65 63 75 74 65 64 2e |at was e|xecuted.|
|00006300| 0a 58 0a 58 46 6f 72 20 | 65 78 61 6d 70 6c 65 2c |.X.XFor |example,|
|00006310| 20 69 66 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | if the |followin|
|00006320| 67 20 66 72 61 67 6d 65 | 6e 74 20 6f 66 20 63 6f |g fragme|nt of co|
|00006330| 64 65 20 69 73 20 70 75 | 74 20 69 6e 20 79 6f 75 |de is pu|t in you|
|00006340| 72 20 40 63 6f 64 65 7b | 61 77 6b 7d 0a 58 70 72 |r @code{|awk}.Xpr|
|00006350| 6f 67 72 61 6d 3a 0a 58 | 0a 58 40 65 78 61 6d 70 |ogram:.X|.X@examp|
|00006360| 6c 65 0a 58 45 4e 44 20 | 40 7b 0a 58 20 20 20 20 |le.XEND |@{.X |
|00006370| 20 73 79 73 74 65 6d 28 | 22 6d 61 69 6c 20 2d 73 | system(|"mail -s|
|00006380| 20 27 61 77 6b 20 72 75 | 6e 20 64 6f 6e 65 27 20 | 'awk ru|n done' |
|00006390| 6f 70 65 72 61 74 6f 72 | 20 3c 20 2f 64 65 76 2f |operator| < /dev/|
|000063a0| 6e 75 6c 6c 22 29 0a 58 | 40 7d 0a 58 40 65 6e 64 |null").X|@}.X@end|
|000063b0| 20 65 78 61 6d 70 6c 65 | 0a 58 0a 58 40 6e 6f 69 | example|.X.X@noi|
|000063c0| 6e 64 65 6e 74 0a 58 74 | 68 65 20 73 79 73 74 65 |ndent.Xt|he syste|
|000063d0| 6d 20 6f 70 65 72 61 74 | 6f 72 20 77 69 6c 6c 20 |m operat|or will |
|000063e0| 62 65 20 73 65 6e 74 20 | 6d 61 69 6c 20 77 68 65 |be sent |mail whe|
|000063f0| 6e 20 74 68 65 20 40 63 | 6f 64 65 7b 61 77 6b 7d |n the @c|ode{awk}|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
