home *** CD-ROM | disk | FTP | other *** search
| MacBinary | 1994-08-16 | 176.4 KB | [TEXT/ALFA] |
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: MacBinary
(archive/macBinary).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 10%
| dexvert
| MacBinary (archive/macBinary)
| fallback
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| MacBinary II, inited, Tue Aug 16 21:51:04 1994, modified Tue Aug 16 21:51:04 1994, creator Alpha editor, type ASCII, 173508 bytes "Tcl Commands" , at 0x2a644 6835 bytes resource
| default (weak)
| |
| 99%
| file
| data
| default
| |
| 74%
| TrID
| Macintosh plain text (MacBinary)
| default
| |
| 25%
| TrID
| MacBinary 2
| default (weak)
| |
| 100%
| siegfried
| fmt/1762 MacBinary (II)
| default
| |
| 100%
| lsar
| MacBinary
| default
|
|
| id metadata |
|---|
| key | value |
|---|
| macFileType | [TEXT] |
| macFileCreator | [ALFA] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0c 54 63 6c 20 43 6f | 6d 6d 61 6e 64 73 00 00 |..Tcl Co|mmands..|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 41 4c 46 | 41 01 00 00 00 00 00 00 |.TEXTALF|A.......|
|00000050| 00 00 00 00 02 a5 c4 00 | 00 1a b3 aa 77 1d 88 aa |........|....w...|
|00000060| 77 1d 88 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |w.......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 ba 76 00 00 |........|.....v..|
|00000080| 0d 0d 0d 54 63 6c 28 6e | 29 20 20 20 20 20 20 20 |...Tcl(n|) |
|00000090| 20 20 20 20 20 20 20 20 | 20 54 63 6c 20 42 75 69 | | Tcl Bui|
|000000a0| 6c 74 2d 49 6e 20 43 6f | 6d 6d 61 6e 64 73 20 20 |lt-In Co|mmands |
|000000b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 54 63 | | Tc|
|000000c0| 6c 28 6e 29 0d 0d 0d 0d | 5f 5f 5f 5f 5f 5f 5f 5f |l(n)....|________|
|000000d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000000e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000000f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000100| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 0d 0d 4e 41 4d 45 0d |________|_..NAME.|
|00000110| 20 20 20 20 20 54 63 6c | 20 2d 20 53 75 6d 6d 61 | Tcl| - Summa|
|00000120| 72 79 20 6f 66 20 54 63 | 6c 20 6c 61 6e 67 75 61 |ry of Tc|l langua|
|00000130| 67 65 20 73 79 6e 74 61 | 78 2e 0d 5f 5f 5f 5f 5f |ge synta|x.._____|
|00000140| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000150| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000160| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000170| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 0d 0d 44 |________|____...D|
|00000180| 45 53 43 52 49 50 54 49 | 4f 4e 0d 20 20 20 20 20 |ESCRIPTI|ON. |
|00000190| 54 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 72 75 |The foll|owing ru|
|000001a0| 6c 65 73 20 64 65 66 69 | 6e 65 20 74 68 65 20 73 |les defi|ne the s|
|000001b0| 79 6e 74 61 78 20 61 6e | 64 20 73 65 6d 61 6e 74 |yntax an|d semant|
|000001c0| 69 63 73 20 20 6f 66 20 | 20 74 68 65 0d 20 20 20 |ics of | the. |
|000001d0| 20 20 54 63 6c 20 6c 61 | 6e 67 75 61 67 65 3a 0d | Tcl la|nguage:.|
|000001e0| 0d 20 20 20 20 20 5b 31 | 5d 20 20 41 20 54 63 6c |. [1|] A Tcl|
|000001f0| 20 73 63 72 69 70 74 20 | 69 73 20 61 20 73 74 72 | script |is a str|
|00000200| 69 6e 67 20 63 6f 6e 74 | 61 69 6e 69 6e 67 20 6f |ing cont|aining o|
|00000210| 6e 65 20 20 6f 72 20 20 | 6d 6f 72 65 20 20 63 6f |ne or |more co|
|00000220| 6d 2d 0d 20 20 20 20 20 | 20 20 20 20 20 6d 61 6e |m-. | man|
|00000230| 64 73 2e 20 20 53 65 6d | 69 2d 63 6f 6c 6f 6e 73 |ds. Sem|i-colons|
|00000240| 20 61 6e 64 20 6e 65 77 | 6c 69 6e 65 73 20 61 72 | and new|lines ar|
|00000250| 65 20 63 6f 6d 6d 61 6e | 64 20 73 65 70 61 72 61 |e comman|d separa|
|00000260| 74 6f 72 73 0d 20 20 20 | 20 20 20 20 20 20 20 75 |tors. | u|
|00000270| 6e 6c 65 73 73 20 71 75 | 6f 74 65 64 20 61 73 20 |nless qu|oted as |
|00000280| 64 65 73 63 72 69 62 65 | 64 20 62 65 6c 6f 77 2e |describe|d below.|
|00000290| 20 20 43 6c 6f 73 65 20 | 20 62 72 61 63 6b 65 74 | Close | bracket|
|000002a0| 73 20 20 61 72 65 0d 20 | 20 20 20 20 20 20 20 20 |s are. | |
|000002b0| 20 63 6f 6d 6d 61 6e 64 | 20 20 74 65 72 6d 69 6e | command| termin|
|000002c0| 61 74 6f 72 73 20 20 64 | 75 72 69 6e 67 20 20 63 |ators d|uring c|
|000002d0| 6f 6d 6d 61 6e 64 20 73 | 75 62 73 74 69 74 75 74 |ommand s|ubstitut|
|000002e0| 69 6f 6e 20 28 73 65 65 | 0d 20 20 20 20 20 20 20 |ion (see|. |
|000002f0| 20 20 20 62 65 6c 6f 77 | 29 20 75 6e 6c 65 73 73 | below|) unless|
|00000300| 20 71 75 6f 74 65 64 2e | 0d 0d 20 20 20 20 20 5b | quoted.|.. [|
|00000310| 32 5d 20 20 41 20 63 6f | 6d 6d 61 6e 64 20 69 73 |2] A co|mmand is|
|00000320| 20 65 76 61 6c 75 61 74 | 65 64 20 69 6e 20 74 77 | evaluat|ed in tw|
|00000330| 6f 20 73 74 65 70 73 2e | 20 20 20 46 69 72 73 74 |o steps.| First|
|00000340| 2c 20 20 74 68 65 20 20 | 54 63 6c 0d 20 20 20 20 |, the |Tcl. |
|00000350| 20 20 20 20 20 20 69 6e | 74 65 72 70 72 65 74 65 | in|terprete|
|00000360| 72 20 20 62 72 65 61 6b | 73 20 74 68 65 20 63 6f |r break|s the co|
|00000370| 6d 6d 61 6e 64 20 69 6e | 74 6f 20 77 6f 72 64 73 |mmand in|to words|
|00000380| 20 61 6e 64 20 70 65 72 | 66 6f 72 6d 73 0d 20 20 | and per|forms. |
|00000390| 20 20 20 20 20 20 20 20 | 73 75 62 73 74 69 74 75 | |substitu|
|000003a0| 74 69 6f 6e 73 20 61 73 | 20 64 65 73 63 72 69 62 |tions as| describ|
|000003b0| 65 64 20 62 65 6c 6f 77 | 2e 20 20 54 68 65 73 65 |ed below|. These|
|000003c0| 20 20 73 75 62 73 74 69 | 74 75 74 69 6f 6e 73 0d | substi|tutions.|
|000003d0| 20 20 20 20 20 20 20 20 | 20 20 61 72 65 20 20 70 | | are p|
|000003e0| 65 72 66 6f 72 6d 65 64 | 20 20 69 6e 20 20 74 68 |erformed| in th|
|000003f0| 65 20 73 61 6d 65 20 77 | 61 79 20 66 6f 72 20 61 |e same w|ay for a|
|00000400| 6c 6c 20 63 6f 6d 6d 61 | 6e 64 73 2e 20 20 54 68 |ll comma|nds. Th|
|00000410| 65 0d 20 20 20 20 20 20 | 20 20 20 20 66 69 72 73 |e. | firs|
|00000420| 74 20 77 6f 72 64 20 69 | 73 20 75 73 65 64 20 74 |t word i|s used t|
|00000430| 6f 20 6c 6f 63 61 74 65 | 20 20 61 20 20 63 6f 6d |o locate| a com|
|00000440| 6d 61 6e 64 20 20 70 72 | 6f 63 65 64 75 72 65 20 |mand pr|ocedure |
|00000450| 20 74 6f 0d 20 20 20 20 | 20 20 20 20 20 20 63 61 | to. | ca|
|00000460| 72 72 79 20 20 6f 75 74 | 20 20 74 68 65 20 20 63 |rry out| the c|
|00000470| 6f 6d 6d 61 6e 64 2c 20 | 20 74 68 65 6e 20 61 6c |ommand, | then al|
|00000480| 6c 20 6f 66 20 74 68 65 | 20 77 6f 72 64 73 20 6f |l of the| words o|
|00000490| 66 20 74 68 65 0d 20 20 | 20 20 20 20 20 20 20 20 |f the. | |
|000004a0| 63 6f 6d 6d 61 6e 64 20 | 61 72 65 20 70 61 73 73 |command |are pass|
|000004b0| 65 64 20 74 6f 20 74 68 | 65 20 63 6f 6d 6d 61 6e |ed to th|e comman|
|000004c0| 64 20 70 72 6f 63 65 64 | 75 72 65 2e 20 20 54 68 |d proced|ure. Th|
|000004d0| 65 20 20 63 6f 6d 2d 0d | 20 20 20 20 20 20 20 20 |e com-.| |
|000004e0| 20 20 6d 61 6e 64 20 20 | 70 72 6f 63 65 64 75 72 | mand |procedur|
|000004f0| 65 20 20 69 73 20 66 72 | 65 65 20 74 6f 20 69 6e |e is fr|ee to in|
|00000500| 74 65 72 70 72 65 74 20 | 65 61 63 68 20 6f 66 20 |terpret |each of |
|00000510| 69 74 73 20 77 6f 72 64 | 73 0d 20 20 20 20 20 20 |its word|s. |
|00000520| 20 20 20 20 69 6e 20 61 | 6e 79 20 77 61 79 20 69 | in a|ny way i|
|00000530| 74 20 6c 69 6b 65 73 2c | 20 73 75 63 68 20 61 73 |t likes,| such as|
|00000540| 20 61 6e 20 69 6e 74 65 | 67 65 72 2c 20 76 61 72 | an inte|ger, var|
|00000550| 69 61 62 6c 65 20 6e 61 | 6d 65 2c 0d 20 20 20 20 |iable na|me,. |
|00000560| 20 20 20 20 20 20 6c 69 | 73 74 2c 20 20 6f 72 20 | li|st, or |
|00000570| 20 54 63 6c 20 20 73 63 | 72 69 70 74 2e 20 20 20 | Tcl sc|ript. |
|00000580| 44 69 66 66 65 72 65 6e | 74 20 20 63 6f 6d 6d 61 |Differen|t comma|
|00000590| 6e 64 73 20 69 6e 74 65 | 72 70 72 65 74 0d 20 20 |nds inte|rpret. |
|000005a0| 20 20 20 20 20 20 20 20 | 74 68 65 69 72 20 77 6f | |their wo|
|000005b0| 72 64 73 20 64 69 66 66 | 65 72 65 6e 74 6c 79 2e |rds diff|erently.|
|000005c0| 0d 0d 20 20 20 20 20 5b | 33 5d 20 20 57 6f 72 64 |.. [|3] Word|
|000005d0| 73 20 6f 66 20 61 20 63 | 6f 6d 6d 61 6e 64 20 61 |s of a c|ommand a|
|000005e0| 72 65 20 73 65 70 61 72 | 61 74 65 64 20 62 79 20 |re separ|ated by |
|000005f0| 77 68 69 74 65 20 73 70 | 61 63 65 20 28 65 78 63 |white sp|ace (exc|
|00000600| 65 70 74 0d 20 20 20 20 | 20 20 20 20 20 20 66 6f |ept. | fo|
|00000610| 72 20 6e 65 77 6c 69 6e | 65 73 2c 20 77 68 69 63 |r newlin|es, whic|
|00000620| 68 20 61 72 65 20 63 6f | 6d 6d 61 6e 64 20 73 65 |h are co|mmand se|
|00000630| 70 61 72 61 74 6f 72 73 | 29 2e 0d 0d 20 20 20 20 |parators|)... |
|00000640| 20 5b 34 5d 20 20 49 66 | 20 74 68 65 20 20 66 69 | [4] If| the fi|
|00000650| 72 73 74 20 20 63 68 61 | 72 61 63 74 65 72 20 20 |rst cha|racter |
|00000660| 6f 66 20 20 61 20 20 77 | 6f 72 64 20 20 69 73 20 |of a w|ord is |
|00000670| 20 64 6f 75 62 6c 65 2d | 71 75 6f 74 65 0d 20 20 | double-|quote. |
|00000680| 20 20 20 20 20 20 20 20 | 28 60 60 22 27 27 29 20 | |(``"'') |
|00000690| 20 74 68 65 6e 20 20 74 | 68 65 20 20 77 6f 72 64 | then t|he word|
|000006a0| 20 20 69 73 20 20 74 65 | 72 6d 69 6e 61 74 65 64 | is te|rminated|
|000006b0| 20 20 62 79 20 20 74 68 | 65 20 20 6e 65 78 74 0d | by th|e next.|
|000006c0| 20 20 20 20 20 20 20 20 | 20 20 64 6f 75 62 6c 65 | | double|
|000006d0| 2d 71 75 6f 74 65 20 63 | 68 61 72 61 63 74 65 72 |-quote c|haracter|
|000006e0| 2e 20 20 49 66 20 73 65 | 6d 69 2d 63 6f 6c 6f 6e |. If se|mi-colon|
|000006f0| 73 2c 20 20 63 6c 6f 73 | 65 20 20 62 72 61 63 6b |s, clos|e brack|
|00000700| 2d 0d 20 20 20 20 20 20 | 20 20 20 20 65 74 73 2c |-. | ets,|
|00000710| 20 20 6f 72 20 20 77 68 | 69 74 65 20 20 73 70 61 | or wh|ite spa|
|00000720| 63 65 20 20 63 68 61 72 | 61 63 74 65 72 73 20 28 |ce char|acters (|
|00000730| 69 6e 63 6c 75 64 69 6e | 67 20 6e 65 77 6c 69 6e |includin|g newlin|
|00000740| 65 73 29 0d 20 20 20 20 | 20 20 20 20 20 20 61 70 |es). | ap|
|00000750| 70 65 61 72 20 62 65 74 | 77 65 65 6e 20 74 68 65 |pear bet|ween the|
|00000760| 20 71 75 6f 74 65 73 20 | 20 74 68 65 6e 20 20 74 | quotes | then t|
|00000770| 68 65 79 20 20 61 72 65 | 20 20 74 72 65 61 74 65 |hey are| treate|
|00000780| 64 20 20 61 73 0d 20 20 | 20 20 20 20 20 20 20 20 |d as. | |
|00000790| 6f 72 64 69 6e 61 72 79 | 20 20 63 68 61 72 61 63 |ordinary| charac|
|000007a0| 74 65 72 73 20 61 6e 64 | 20 69 6e 63 6c 75 64 65 |ters and| include|
|000007b0| 64 20 69 6e 20 74 68 65 | 20 77 6f 72 64 2e 20 20 |d in the| word. |
|000007c0| 43 6f 6d 6d 61 6e 64 0d | 20 20 20 20 20 20 20 20 |Command.| |
|000007d0| 20 20 73 75 62 73 74 69 | 74 75 74 69 6f 6e 2c 20 | substi|tution, |
|000007e0| 76 61 72 69 61 62 6c 65 | 20 73 75 62 73 74 69 74 |variable| substit|
|000007f0| 75 74 69 6f 6e 2c 20 61 | 6e 64 20 62 61 63 6b 73 |ution, a|nd backs|
|00000800| 6c 61 73 68 20 73 75 62 | 2d 0d 20 20 20 20 20 20 |lash sub|-. |
|00000810| 20 20 20 20 73 74 69 74 | 75 74 69 6f 6e 20 20 61 | stit|ution a|
|00000820| 72 65 20 20 70 65 72 66 | 6f 72 6d 65 64 20 6f 6e |re perf|ormed on|
|00000830| 20 74 68 65 20 63 68 61 | 72 61 63 74 65 72 73 20 | the cha|racters |
|00000840| 62 65 74 77 65 65 6e 20 | 74 68 65 0d 20 20 20 20 |between |the. |
|00000850| 20 20 20 20 20 20 71 75 | 6f 74 65 73 20 61 73 20 | qu|otes as |
|00000860| 64 65 73 63 72 69 62 65 | 64 20 62 65 6c 6f 77 2e |describe|d below.|
|00000870| 20 20 54 68 65 20 64 6f | 75 62 6c 65 2d 71 75 6f | The do|uble-quo|
|00000880| 74 65 73 20 20 61 72 65 | 20 20 6e 6f 74 0d 20 20 |tes are| not. |
|00000890| 20 20 20 20 20 20 20 20 | 72 65 74 61 69 6e 65 64 | |retained|
|000008a0| 20 61 73 20 70 61 72 74 | 20 6f 66 20 74 68 65 20 | as part| of the |
|000008b0| 77 6f 72 64 2e 0d 0d 20 | 20 20 20 20 5b 35 5d 20 |word... | [5] |
|000008c0| 20 49 66 20 74 68 65 20 | 66 69 72 73 74 20 63 68 | If the |first ch|
|000008d0| 61 72 61 63 74 65 72 20 | 6f 66 20 20 61 20 20 77 |aracter |of a w|
|000008e0| 6f 72 64 20 20 69 73 20 | 20 61 6e 20 20 6f 70 65 |ord is | an ope|
|000008f0| 6e 20 20 62 72 61 63 65 | 0d 20 20 20 20 20 20 20 |n brace|. |
|00000900| 20 20 20 28 60 60 7b 27 | 27 29 20 20 74 68 65 6e | (``{'|') then|
|00000910| 20 20 74 68 65 20 20 77 | 6f 72 64 20 20 69 73 20 | the w|ord is |
|00000920| 74 65 72 6d 69 6e 61 74 | 65 64 20 62 79 20 74 68 |terminat|ed by th|
|00000930| 65 20 6d 61 74 63 68 69 | 6e 67 0d 20 20 20 20 20 |e matchi|ng. |
|00000940| 20 20 20 20 20 63 6c 6f | 73 65 20 62 72 61 63 65 | clo|se brace|
|00000950| 20 28 60 60 7d 27 27 29 | 2e 20 20 42 72 61 63 65 | (``}'')|. Brace|
|00000960| 73 20 6e 65 73 74 20 77 | 69 74 68 69 6e 20 74 68 |s nest w|ithin th|
|00000970| 65 20 77 6f 72 64 3a 20 | 20 66 6f 72 0d 20 20 20 |e word: | for. |
|00000980| 20 20 20 20 20 20 20 65 | 61 63 68 20 20 61 64 64 | e|ach add|
|00000990| 69 74 69 6f 6e 61 6c 20 | 6f 70 65 6e 20 62 72 61 |itional |open bra|
|000009a0| 63 65 20 74 68 65 72 65 | 20 6d 75 73 74 20 62 65 |ce there| must be|
|000009b0| 20 61 6e 20 61 64 64 69 | 74 69 6f 6e 61 6c 0d 20 | an addi|tional. |
|000009c0| 20 20 20 20 20 20 20 20 | 20 63 6c 6f 73 65 20 62 | | close b|
|000009d0| 72 61 63 65 20 28 68 6f | 77 65 76 65 72 2c 20 69 |race (ho|wever, i|
|000009e0| 66 20 61 6e 20 6f 70 65 | 6e 20 62 72 61 63 65 20 |f an ope|n brace |
|000009f0| 6f 72 20 20 63 6c 6f 73 | 65 20 20 62 72 61 63 65 |or clos|e brace|
|00000a00| 0d 20 20 20 20 20 20 20 | 20 20 20 77 69 74 68 69 |. | withi|
|00000a10| 6e 20 20 74 68 65 20 20 | 77 6f 72 64 20 69 73 20 |n the |word is |
|00000a20| 71 75 6f 74 65 64 20 77 | 69 74 68 20 61 20 62 61 |quoted w|ith a ba|
|00000a30| 63 6b 73 6c 61 73 68 20 | 74 68 65 6e 20 69 74 20 |ckslash |then it |
|00000a40| 69 73 0d 20 20 20 20 20 | 20 20 20 20 20 6e 6f 74 |is. | not|
|00000a50| 20 63 6f 75 6e 74 65 64 | 20 69 6e 20 6c 6f 63 61 | counted| in loca|
|00000a60| 74 69 6e 67 20 74 68 65 | 20 6d 61 74 63 68 69 6e |ting the| matchin|
|00000a70| 67 20 63 6c 6f 73 65 20 | 62 72 61 63 65 29 2e 20 |g close |brace). |
|00000a80| 20 20 4e 6f 0d 20 20 20 | 20 20 20 20 20 20 20 73 | No. | s|
|00000a90| 75 62 73 74 69 74 75 74 | 69 6f 6e 73 20 20 61 72 |ubstitut|ions ar|
|00000aa0| 65 20 20 70 65 72 66 6f | 72 6d 65 64 20 6f 6e 20 |e perfo|rmed on |
|00000ab0| 74 68 65 20 63 68 61 72 | 61 63 74 65 72 73 20 62 |the char|acters b|
|00000ac0| 65 74 77 65 65 6e 0d 20 | 20 20 20 20 20 20 20 20 |etween. | |
|00000ad0| 20 74 68 65 20 62 72 61 | 63 65 73 20 65 78 63 65 | the bra|ces exce|
|00000ae0| 70 74 20 66 6f 72 20 20 | 62 61 63 6b 73 6c 61 73 |pt for |backslas|
|00000af0| 68 2d 6e 65 77 6c 69 6e | 65 20 20 73 75 62 73 74 |h-newlin|e subst|
|00000b00| 69 74 75 74 69 6f 6e 73 | 0d 20 20 20 20 20 20 20 |itutions|. |
|00000b10| 20 20 20 64 65 73 63 72 | 69 62 65 64 20 20 62 65 | descr|ibed be|
|00000b20| 6c 6f 77 2c 20 20 6e 6f | 72 20 20 64 6f 20 73 65 |low, no|r do se|
|00000b30| 6d 69 2d 63 6f 6c 6f 6e | 73 2c 20 6e 65 77 6c 69 |mi-colon|s, newli|
|00000b40| 6e 65 73 2c 20 63 6c 6f | 73 65 0d 20 20 20 20 20 |nes, clo|se. |
|00000b50| 20 20 20 20 20 62 72 61 | 63 6b 65 74 73 2c 20 6f | bra|ckets, o|
|00000b60| 72 20 77 68 69 74 65 20 | 73 70 61 63 65 20 72 65 |r white |space re|
|00000b70| 63 65 69 76 65 20 61 6e | 79 20 73 70 65 63 69 61 |ceive an|y specia|
|00000b80| 6c 20 20 69 6e 74 65 72 | 70 72 65 2d 0d 20 20 20 |l inter|pre-. |
|00000b90| 20 20 20 20 20 20 20 74 | 61 74 69 6f 6e 2e 20 20 | t|ation. |
|00000ba0| 20 54 68 65 20 20 77 6f | 72 64 20 77 69 6c 6c 20 | The wo|rd will |
|00000bb0| 63 6f 6e 73 69 73 74 20 | 6f 66 20 65 78 61 63 74 |consist |of exact|
|00000bc0| 6c 79 20 74 68 65 20 63 | 68 61 72 61 63 2d 0d 20 |ly the c|harac-. |
|00000bd0| 20 20 20 20 20 20 20 20 | 20 74 65 72 73 20 62 65 | | ters be|
|00000be0| 74 77 65 65 6e 20 74 68 | 65 20 6f 75 74 65 72 20 |tween th|e outer |
|00000bf0| 62 72 61 63 65 73 2c 20 | 6e 6f 74 20 69 6e 63 6c |braces, |not incl|
|00000c00| 75 64 69 6e 67 20 74 68 | 65 20 62 72 61 63 65 73 |uding th|e braces|
|00000c10| 0d 20 20 20 20 20 20 20 | 20 20 20 74 68 65 6d 73 |. | thems|
|00000c20| 65 6c 76 65 73 2e 0d 0d | 20 20 20 20 20 5b 36 5d |elves...| [6]|
|00000c30| 20 20 49 66 20 61 20 77 | 6f 72 64 20 63 6f 6e 74 | If a w|ord cont|
|00000c40| 61 69 6e 73 20 61 6e 20 | 6f 70 65 6e 20 20 62 72 |ains an |open br|
|00000c50| 61 63 6b 65 74 20 20 28 | 60 60 5b 27 27 29 20 20 |acket (|``['') |
|00000c60| 74 68 65 6e 20 20 54 63 | 6c 0d 20 20 20 20 20 20 |then Tc|l. |
|00000c70| 20 20 20 20 70 65 72 66 | 6f 72 6d 73 20 20 63 6f | perf|orms co|
|00000c80| 6d 6d 61 6e 64 20 20 73 | 75 62 73 74 69 74 75 74 |mmand s|ubstitut|
|00000c90| 69 6f 6e 2e 20 20 54 6f | 20 64 6f 20 74 68 69 73 |ion. To| do this|
|00000ca0| 20 69 74 20 69 6e 76 6f | 6b 65 73 0d 20 20 20 20 | it invo|kes. |
|00000cb0| 20 20 20 20 20 20 74 68 | 65 20 54 63 6c 20 69 6e | th|e Tcl in|
|00000cc0| 74 65 72 70 72 65 74 65 | 72 20 72 65 63 75 72 73 |terprete|r recurs|
|00000cd0| 69 76 65 6c 79 20 74 6f | 20 70 72 6f 63 65 73 73 |ively to| process|
|00000ce0| 20 74 68 65 20 20 63 68 | 61 72 61 63 2d 0d 20 20 | the ch|arac-. |
|00000cf0| 20 20 20 20 20 20 20 20 | 74 65 72 73 20 20 66 6f | |ters fo|
|00000d00| 6c 6c 6f 77 69 6e 67 20 | 20 74 68 65 20 6f 70 65 |llowing | the ope|
|00000d10| 6e 20 62 72 61 63 6b 65 | 74 20 61 73 20 61 20 54 |n bracke|t as a T|
|00000d20| 63 6c 20 73 63 72 69 70 | 74 2e 20 20 54 68 65 0d |cl scrip|t. The.|
|00000d30| 20 20 20 20 20 20 20 20 | 20 20 73 63 72 69 70 74 | | script|
|00000d40| 20 6d 61 79 20 63 6f 6e | 74 61 69 6e 20 61 6e 79 | may con|tain any|
|00000d50| 20 6e 75 6d 62 65 72 20 | 6f 66 20 63 6f 6d 6d 61 | number |of comma|
|00000d60| 6e 64 73 20 61 6e 64 20 | 20 6d 75 73 74 20 20 62 |nds and | must b|
|00000d70| 65 0d 20 20 20 20 20 20 | 20 20 20 20 74 65 72 6d |e. | term|
|00000d80| 69 6e 61 74 65 64 20 20 | 62 79 20 20 61 20 63 6c |inated |by a cl|
|00000d90| 6f 73 65 20 62 72 61 63 | 6b 65 74 20 28 60 60 5d |ose brac|ket (``]|
|00000da0| 27 27 29 2e 20 20 54 68 | 65 20 72 65 73 75 6c 74 |''). Th|e result|
|00000db0| 20 6f 66 0d 20 20 20 20 | 20 20 20 20 20 20 74 68 | of. | th|
|00000dc0| 65 20 73 63 72 69 70 74 | 20 28 69 2e 65 2e 20 74 |e script| (i.e. t|
|00000dd0| 68 65 20 72 65 73 75 6c | 74 20 6f 66 20 20 69 74 |he resul|t of it|
|00000de0| 73 20 20 6c 61 73 74 20 | 20 63 6f 6d 6d 61 6e 64 |s last | command|
|00000df0| 29 20 20 69 73 0d 20 20 | 20 20 20 20 20 20 20 20 |) is. | |
|00000e00| 73 75 62 73 74 69 74 75 | 74 65 64 20 20 69 6e 74 |substitu|ted int|
|00000e10| 6f 20 74 68 65 20 77 6f | 72 64 20 69 6e 20 70 6c |o the wo|rd in pl|
|00000e20| 61 63 65 20 6f 66 20 74 | 68 65 20 62 72 61 63 6b |ace of t|he brack|
|00000e30| 65 74 73 20 61 6e 64 0d | 20 20 20 20 20 20 20 20 |ets and.| |
|00000e40| 20 20 61 6c 6c 20 6f 66 | 20 74 68 65 20 63 68 61 | all of| the cha|
|00000e50| 72 61 63 74 65 72 73 20 | 62 65 74 77 65 65 6e 20 |racters |between |
|00000e60| 74 68 65 6d 2e 20 20 54 | 68 65 72 65 20 6d 61 79 |them. T|here may|
|00000e70| 20 20 62 65 20 20 61 6e | 79 0d 20 20 20 20 20 20 | be an|y. |
|00000e80| 20 20 20 20 6e 75 6d 62 | 65 72 20 6f 66 20 63 6f | numb|er of co|
|00000e90| 6d 6d 61 6e 64 20 73 75 | 62 73 74 69 74 75 74 69 |mmand su|bstituti|
|00000ea0| 6f 6e 73 20 69 6e 20 61 | 20 73 69 6e 67 6c 65 20 |ons in a| single |
|00000eb0| 77 6f 72 64 2e 20 20 43 | 6f 6d 2d 0d 20 20 20 20 |word. C|om-. |
|00000ec0| 20 20 20 20 20 20 6d 61 | 6e 64 20 73 75 62 73 74 | ma|nd subst|
|00000ed0| 69 74 75 74 69 6f 6e 20 | 69 73 20 6e 6f 74 20 70 |itution |is not p|
|00000ee0| 65 72 66 6f 72 6d 65 64 | 20 6f 6e 20 77 6f 72 64 |erformed| on word|
|00000ef0| 73 20 65 6e 63 6c 6f 73 | 65 64 20 69 6e 0d 20 20 |s enclos|ed in. |
|00000f00| 20 20 20 20 20 20 20 20 | 62 72 61 63 65 73 2e 0d | |braces..|
|00000f10| 0d 20 20 20 20 20 5b 37 | 5d 20 20 49 66 20 61 20 |. [7|] If a |
|00000f20| 77 6f 72 64 20 63 6f 6e | 74 61 69 6e 73 20 61 20 |word con|tains a |
|00000f30| 64 6f 6c 6c 61 72 2d 73 | 69 67 6e 20 28 60 60 24 |dollar-s|ign (``$|
|00000f40| 27 27 29 20 74 68 65 6e | 20 54 63 6c 20 20 70 65 |'') then| Tcl pe|
|00000f50| 72 2d 0d 20 20 20 20 20 | 20 20 20 20 20 66 6f 72 |r-. | for|
|00000f60| 6d 73 20 20 76 61 72 69 | 61 62 6c 65 20 20 73 75 |ms vari|able su|
|00000f70| 62 73 74 69 74 75 74 69 | 6f 6e 3a 20 20 74 68 65 |bstituti|on: the|
|00000f80| 20 64 6f 6c 6c 61 72 2d | 73 69 67 6e 20 61 6e 64 | dollar-|sign and|
|00000f90| 20 74 68 65 0d 20 20 20 | 20 20 20 20 20 20 20 66 | the. | f|
|00000fa0| 6f 6c 6c 6f 77 69 6e 67 | 20 63 68 61 72 61 63 74 |ollowing| charact|
|00000fb0| 65 72 73 20 61 72 65 20 | 72 65 70 6c 61 63 65 64 |ers are |replaced|
|00000fc0| 20 69 6e 20 74 68 65 20 | 20 77 6f 72 64 20 20 62 | in the | word b|
|00000fd0| 79 20 20 74 68 65 0d 20 | 20 20 20 20 20 20 20 20 |y the. | |
|00000fe0| 20 76 61 6c 75 65 20 20 | 6f 66 20 61 20 76 61 72 | value |of a var|
|00000ff0| 69 61 62 6c 65 2e 20 20 | 56 61 72 69 61 62 6c 65 |iable. |Variable|
|00001000| 20 73 75 62 73 74 69 74 | 69 6f 6e 20 6d 61 79 20 | substit|ion may |
|00001010| 74 61 6b 65 20 61 6e 79 | 0d 20 20 20 20 20 20 20 |take any|. |
|00001020| 20 20 20 6f 66 20 74 68 | 65 20 66 6f 6c 6c 6f 77 | of th|e follow|
|00001030| 69 6e 67 20 66 6f 72 6d | 73 3a 0d 0d 20 20 20 20 |ing form|s:.. |
|00001040| 20 20 20 20 20 20 24 6e | 61 6d 65 20 20 20 20 20 | $n|ame |
|00001050| 20 20 20 20 20 4e 61 6d | 65 20 69 73 20 74 68 65 | Nam|e is the|
|00001060| 20 6e 61 6d 65 20 6f 66 | 20 61 20 20 73 63 61 6c | name of| a scal|
|00001070| 61 72 20 20 76 61 72 69 | 61 62 6c 65 3b 0d 20 20 |ar vari|able;. |
|00001080| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001090| 20 20 20 20 20 20 20 74 | 68 65 20 20 6e 61 6d 65 | t|he name|
|000010a0| 20 69 73 20 74 65 72 6d | 69 6e 61 74 65 64 20 62 | is term|inated b|
|000010b0| 79 20 61 6e 79 20 63 68 | 61 72 61 63 74 65 72 0d |y any ch|aracter.|
|000010c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000010d0| 20 20 20 20 20 20 20 20 | 20 74 68 61 74 20 69 73 | | that is|
|000010e0| 6e 27 74 20 61 20 6c 65 | 74 74 65 72 2c 20 20 64 |n't a le|tter, d|
|000010f0| 69 67 69 74 2c 20 20 6f | 72 20 20 75 6e 64 65 72 |igit, o|r under|
|00001100| 2d 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |-. | |
|00001110| 20 20 20 20 20 20 20 20 | 20 20 20 73 63 6f 72 65 | | score|
|00001120| 2e 0d 0d 20 20 20 20 20 | 20 20 20 20 20 24 6e 61 |... | $na|
|00001130| 6d 65 28 69 6e 64 65 78 | 29 20 20 20 4e 61 6d 65 |me(index|) Name|
|00001140| 20 67 69 76 65 73 20 74 | 68 65 20 6e 61 6d 65 20 | gives t|he name |
|00001150| 6f 66 20 61 6e 20 61 72 | 72 61 79 20 76 61 72 69 |of an ar|ray vari|
|00001160| 61 62 6c 65 0d 20 20 20 | 20 20 20 20 20 20 20 20 |able. | |
|00001170| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 61 6e | | an|
|00001180| 64 20 20 69 6e 64 65 78 | 20 20 67 69 76 65 73 20 |d index| gives |
|00001190| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 61 6e 20 65 |the name| of an e|
|000011a0| 6c 65 6d 65 6e 74 0d 20 | 20 20 20 20 20 20 20 20 |lement. | |
|000011b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000011c0| 77 69 74 68 69 6e 20 74 | 68 61 74 20 61 72 72 61 |within t|hat arra|
|000011d0| 79 2e 20 20 20 4e 61 6d | 65 20 20 6d 75 73 74 20 |y. Nam|e must |
|000011e0| 20 63 6f 6e 74 61 69 6e | 0d 20 20 20 20 20 20 20 | contain|. |
|000011f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001200| 20 20 6f 6e 6c 79 20 20 | 6c 65 74 74 65 72 73 2c | only |letters,|
|00001210| 20 20 64 69 67 69 74 73 | 2c 20 61 6e 64 20 75 6e | digits|, and un|
|00001220| 64 65 72 73 63 6f 72 65 | 73 2e 0d 20 20 20 20 20 |derscore|s.. |
|00001230| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001240| 20 20 20 20 43 6f 6d 6d | 61 6e 64 20 73 75 62 73 | Comm|and subs|
|00001250| 74 69 74 75 74 69 6f 6e | 73 2c 20 76 61 72 69 61 |titution|s, varia|
|00001260| 62 6c 65 20 20 73 75 62 | 73 74 69 2d 0d 20 20 20 |ble sub|sti-. |
|00001270| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001280| 20 20 20 20 20 20 74 75 | 74 69 6f 6e 73 2c 20 61 | tu|tions, a|
|00001290| 6e 64 20 62 61 63 6b 73 | 6c 61 73 68 20 73 75 62 |nd backs|lash sub|
|000012a0| 73 74 69 74 75 74 69 6f | 6e 73 20 61 72 65 0d 20 |stitutio|ns are. |
|000012b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000012c0| 20 20 20 20 20 20 20 20 | 70 65 72 66 6f 72 6d 65 | |performe|
|000012d0| 64 20 6f 6e 20 74 68 65 | 20 63 68 61 72 61 63 74 |d on the| charact|
|000012e0| 65 72 73 20 6f 66 20 69 | 6e 64 65 78 2e 0d 0d 20 |ers of i|ndex... |
|000012f0| 20 20 20 20 20 20 20 20 | 20 24 7b 6e 61 6d 65 7d | | ${name}|
|00001300| 20 20 20 20 20 20 20 20 | 4e 61 6d 65 20 69 73 20 | |Name is |
|00001310| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 61 20 20 73 |the name| of a s|
|00001320| 63 61 6c 61 72 20 20 76 | 61 72 69 61 62 6c 65 2e |calar v|ariable.|
|00001330| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|00001340| 20 20 20 20 20 20 20 20 | 20 20 49 74 20 6d 61 79 | | It may|
|00001350| 20 63 6f 6e 74 61 69 6e | 20 61 6e 79 20 63 68 61 | contain| any cha|
|00001360| 72 61 63 74 65 72 73 20 | 77 68 61 74 73 6f 65 76 |racters |whatsoev|
|00001370| 65 72 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |er. | |
|00001380| 20 20 20 20 20 20 20 20 | 20 20 20 20 65 78 63 65 | | exce|
|00001390| 70 74 20 66 6f 72 20 63 | 6c 6f 73 65 20 62 72 61 |pt for c|lose bra|
|000013a0| 63 65 73 2e 0d 0d 20 20 | 20 20 20 54 68 65 72 65 |ces... | There|
|000013b0| 20 6d 61 79 20 62 65 20 | 61 6e 79 20 6e 75 6d 62 | may be |any numb|
|000013c0| 65 72 20 6f 66 20 76 61 | 72 69 61 62 6c 65 20 73 |er of va|riable s|
|000013d0| 75 62 73 74 69 74 75 74 | 69 6f 6e 73 20 69 6e 20 |ubstitut|ions in |
|000013e0| 61 20 20 73 69 6e 2d 0d | 20 20 20 20 20 67 6c 65 |a sin-.| gle|
|000013f0| 20 20 77 6f 72 64 2e 20 | 20 20 56 61 72 69 61 62 | word. | Variab|
|00001400| 6c 65 20 73 75 62 73 74 | 69 74 75 74 69 6f 6e 20 |le subst|itution |
|00001410| 69 73 20 6e 6f 74 20 70 | 65 72 66 6f 72 6d 65 64 |is not p|erformed|
|00001420| 20 6f 6e 20 77 6f 72 64 | 73 0d 20 20 20 20 20 65 | on word|s. e|
|00001430| 6e 63 6c 6f 73 65 64 20 | 69 6e 20 62 72 61 63 65 |nclosed |in brace|
|00001440| 73 2e 0d 0d 20 20 20 20 | 20 5b 38 5d 20 20 49 66 |s... | [8] If|
|00001450| 20 61 20 62 61 63 6b 73 | 6c 61 73 68 20 20 28 60 | a backs|lash (`|
|00001460| 60 5c 27 27 29 20 20 61 | 70 70 65 61 72 73 20 20 |`\'') a|ppears |
|00001470| 77 69 74 68 69 6e 20 20 | 61 20 20 77 6f 72 64 20 |within |a word |
|00001480| 20 74 68 65 6e 0d 20 20 | 20 20 20 20 20 20 20 20 | then. | |
|00001490| 62 61 63 6b 73 6c 61 73 | 68 20 20 73 75 62 73 74 |backslas|h subst|
|000014a0| 69 74 75 74 69 6f 6e 20 | 6f 63 63 75 72 73 2e 20 |itution |occurs. |
|000014b0| 20 49 6e 20 61 6c 6c 20 | 63 61 73 65 73 20 62 75 | In all |cases bu|
|000014c0| 74 20 74 68 6f 73 65 20 | 20 7c 0d 20 20 20 20 20 |t those | |. |
|000014d0| 20 20 20 20 20 64 65 73 | 63 72 69 62 65 64 20 62 | des|cribed b|
|000014e0| 65 6c 6f 77 20 74 68 65 | 20 62 61 63 6b 73 6c 61 |elow the| backsla|
|000014f0| 73 68 20 69 73 20 64 72 | 6f 70 70 65 64 20 61 6e |sh is dr|opped an|
|00001500| 64 20 20 74 68 65 20 20 | 66 6f 6c 2d 20 20 7c 0d |d the |fol- |.|
|00001510| 20 20 20 20 20 20 20 20 | 20 20 6c 6f 77 69 6e 67 | | lowing|
|00001520| 20 20 63 68 61 72 61 63 | 74 65 72 20 20 69 73 20 | charac|ter is |
|00001530| 20 74 72 65 61 74 65 64 | 20 61 73 20 61 6e 20 6f | treated| as an o|
|00001540| 72 64 69 6e 61 72 79 20 | 63 68 61 72 61 63 74 65 |rdinary |characte|
|00001550| 72 20 20 7c 0d 20 20 20 | 20 20 20 20 20 20 20 61 |r |. | a|
|00001560| 6e 64 20 69 6e 63 6c 75 | 64 65 64 20 69 6e 20 74 |nd inclu|ded in t|
|00001570| 68 65 20 77 6f 72 64 2e | 20 20 54 68 69 73 20 61 |he word.| This a|
|00001580| 6c 6c 6f 77 73 20 63 68 | 61 72 61 63 74 65 72 73 |llows ch|aracters|
|00001590| 20 20 73 75 63 68 0d 20 | 20 20 20 20 20 20 20 20 | such. | |
|000015a0| 20 61 73 20 20 64 6f 75 | 62 6c 65 20 20 71 75 6f | as dou|ble quo|
|000015b0| 74 65 73 2c 20 63 6c 6f | 73 65 20 62 72 61 63 6b |tes, clo|se brack|
|000015c0| 65 74 73 2c 20 61 6e 64 | 20 64 6f 6c 6c 61 72 20 |ets, and| dollar |
|000015d0| 73 69 67 6e 73 20 74 6f | 0d 20 20 20 20 20 20 20 |signs to|. |
|000015e0| 20 20 20 62 65 20 69 6e | 63 6c 75 64 65 64 20 69 | be in|cluded i|
|000015f0| 6e 20 77 6f 72 64 73 20 | 77 69 74 68 6f 75 74 20 |n words |without |
|00001600| 20 74 72 69 67 67 65 72 | 69 6e 67 20 20 73 70 65 | trigger|ing spe|
|00001610| 63 69 61 6c 20 20 70 72 | 6f 2d 0d 20 20 20 20 20 |cial pr|o-. |
|00001620| 20 20 20 20 20 63 65 73 | 73 69 6e 67 2e 20 20 20 | ces|sing. |
|00001630| 54 68 65 20 20 66 6f 6c | 6c 6f 77 69 6e 67 20 20 |The fol|lowing |
|00001640| 74 61 62 6c 65 20 20 6c | 69 73 74 73 20 20 74 68 |table l|ists th|
|00001650| 65 20 20 62 61 63 6b 73 | 6c 61 73 68 0d 20 20 20 |e backs|lash. |
|00001660| 20 20 20 20 20 20 20 73 | 65 71 75 65 6e 63 65 73 | s|equences|
|00001670| 20 74 68 61 74 20 61 72 | 65 20 68 61 6e 64 6c 65 | that ar|e handle|
|00001680| 64 20 73 70 65 63 69 61 | 6c 6c 79 2c 20 20 61 6c |d specia|lly, al|
|00001690| 6f 6e 67 20 20 77 69 74 | 68 20 20 74 68 65 0d 20 |ong wit|h the. |
|000016a0| 20 20 20 20 20 20 20 20 | 20 76 61 6c 75 65 20 74 | | value t|
|000016b0| 68 61 74 20 72 65 70 6c | 61 63 65 73 20 65 61 63 |hat repl|aces eac|
|000016c0| 68 20 73 65 71 75 65 6e | 63 65 2e 0d 0d 20 20 20 |h sequen|ce... |
|000016d0| 20 20 20 20 20 20 20 5c | 61 20 20 20 20 20 20 20 | \|a |
|000016e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000016f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001700| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001710| 20 20 20 20 20 7c 7c 0d | 20 20 20 20 20 20 20 20 | ||.| |
|00001720| 20 20 20 20 20 20 20 20 | 41 75 64 69 62 6c 65 20 | |Audible |
|00001730| 61 6c 65 72 74 20 28 62 | 65 6c 6c 29 20 28 30 78 |alert (b|ell) (0x|
|00001740| 37 29 2e 0d 0d 20 20 20 | 20 20 20 20 20 20 20 5c |7)... | \|
|00001750| 62 20 20 20 20 42 61 63 | 6b 73 70 61 63 65 20 28 |b Bac|kspace (|
|00001760| 30 78 38 29 2e 0d 0d 20 | 20 20 20 20 20 20 20 20 |0x8)... | |
|00001770| 20 5c 66 20 20 20 20 46 | 6f 72 6d 20 66 65 65 64 | \f F|orm feed|
|00001780| 20 28 30 78 63 29 2e 0d | 0d 20 20 20 20 20 20 20 | (0xc)..|. |
|00001790| 20 20 20 5c 6e 20 20 20 | 20 4e 65 77 6c 69 6e 65 | \n | Newline|
|000017a0| 20 28 30 78 61 29 2e 0d | 0d 20 20 20 20 20 20 20 | (0xa)..|. |
|000017b0| 20 20 20 5c 72 20 20 20 | 20 43 61 72 72 69 61 67 | \r | Carriag|
|000017c0| 65 2d 72 65 74 75 72 6e | 20 28 30 78 64 29 2e 0d |e-return| (0xd)..|
|000017d0| 0d 20 20 20 20 20 20 20 | 20 20 20 5c 74 20 20 20 |. | \t |
|000017e0| 20 54 61 62 20 28 30 78 | 39 29 2e 0d 0d 20 20 20 | Tab (0x|9)... |
|000017f0| 20 20 20 20 20 20 20 5c | 76 20 20 20 20 56 65 72 | \|v Ver|
|00001800| 74 69 63 61 6c 20 74 61 | 62 20 28 30 78 62 29 2e |tical ta|b (0xb).|
|00001810| 0d 0d 20 20 20 20 20 20 | 20 20 20 20 5c 3c 6e 65 |.. | \<ne|
|00001820| 77 6c 69 6e 65 3e 77 68 | 69 74 65 53 70 61 63 65 |wline>wh|iteSpace|
|00001830| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|00001840| 20 41 20 73 69 6e 67 6c | 65 20 73 70 61 63 65 20 | A singl|e space |
|00001850| 63 68 61 72 61 63 74 65 | 72 20 72 65 70 6c 61 63 |characte|r replac|
|00001860| 65 73 20 74 68 65 20 20 | 62 61 63 6b 73 6c 61 73 |es the |backslas|
|00001870| 68 2c 20 20 7c 0d 20 20 | 20 20 20 20 20 20 20 20 |h, |. | |
|00001880| 20 20 20 20 20 20 6e 65 | 77 6c 69 6e 65 2c 20 20 | ne|wline, |
|00001890| 61 6e 64 20 20 61 6c 6c | 20 77 68 69 74 65 20 73 |and all| white s|
|000018a0| 70 61 63 65 20 61 66 74 | 65 72 20 74 68 65 20 6e |pace aft|er the n|
|000018b0| 65 77 6c 69 6e 65 2e 20 | 20 7c 0d 20 20 20 20 20 |ewline. | |. |
|000018c0| 20 20 20 20 20 20 20 20 | 20 20 20 54 68 69 73 20 | | This |
|000018d0| 62 61 63 6b 73 6c 61 73 | 68 20 73 65 71 75 65 6e |backslas|h sequen|
|000018e0| 63 65 20 69 73 20 75 6e | 69 71 75 65 20 69 6e 20 |ce is un|ique in |
|000018f0| 74 68 61 74 20 20 69 74 | 20 20 69 73 20 20 7c 0d |that it| is |.|
|00001900| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001910| 72 65 70 6c 61 63 65 64 | 20 20 69 6e 20 20 61 20 |replaced| in a |
|00001920| 73 65 70 61 72 61 74 65 | 20 70 72 65 2d 70 61 73 |separate| pre-pas|
|00001930| 73 20 62 65 66 6f 72 65 | 20 74 68 65 20 63 6f 6d |s before| the com|
|00001940| 2d 20 20 7c 0d 20 20 20 | 20 20 20 20 20 20 20 20 |- |. | |
|00001950| 20 20 20 20 20 6d 61 6e | 64 20 69 73 20 61 63 74 | man|d is act|
|00001960| 75 61 6c 6c 79 20 70 61 | 72 73 65 64 2e 20 20 54 |ually pa|rsed. T|
|00001970| 68 69 73 20 6d 65 61 6e | 73 20 74 68 61 74 20 69 |his mean|s that i|
|00001980| 74 20 77 69 6c 6c 20 20 | 7c 0d 20 20 20 20 20 20 |t will ||. |
|00001990| 20 20 20 20 20 20 20 20 | 20 20 62 65 20 20 72 65 | | be re|
|000019a0| 70 6c 61 63 65 64 20 20 | 65 76 65 6e 20 77 68 65 |placed |even whe|
|000019b0| 6e 20 69 74 20 6f 63 63 | 75 72 73 20 62 65 74 77 |n it occ|urs betw|
|000019c0| 65 65 6e 20 62 72 61 63 | 65 73 2c 20 20 7c 0d 20 |een brac|es, |. |
|000019d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 61 | | a|
|000019e0| 6e 64 20 74 68 65 20 72 | 65 73 75 6c 74 69 6e 67 |nd the r|esulting|
|000019f0| 20 73 70 61 63 65 20 77 | 69 6c 6c 20 62 65 20 74 | space w|ill be t|
|00001a00| 72 65 61 74 65 64 20 61 | 73 20 61 20 77 6f 72 64 |reated a|s a word|
|00001a10| 20 20 7c 0d 20 20 20 20 | 20 20 20 20 20 20 20 20 | |. | |
|00001a20| 20 20 20 20 73 65 70 61 | 72 61 74 6f 72 20 69 66 | sepa|rator if|
|00001a30| 20 69 74 20 69 73 6e 27 | 74 20 69 6e 20 62 72 61 | it isn'|t in bra|
|00001a40| 63 65 73 20 6f 72 20 71 | 75 6f 74 65 73 2e 0d 0d |ces or q|uotes...|
|00001a50| 20 20 20 20 20 20 20 20 | 20 20 5c 5c 20 20 20 20 | | \\ |
|00001a60| 42 61 63 6b 73 6c 61 73 | 68 20 28 60 60 5c 27 27 |Backslas|h (``\''|
|00001a70| 29 2e 0d 0d 20 20 20 20 | 20 20 20 20 20 20 5c 6f |)... | \o|
|00001a80| 6f 6f 20 20 54 68 65 20 | 64 69 67 69 74 73 20 6f |oo The |digits o|
|00001a90| 6f 6f 20 28 6f 6e 65 2c | 20 74 77 6f 2c 20 6f 72 |oo (one,| two, or|
|00001aa0| 20 74 68 72 65 65 20 6f | 66 20 74 68 65 6d 29 20 | three o|f them) |
|00001ab0| 20 67 69 76 65 0d 20 20 | 20 20 20 20 20 20 20 20 | give. | |
|00001ac0| 20 20 20 20 20 20 74 68 | 65 20 6f 63 74 61 6c 20 | th|e octal |
|00001ad0| 76 61 6c 75 65 20 6f 66 | 20 74 68 65 20 63 68 61 |value of| the cha|
|00001ae0| 72 61 63 74 65 72 2e 0d | 0d 20 20 20 20 20 20 20 |racter..|. |
|00001af0| 20 20 20 5c 78 68 68 20 | 20 54 68 65 20 68 65 78 | \xhh | The hex|
|00001b00| 61 64 65 63 69 6d 61 6c | 20 64 69 67 69 74 73 20 |adecimal| digits |
|00001b10| 68 68 20 20 67 69 76 65 | 20 20 74 68 65 20 20 68 |hh give| the h|
|00001b20| 65 78 61 64 65 63 69 6d | 61 6c 20 20 7c 0d 20 20 |exadecim|al |. |
|00001b30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 76 61 | | va|
|00001b40| 6c 75 65 20 6f 66 20 74 | 68 65 20 63 68 61 72 61 |lue of t|he chara|
|00001b50| 63 74 65 72 2e 20 20 41 | 6e 79 20 6e 75 6d 62 65 |cter. A|ny numbe|
|00001b60| 72 20 6f 66 20 64 69 67 | 69 74 73 20 6d 61 79 20 |r of dig|its may |
|00001b70| 20 7c 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | |. | |
|00001b80| 20 20 20 62 65 20 70 72 | 65 73 65 6e 74 2e 0d 0d | be pr|esent...|
|00001b90| 20 20 20 20 20 42 61 63 | 6b 73 6c 61 73 68 20 73 | Bac|kslash s|
|00001ba0| 75 62 73 74 69 74 75 74 | 69 6f 6e 20 69 73 20 6e |ubstitut|ion is n|
|00001bb0| 6f 74 20 70 65 72 66 6f | 72 6d 65 64 20 6f 6e 20 |ot perfo|rmed on |
|00001bc0| 77 6f 72 64 73 20 65 6e | 63 6c 6f 73 65 64 20 69 |words en|closed i|
|00001bd0| 6e 0d 20 20 20 20 20 62 | 72 61 63 65 73 2c 20 65 |n. b|races, e|
|00001be0| 78 63 65 70 74 20 66 6f | 72 20 62 61 63 6b 73 6c |xcept fo|r backsl|
|00001bf0| 61 73 68 2d 6e 65 77 6c | 69 6e 65 20 61 73 20 64 |ash-newl|ine as d|
|00001c00| 65 73 63 72 69 62 65 64 | 20 61 62 6f 76 65 2e 0d |escribed| above..|
|00001c10| 0d 20 20 20 20 20 5b 39 | 5d 20 20 49 66 20 61 20 |. [9|] If a |
|00001c20| 68 61 73 68 20 63 68 61 | 72 61 63 74 65 72 20 28 |hash cha|racter (|
|00001c30| 60 60 23 27 27 29 20 61 | 70 70 65 61 72 73 20 61 |``#'') a|ppears a|
|00001c40| 74 20 20 61 20 20 70 6f | 69 6e 74 20 20 77 68 65 |t a po|int whe|
|00001c50| 72 65 0d 20 20 20 20 20 | 20 20 20 20 20 54 63 6c |re. | Tcl|
|00001c60| 20 20 69 73 20 65 78 70 | 65 63 74 69 6e 67 20 74 | is exp|ecting t|
|00001c70| 68 65 20 66 69 72 73 74 | 20 63 68 61 72 61 63 74 |he first| charact|
|00001c80| 65 72 20 6f 66 20 74 68 | 65 20 66 69 72 73 74 20 |er of th|e first |
|00001c90| 77 6f 72 64 0d 20 20 20 | 20 20 20 20 20 20 20 6f |word. | o|
|00001ca0| 66 20 61 20 63 6f 6d 6d | 61 6e 64 2c 20 74 68 65 |f a comm|and, the|
|00001cb0| 6e 20 74 68 65 20 68 61 | 73 68 20 63 68 61 72 61 |n the ha|sh chara|
|00001cc0| 63 74 65 72 20 61 6e 64 | 20 20 74 68 65 20 20 63 |cter and| the c|
|00001cd0| 68 61 72 61 63 2d 0d 20 | 20 20 20 20 20 20 20 20 |harac-. | |
|00001ce0| 20 74 65 72 73 20 20 74 | 68 61 74 20 20 66 6f 6c | ters t|hat fol|
|00001cf0| 6c 6f 77 20 69 74 2c 20 | 75 70 20 74 68 72 6f 75 |low it, |up throu|
|00001d00| 67 68 20 74 68 65 20 6e | 65 78 74 20 6e 65 77 6c |gh the n|ext newl|
|00001d10| 69 6e 65 2c 20 61 72 65 | 0d 20 20 20 20 20 20 20 |ine, are|. |
|00001d20| 20 20 20 74 72 65 61 74 | 65 64 20 61 73 20 61 20 | treat|ed as a |
|00001d30| 63 6f 6d 6d 65 6e 74 20 | 61 6e 64 20 69 67 6e 6f |comment |and igno|
|00001d40| 72 65 64 2e 20 20 54 68 | 65 20 63 6f 6d 6d 65 6e |red. Th|e commen|
|00001d50| 74 20 20 63 68 61 72 61 | 63 2d 0d 20 20 20 20 20 |t chara|c-. |
|00001d60| 20 20 20 20 20 74 65 72 | 20 6f 6e 6c 79 20 68 61 | ter| only ha|
|00001d70| 73 20 73 69 67 6e 69 66 | 69 63 61 6e 63 65 20 77 |s signif|icance w|
|00001d80| 68 65 6e 20 69 74 20 61 | 70 70 65 61 72 73 20 61 |hen it a|ppears a|
|00001d90| 74 20 74 68 65 20 62 65 | 67 69 6e 2d 0d 20 20 20 |t the be|gin-. |
|00001da0| 20 20 20 20 20 20 20 6e | 69 6e 67 20 6f 66 20 61 | n|ing of a|
|00001db0| 20 63 6f 6d 6d 61 6e 64 | 2e 0d 0d 20 20 20 20 20 | command|... |
|00001dc0| 5b 31 30 5d 20 45 61 63 | 68 20 63 68 61 72 61 63 |[10] Eac|h charac|
|00001dd0| 74 65 72 20 69 73 20 70 | 72 6f 63 65 73 73 65 64 |ter is p|rocessed|
|00001de0| 20 65 78 61 63 74 6c 79 | 20 20 6f 6e 63 65 20 20 | exactly| once |
|00001df0| 62 79 20 20 74 68 65 20 | 20 54 63 6c 0d 20 20 20 |by the | Tcl. |
|00001e00| 20 20 20 20 20 20 20 69 | 6e 74 65 72 70 72 65 74 | i|nterpret|
|00001e10| 65 72 20 61 73 20 70 61 | 72 74 20 6f 66 20 63 72 |er as pa|rt of cr|
|00001e20| 65 61 74 69 6e 67 20 74 | 68 65 20 77 6f 72 64 73 |eating t|he words|
|00001e30| 20 6f 66 20 61 20 63 6f | 6d 6d 61 6e 64 2e 0d 0d | of a co|mmand...|
|00001e40| 20 20 20 20 20 20 20 20 | 20 20 46 6f 72 20 65 78 | | For ex|
|00001e50| 61 6d 70 6c 65 2c 20 69 | 66 20 20 76 61 72 69 61 |ample, i|f varia|
|00001e60| 62 6c 65 20 20 73 75 62 | 73 74 69 74 69 6f 6e 20 |ble sub|stition |
|00001e70| 20 6f 63 63 75 72 73 20 | 20 74 68 65 6e 20 20 6e | occurs | then n|
|00001e80| 6f 0d 20 20 20 20 20 20 | 20 20 20 20 66 75 72 74 |o. | furt|
|00001e90| 68 65 72 20 20 73 75 62 | 73 74 69 74 69 6f 6e 73 |her sub|stitions|
|00001ea0| 20 20 61 72 65 20 70 65 | 72 66 6f 72 6d 65 64 20 | are pe|rformed |
|00001eb0| 6f 6e 20 74 68 65 20 76 | 61 6c 75 65 20 6f 66 20 |on the v|alue of |
|00001ec0| 74 68 65 0d 20 20 20 20 | 20 20 20 20 20 20 76 61 |the. | va|
|00001ed0| 72 69 61 62 6c 65 3b 20 | 20 74 68 65 20 76 61 6c |riable; | the val|
|00001ee0| 75 65 20 69 73 20 69 6e | 73 65 72 74 65 64 20 69 |ue is in|serted i|
|00001ef0| 6e 74 6f 20 74 68 65 20 | 20 77 6f 72 64 20 20 76 |nto the | word v|
|00001f00| 65 72 62 61 2d 0d 20 20 | 20 20 20 20 20 20 20 20 |erba-. | |
|00001f10| 74 69 6d 2e 20 20 20 49 | 66 20 20 63 6f 6d 6d 61 |tim. I|f comma|
|00001f20| 6e 64 20 20 73 75 62 73 | 74 69 74 75 74 69 6f 6e |nd subs|titution|
|00001f30| 20 6f 63 63 75 72 73 20 | 74 68 65 6e 20 74 68 65 | occurs |then the|
|00001f40| 20 6e 65 73 74 65 64 0d | 20 20 20 20 20 20 20 20 | nested.| |
|00001f50| 20 20 63 6f 6d 6d 61 6e | 64 20 69 73 20 70 72 6f | comman|d is pro|
|00001f60| 63 65 73 73 65 64 20 65 | 6e 74 69 72 65 6c 79 20 |cessed e|ntirely |
|00001f70| 62 79 20 74 68 65 20 72 | 65 63 75 72 73 69 76 65 |by the r|ecursive|
|00001f80| 20 63 61 6c 6c 20 20 74 | 6f 0d 20 20 20 20 20 20 | call t|o. |
|00001f90| 20 20 20 20 74 68 65 20 | 20 54 63 6c 20 20 69 6e | the | Tcl in|
|00001fa0| 74 65 72 70 72 65 74 65 | 72 3b 20 20 6e 6f 20 20 |terprete|r; no |
|00001fb0| 73 75 62 73 74 69 74 75 | 74 69 6f 6e 73 20 20 61 |substitu|tions a|
|00001fc0| 72 65 20 70 65 72 66 6f | 6d 65 64 0d 20 20 20 20 |re perfo|med. |
|00001fd0| 20 20 20 20 20 20 62 65 | 66 6f 72 65 20 6d 61 6b | be|fore mak|
|00001fe0| 69 6e 67 20 74 68 65 20 | 72 65 63 75 72 73 69 76 |ing the |recursiv|
|00001ff0| 65 20 63 61 6c 6c 20 61 | 6e 64 20 6e 6f 20 61 64 |e call a|nd no ad|
|00002000| 64 69 74 69 6f 6e 61 6c | 20 73 75 62 2d 0d 20 20 |ditional| sub-. |
|00002010| 20 20 20 20 20 20 20 20 | 73 74 69 74 75 74 69 6f | |stitutio|
|00002020| 6e 73 20 20 61 72 65 20 | 20 70 65 72 66 6f 72 6d |ns are | perform|
|00002030| 65 64 20 20 6f 6e 20 74 | 68 65 20 72 65 73 75 6c |ed on t|he resul|
|00002040| 74 20 6f 66 20 74 68 65 | 20 6e 65 73 74 65 64 0d |t of the| nested.|
|00002050| 20 20 20 20 20 20 20 20 | 20 20 73 63 72 69 70 74 | | script|
|00002060| 2e 0d 0d 20 20 20 20 20 | 5b 31 31 5d 20 53 75 62 |... |[11] Sub|
|00002070| 73 74 69 74 75 74 69 6f | 6e 73 20 64 6f 20 6e 6f |stitutio|ns do no|
|00002080| 74 20 61 66 66 65 63 74 | 20 74 68 65 20 77 6f 72 |t affect| the wor|
|00002090| 64 20 20 62 6f 75 6e 64 | 61 72 69 65 73 20 20 6f |d bound|aries o|
|000020a0| 66 20 20 61 0d 20 20 20 | 20 20 20 20 20 20 20 63 |f a. | c|
|000020b0| 6f 6d 6d 61 6e 64 2e 20 | 20 46 6f 72 20 65 78 61 |ommand. | For exa|
|000020c0| 6d 70 6c 65 2c 20 64 75 | 72 69 6e 67 20 76 61 72 |mple, du|ring var|
|000020d0| 69 61 62 6c 65 20 73 75 | 62 73 74 69 74 75 74 69 |iable su|bstituti|
|000020e0| 6f 6e 20 74 68 65 0d 20 | 20 20 20 20 20 20 20 20 |on the. | |
|000020f0| 20 65 6e 74 69 72 65 20 | 76 61 6c 75 65 20 6f 66 | entire |value of|
|00002100| 20 74 68 65 20 76 61 72 | 69 61 62 6c 65 20 62 65 | the var|iable be|
|00002110| 63 6f 6d 65 73 20 70 61 | 72 74 20 6f 66 20 20 61 |comes pa|rt of a|
|00002120| 20 20 73 69 6e 67 6c 65 | 0d 20 20 20 20 20 20 20 | single|. |
|00002130| 20 20 20 77 6f 72 64 2c | 20 65 76 65 6e 20 69 66 | word,| even if|
|00002140| 20 74 68 65 20 76 61 72 | 69 61 62 6c 65 27 73 20 | the var|iable's |
|00002150| 76 61 6c 75 65 20 63 6f | 6e 74 61 69 6e 73 20 73 |value co|ntains s|
|00002160| 70 61 63 65 73 2e 0d 0d | 0d 0d 54 63 6c 20 20 20 |paces...|..Tcl |
|00002170| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002180| 20 20 20 4c 61 73 74 20 | 63 68 61 6e 67 65 3a 20 | Last |change: |
|00002190| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000021a0| 20 20 20 20 20 20 20 20 | 20 20 34 0d 0d 0d 0d 5f | | 4...._|
|000021b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000021f0| 0d 0d 4e 41 4d 45 0d 20 | 20 20 20 20 61 70 70 65 |..NAME. | appe|
|00002200| 6e 64 20 2d 20 41 70 70 | 65 6e 64 20 74 6f 20 76 |nd - App|end to v|
|00002210| 61 72 69 61 62 6c 65 0d | 0d 53 59 4e 4f 50 53 49 |ariable.|.SYNOPSI|
|00002220| 53 0d 20 20 20 20 20 61 | 70 70 65 6e 64 20 76 61 |S. a|ppend va|
|00002230| 72 4e 61 6d 65 20 76 61 | 6c 75 65 20 3f 76 61 6c |rName va|lue ?val|
|00002240| 75 65 20 76 61 6c 75 65 | 20 2e 2e 2e 3f 0d 5f 5f |ue value| ...?.__|
|00002250| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002260| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002270| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002280| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00002290| 0d 0d 44 45 53 43 52 49 | 50 54 49 4f 4e 0d 20 20 |..DESCRI|PTION. |
|000022a0| 20 20 20 41 70 70 65 6e | 64 20 61 6c 6c 20 6f 66 | Appen|d all of|
|000022b0| 20 74 68 65 20 76 61 6c | 75 65 20 61 72 67 75 6d | the val|ue argum|
|000022c0| 65 6e 74 73 20 74 6f 20 | 74 68 65 20 20 63 75 72 |ents to |the cur|
|000022d0| 72 65 6e 74 20 20 76 61 | 6c 75 65 20 20 6f 66 0d |rent va|lue of.|
|000022e0| 20 20 20 20 20 76 61 72 | 69 61 62 6c 65 20 20 76 | var|iable v|
|000022f0| 61 72 4e 61 6d 65 2e 20 | 20 20 49 66 20 76 61 72 |arName. | If var|
|00002300| 4e 61 6d 65 20 64 6f 65 | 73 6e 27 74 20 65 78 69 |Name doe|sn't exi|
|00002310| 73 74 2c 20 69 74 20 69 | 73 20 67 69 76 65 6e 20 |st, it i|s given |
|00002320| 61 0d 20 20 20 20 20 76 | 61 6c 75 65 20 65 71 75 |a. v|alue equ|
|00002330| 61 6c 20 74 6f 20 74 68 | 65 20 63 6f 6e 63 61 74 |al to th|e concat|
|00002340| 65 6e 61 74 69 6f 6e 20 | 6f 66 20 61 6c 6c 20 74 |enation |of all t|
|00002350| 68 65 20 76 61 6c 75 65 | 20 61 72 67 75 6d 65 6e |he value| argumen|
|00002360| 74 73 2e 0d 20 20 20 20 | 20 54 68 69 73 20 20 63 |ts.. | This c|
|00002370| 6f 6d 6d 61 6e 64 20 20 | 70 72 6f 76 69 64 65 73 |ommand |provides|
|00002380| 20 20 61 6e 20 20 65 66 | 66 69 63 69 65 6e 74 20 | an ef|ficient |
|00002390| 20 77 61 79 20 74 6f 20 | 62 75 69 6c 64 20 75 70 | way to |build up|
|000023a0| 20 6c 6f 6e 67 0d 20 20 | 20 20 20 76 61 72 69 61 | long. | varia|
|000023b0| 62 6c 65 73 20 69 6e 63 | 72 65 6d 65 6e 74 61 6c |bles inc|remental|
|000023c0| 6c 79 2e 20 20 46 6f 72 | 20 65 78 61 6d 70 6c 65 |ly. For| example|
|000023d0| 2c 20 60 60 61 70 70 65 | 6e 64 20 20 61 20 20 24 |, ``appe|nd a $|
|000023e0| 62 27 27 20 20 69 73 0d | 20 20 20 20 20 6d 75 63 |b'' is.| muc|
|000023f0| 68 20 6d 6f 72 65 20 65 | 66 66 69 63 69 65 6e 74 |h more e|fficient|
|00002400| 20 74 68 61 6e 20 60 60 | 73 65 74 20 61 20 24 61 | than ``|set a $a|
|00002410| 24 62 27 27 20 69 66 20 | 24 61 20 69 73 20 6c 6f |$b'' if |$a is lo|
|00002420| 6e 67 2e 0d 0d 0d 4b 45 | 59 57 4f 52 44 53 0d 20 |ng....KE|YWORDS. |
|00002430| 20 20 20 20 61 70 70 65 | 6e 64 2c 20 76 61 72 69 | appe|nd, vari|
|00002440| 61 62 6c 65 0d 0d 0d 5f | 5f 5f 5f 5f 5f 5f 5f 5f |able..._|________|
|00002450| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002460| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002470| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002480| 5f 5f 5f 5f 5f 5f 5f 5f | 0d 0d 4e 41 4d 45 0d 20 |________|..NAME. |
|00002490| 20 20 20 20 61 72 72 61 | 79 20 2d 20 4d 61 6e 69 | arra|y - Mani|
|000024a0| 70 75 6c 61 74 65 20 61 | 72 72 61 79 20 76 61 72 |pulate a|rray var|
|000024b0| 69 61 62 6c 65 73 0d 0d | 53 59 4e 4f 50 53 49 53 |iables..|SYNOPSIS|
|000024c0| 0d 20 20 20 20 20 61 72 | 72 61 79 20 6f 70 74 69 |. ar|ray opti|
|000024d0| 6f 6e 20 61 72 72 61 79 | 4e 61 6d 65 20 3f 61 72 |on array|Name ?ar|
|000024e0| 67 20 61 72 67 20 2e 2e | 2e 3f 0d 5f 5f 5f 5f 5f |g arg ..|.?._____|
|000024f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002500| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002510| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002520| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 0d 0d 44 |________|____...D|
|00002530| 45 53 43 52 49 50 54 49 | 4f 4e 0d 20 20 20 20 20 |ESCRIPTI|ON. |
|00002540| 54 68 69 73 20 63 6f 6d | 6d 61 6e 64 20 70 65 72 |This com|mand per|
|00002550| 66 6f 72 6d 73 20 6f 6e | 65 20 6f 66 20 73 65 76 |forms on|e of sev|
|00002560| 65 72 61 6c 20 6f 70 65 | 72 61 74 69 6f 6e 73 20 |eral ope|rations |
|00002570| 6f 6e 20 74 68 65 20 76 | 61 72 69 2d 0d 20 20 20 |on the v|ari-. |
|00002580| 20 20 61 62 6c 65 20 20 | 67 69 76 65 6e 20 20 62 | able |given b|
|00002590| 79 20 61 72 72 61 79 4e | 61 6d 65 2e 20 20 41 72 |y arrayN|ame. Ar|
|000025a0| 72 61 79 4e 61 6d 65 20 | 6d 75 73 74 20 62 65 20 |rayName |must be |
|000025b0| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 61 6e 0d 20 |the name| of an. |
|000025c0| 20 20 20 20 65 78 69 73 | 74 69 6e 67 20 61 72 72 | exis|ting arr|
|000025d0| 61 79 20 76 61 72 69 61 | 62 6c 65 2e 20 20 20 54 |ay varia|ble. T|
|000025e0| 68 65 20 20 6f 70 74 69 | 6f 6e 20 20 61 72 67 75 |he opti|on argu|
|000025f0| 6d 65 6e 74 20 20 64 65 | 74 65 72 6d 69 6e 65 73 |ment de|termines|
|00002600| 0d 20 20 20 20 20 77 68 | 61 74 20 20 61 63 74 69 |. wh|at acti|
|00002610| 6f 6e 20 20 69 73 20 20 | 63 61 72 72 69 65 64 20 |on is |carried |
|00002620| 20 6f 75 74 20 20 62 79 | 20 20 74 68 65 20 20 63 | out by| the c|
|00002630| 6f 6d 6d 61 6e 64 2e 20 | 20 54 68 65 20 6c 65 67 |ommand. | The leg|
|00002640| 61 6c 0d 20 20 20 20 20 | 6f 70 74 69 6f 6e 73 20 |al. |options |
|00002650| 28 77 68 69 63 68 20 6d | 61 79 20 62 65 20 61 62 |(which m|ay be ab|
|00002660| 62 72 65 76 69 61 74 65 | 64 29 20 61 72 65 3a 0d |breviate|d) are:.|
|00002670| 0d 20 20 20 20 20 61 72 | 72 61 79 20 61 6e 79 6d |. ar|ray anym|
|00002680| 6f 72 65 20 61 72 72 61 | 79 4e 61 6d 65 20 73 65 |ore arra|yName se|
|00002690| 61 72 63 68 49 64 0d 20 | 20 20 20 20 20 20 20 20 |archId. | |
|000026a0| 20 52 65 74 75 72 6e 73 | 20 31 20 69 66 20 74 68 | Returns| 1 if th|
|000026b0| 65 72 65 20 61 72 65 20 | 61 6e 79 20 6d 6f 72 65 |ere are |any more|
|000026c0| 20 20 65 6c 65 6d 65 6e | 74 73 20 20 6c 65 66 74 | elemen|ts left|
|000026d0| 20 20 74 6f 20 20 62 65 | 0d 20 20 20 20 20 20 20 | to be|. |
|000026e0| 20 20 20 70 72 6f 63 65 | 73 73 65 64 20 20 69 6e | proce|ssed in|
|000026f0| 20 20 61 6e 20 20 61 72 | 72 61 79 20 73 65 61 72 | an ar|ray sear|
|00002700| 63 68 2c 20 30 20 69 66 | 20 61 6c 6c 20 65 6c 65 |ch, 0 if| all ele|
|00002710| 6d 65 6e 74 73 20 68 61 | 76 65 0d 20 20 20 20 20 |ments ha|ve. |
|00002720| 20 20 20 20 20 61 6c 72 | 65 61 64 79 20 62 65 65 | alr|eady bee|
|00002730| 6e 20 72 65 74 75 72 6e | 65 64 2e 20 20 53 65 61 |n return|ed. Sea|
|00002740| 72 63 68 49 64 20 69 6e | 64 69 63 61 74 65 73 20 |rchId in|dicates |
|00002750| 77 68 69 63 68 20 73 65 | 61 72 63 68 0d 20 20 20 |which se|arch. |
|00002760| 20 20 20 20 20 20 20 6f | 6e 20 20 61 72 72 61 79 | o|n array|
|00002770| 4e 61 6d 65 20 20 74 6f | 20 20 63 68 65 63 6b 2c |Name to| check,|
|00002780| 20 61 6e 64 20 6d 75 73 | 74 20 68 61 76 65 20 62 | and mus|t have b|
|00002790| 65 65 6e 20 74 68 65 20 | 72 65 74 75 72 6e 0d 20 |een the |return. |
|000027a0| 20 20 20 20 20 20 20 20 | 20 76 61 6c 75 65 20 66 | | value f|
|000027b0| 72 6f 6d 20 61 20 70 72 | 65 76 69 6f 75 73 20 69 |rom a pr|evious i|
|000027c0| 6e 76 6f 63 61 74 69 6f | 6e 20 6f 66 20 61 72 72 |nvocatio|n of arr|
|000027d0| 61 79 20 20 73 74 61 72 | 74 73 65 61 72 63 68 2e |ay star|tsearch.|
|000027e0| 0d 20 20 20 20 20 20 20 | 20 20 20 54 68 69 73 20 |. | This |
|000027f0| 20 6f 70 74 69 6f 6e 20 | 20 69 73 20 70 61 72 74 | option | is part|
|00002800| 69 63 75 6c 61 72 6c 79 | 20 75 73 65 66 75 6c 20 |icularly| useful |
|00002810| 69 66 20 61 6e 20 61 72 | 72 61 79 20 68 61 73 20 |if an ar|ray has |
|00002820| 61 6e 0d 20 20 20 20 20 | 20 20 20 20 20 65 6c 65 |an. | ele|
|00002830| 6d 65 6e 74 20 77 69 74 | 68 20 61 6e 20 65 6d 70 |ment wit|h an emp|
|00002840| 74 79 20 6e 61 6d 65 2c | 20 73 69 6e 63 65 20 74 |ty name,| since t|
|00002850| 68 65 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 20 |he retur|n value |
|00002860| 66 72 6f 6d 0d 20 20 20 | 20 20 20 20 20 20 20 61 |from. | a|
|00002870| 72 72 61 79 20 6e 65 78 | 74 65 6c 65 6d 65 6e 74 |rray nex|telement|
|00002880| 20 77 6f 6e 27 74 20 69 | 6e 64 69 63 61 74 65 20 | won't i|ndicate |
|00002890| 77 68 65 74 68 65 72 20 | 74 68 65 20 73 65 61 72 |whether |the sear|
|000028a0| 63 68 20 68 61 73 0d 20 | 20 20 20 20 20 20 20 20 |ch has. | |
|000028b0| 20 62 65 65 6e 20 63 6f | 6d 70 6c 65 74 65 64 2e | been co|mpleted.|
|000028c0| 0d 0d 20 20 20 20 20 61 | 72 72 61 79 20 64 6f 6e |.. a|rray don|
|000028d0| 65 73 65 61 72 63 68 20 | 61 72 72 61 79 4e 61 6d |esearch |arrayNam|
|000028e0| 65 20 73 65 61 72 63 68 | 49 64 0d 20 20 20 20 20 |e search|Id. |
|000028f0| 20 20 20 20 20 54 68 69 | 73 20 63 6f 6d 6d 61 6e | Thi|s comman|
|00002900| 64 20 74 65 72 6d 69 6e | 61 74 65 73 20 61 6e 20 |d termin|ates an |
|00002910| 61 72 72 61 79 20 20 73 | 65 61 72 63 68 20 20 61 |array s|earch a|
|00002920| 6e 64 20 20 64 65 73 74 | 72 6f 79 73 0d 20 20 20 |nd dest|roys. |
|00002930| 20 20 20 20 20 20 20 61 | 6c 6c 20 20 74 68 65 20 | a|ll the |
|00002940| 20 73 74 61 74 65 20 20 | 61 73 73 6f 63 69 61 74 | state |associat|
|00002950| 65 64 20 77 69 74 68 20 | 74 68 61 74 20 73 65 61 |ed with |that sea|
|00002960| 72 63 68 2e 20 20 53 65 | 61 72 63 68 49 64 0d 20 |rch. Se|archId. |
|00002970| 20 20 20 20 20 20 20 20 | 20 69 6e 64 69 63 61 74 | | indicat|
|00002980| 65 73 20 77 68 69 63 68 | 20 73 65 61 72 63 68 20 |es which| search |
|00002990| 6f 6e 20 20 61 72 72 61 | 79 4e 61 6d 65 20 20 74 |on arra|yName t|
|000029a0| 6f 20 20 64 65 73 74 72 | 6f 79 2c 20 20 61 6e 64 |o destr|oy, and|
|000029b0| 0d 20 20 20 20 20 20 20 | 20 20 20 6d 75 73 74 20 |. | must |
|000029c0| 68 61 76 65 20 62 65 65 | 6e 20 74 68 65 20 72 65 |have bee|n the re|
|000029d0| 74 75 72 6e 20 76 61 6c | 75 65 20 66 72 6f 6d 20 |turn val|ue from |
|000029e0| 61 20 70 72 65 76 69 6f | 75 73 20 69 6e 76 6f 63 |a previo|us invoc|
|000029f0| 61 2d 0d 20 20 20 20 20 | 20 20 20 20 20 74 69 6f |a-. | tio|
|00002a00| 6e 20 6f 66 20 61 72 72 | 61 79 20 73 74 61 72 74 |n of arr|ay start|
|00002a10| 73 65 61 72 63 68 2e 20 | 20 52 65 74 75 72 6e 73 |search. | Returns|
|00002a20| 20 61 6e 20 65 6d 70 74 | 79 20 73 74 72 69 6e 67 | an empt|y string|
|00002a30| 2e 0d 0d 20 20 20 20 20 | 61 72 72 61 79 20 6e 61 |... |array na|
|00002a40| 6d 65 73 20 61 72 72 61 | 79 4e 61 6d 65 0d 20 20 |mes arra|yName. |
|00002a50| 20 20 20 20 20 20 20 20 | 52 65 74 75 72 6e 73 20 | |Returns |
|00002a60| 61 20 6c 69 73 74 20 63 | 6f 6e 74 61 69 6e 69 6e |a list c|ontainin|
|00002a70| 67 20 74 68 65 20 6e 61 | 6d 65 73 20 6f 66 20 61 |g the na|mes of a|
|00002a80| 6c 6c 20 6f 66 20 74 68 | 65 20 20 65 6c 65 2d 0d |ll of th|e ele-.|
|00002a90| 20 20 20 20 20 20 20 20 | 20 20 6d 65 6e 74 73 20 | | ments |
|00002aa0| 20 69 6e 20 20 74 68 65 | 20 20 61 72 72 61 79 2e | in the| array.|
|00002ab0| 20 20 49 66 20 74 68 65 | 72 65 20 61 72 65 20 6e | If the|re are n|
|00002ac0| 6f 20 65 6c 65 6d 65 6e | 74 73 20 69 6e 20 74 68 |o elemen|ts in th|
|00002ad0| 65 0d 20 20 20 20 20 20 | 20 20 20 20 61 72 72 61 |e. | arra|
|00002ae0| 79 20 74 68 65 6e 20 61 | 6e 20 65 6d 70 74 79 20 |y then a|n empty |
|00002af0| 73 74 72 69 6e 67 20 69 | 73 20 72 65 74 75 72 6e |string i|s return|
|00002b00| 65 64 2e 0d 0d 20 20 20 | 20 20 61 72 72 61 79 20 |ed... | array |
|00002b10| 6e 65 78 74 65 6c 65 6d | 65 6e 74 20 61 72 72 61 |nextelem|ent arra|
|00002b20| 79 4e 61 6d 65 20 73 65 | 61 72 63 68 49 64 0d 20 |yName se|archId. |
|00002b30| 20 20 20 20 20 20 20 20 | 20 52 65 74 75 72 6e 73 | | Returns|
|00002b40| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 74 68 65 | the nam|e of the|
|00002b50| 20 6e 65 78 74 20 65 6c | 65 6d 65 6e 74 20 69 6e | next el|ement in|
|00002b60| 20 20 61 72 72 61 79 4e | 61 6d 65 2c 20 20 6f 72 | arrayN|ame, or|
|00002b70| 0d 20 20 20 20 20 20 20 | 20 20 20 61 6e 20 20 65 |. | an e|
|00002b80| 6d 70 74 79 20 20 73 74 | 72 69 6e 67 20 20 69 66 |mpty st|ring if|
|00002b90| 20 20 61 6c 6c 20 20 65 | 6c 65 6d 65 6e 74 73 20 | all e|lements |
|00002ba0| 20 6f 66 20 61 72 72 61 | 79 4e 61 6d 65 20 68 61 | of arra|yName ha|
|00002bb0| 76 65 0d 20 20 20 20 20 | 20 20 20 20 20 61 6c 72 |ve. | alr|
|00002bc0| 65 61 64 79 20 62 65 65 | 6e 20 72 65 74 75 72 6e |eady bee|n return|
|00002bd0| 65 64 20 69 6e 20 20 74 | 68 69 73 20 20 73 65 61 |ed in t|his sea|
|00002be0| 72 63 68 2e 20 20 20 54 | 68 65 20 20 73 65 61 72 |rch. T|he sear|
|00002bf0| 63 68 49 64 0d 20 20 20 | 20 20 20 20 20 20 20 61 |chId. | a|
|00002c00| 72 67 75 6d 65 6e 74 20 | 20 69 64 65 6e 74 69 66 |rgument | identif|
|00002c10| 69 65 73 20 74 68 65 20 | 73 65 61 72 63 68 2c 20 |ies the |search, |
|00002c20| 61 6e 64 20 6d 75 73 74 | 20 68 61 76 65 20 62 65 |and must| have be|
|00002c30| 65 6e 20 74 68 65 0d 20 | 20 20 20 20 20 20 20 20 |en the. | |
|00002c40| 20 72 65 74 75 72 6e 20 | 76 61 6c 75 65 20 6f 66 | return |value of|
|00002c50| 20 61 6e 20 61 72 72 61 | 79 20 73 74 61 72 74 73 | an arra|y starts|
|00002c60| 65 61 72 63 68 20 63 6f | 6d 6d 61 6e 64 2e 20 20 |earch co|mmand. |
|00002c70| 57 61 72 6e 69 6e 67 3a | 0d 20 20 20 20 20 20 20 |Warning:|. |
|00002c80| 20 20 20 69 66 20 20 65 | 6c 65 6d 65 6e 74 73 20 | if e|lements |
|00002c90| 20 61 72 65 20 20 61 64 | 64 65 64 20 20 74 6f 20 | are ad|ded to |
|00002ca0| 6f 72 20 64 65 6c 65 74 | 65 64 20 66 72 6f 6d 20 |or delet|ed from |
|00002cb0| 74 68 65 20 61 72 72 61 | 79 2c 0d 20 20 20 20 20 |the arra|y,. |
|00002cc0| 20 20 20 20 20 74 68 65 | 6e 20 61 6c 6c 20 73 65 | the|n all se|
|00002cd0| 61 72 63 68 65 73 20 61 | 72 65 20 61 75 74 6f 6d |arches a|re autom|
|00002ce0| 61 74 69 63 61 6c 6c 79 | 20 74 65 72 6d 69 6e 61 |atically| termina|
|00002cf0| 74 65 64 20 6a 75 73 74 | 20 20 61 73 0d 20 20 20 |ted just| as. |
|00002d00| 20 20 20 20 20 20 20 69 | 66 20 20 61 72 72 61 79 | i|f array|
|00002d10| 20 20 64 6f 6e 65 73 65 | 61 72 63 68 20 68 61 64 | donese|arch had|
|00002d20| 20 62 65 65 6e 20 69 6e | 76 6f 6b 65 64 3b 20 74 | been in|voked; t|
|00002d30| 68 69 73 20 77 69 6c 6c | 20 63 61 75 73 65 0d 20 |his will| cause. |
|00002d40| 20 20 20 20 20 20 20 20 | 20 61 72 72 61 79 20 20 | | array |
|00002d50| 6e 65 78 74 65 6c 65 6d | 65 6e 74 20 20 6f 70 65 |nextelem|ent ope|
|00002d60| 72 61 74 69 6f 6e 73 20 | 20 74 6f 20 20 20 66 61 |rations | to fa|
|00002d70| 69 6c 20 20 20 66 6f 72 | 20 20 20 74 68 6f 73 65 |il for| those|
|00002d80| 0d 20 20 20 20 20 20 20 | 20 20 20 73 65 61 72 63 |. | searc|
|00002d90| 68 65 73 2e 0d 0d 20 20 | 20 20 20 61 72 72 61 79 |hes... | array|
|00002da0| 20 73 69 7a 65 20 61 72 | 72 61 79 4e 61 6d 65 0d | size ar|rayName.|
|00002db0| 20 20 20 20 20 20 20 20 | 20 20 52 65 74 75 72 6e | | Return|
|00002dc0| 73 20 61 20 64 65 63 69 | 6d 61 6c 20 73 74 72 69 |s a deci|mal stri|
|00002dd0| 6e 67 20 67 69 76 69 6e | 67 20 74 68 65 20 6e 75 |ng givin|g the nu|
|00002de0| 6d 62 65 72 20 6f 66 20 | 20 65 6c 65 6d 65 6e 74 |mber of | element|
|00002df0| 73 0d 20 20 20 20 20 20 | 20 20 20 20 69 6e 20 74 |s. | in t|
|00002e00| 68 65 20 61 72 72 61 79 | 2e 0d 0d 20 20 20 20 20 |he array|... |
|00002e10| 61 72 72 61 79 20 73 74 | 61 72 74 73 65 61 72 63 |array st|artsearc|
|00002e20| 68 20 61 72 72 61 79 4e | 61 6d 65 0d 20 20 20 20 |h arrayN|ame. |
|00002e30| 20 20 20 20 20 20 54 68 | 69 73 20 63 6f 6d 6d 61 | Th|is comma|
|00002e40| 6e 64 20 69 6e 69 74 69 | 61 6c 69 7a 65 73 20 61 |nd initi|alizes a|
|00002e50| 6e 20 20 65 6c 65 6d 65 | 6e 74 2d 62 79 2d 65 6c |n eleme|nt-by-el|
|00002e60| 65 6d 65 6e 74 20 20 73 | 65 61 72 63 68 0d 20 20 |ement s|earch. |
|00002e70| 20 20 20 20 20 20 20 20 | 74 68 72 6f 75 67 68 20 | |through |
|00002e80| 74 68 65 20 61 72 72 61 | 79 20 67 69 76 65 6e 20 |the arra|y given |
|00002e90| 62 79 20 61 72 72 61 79 | 4e 61 6d 65 2c 20 73 75 |by array|Name, su|
|00002ea0| 63 68 20 74 68 61 74 20 | 69 6e 76 6f 63 61 2d 0d |ch that |invoca-.|
|00002eb0| 20 20 20 20 20 20 20 20 | 20 20 74 69 6f 6e 73 20 | | tions |
|00002ec0| 6f 66 20 74 68 65 20 61 | 72 72 61 79 20 6e 65 78 |of the a|rray nex|
|00002ed0| 74 65 6c 65 6d 65 6e 74 | 20 63 6f 6d 6d 61 6e 64 |telement| command|
|00002ee0| 20 77 69 6c 6c 20 72 65 | 74 75 72 6e 20 20 74 68 | will re|turn th|
|00002ef0| 65 0d 20 20 20 20 20 20 | 20 20 20 20 6e 61 6d 65 |e. | name|
|00002f00| 73 20 20 6f 66 20 20 74 | 68 65 20 20 69 6e 64 69 |s of t|he indi|
|00002f10| 76 69 64 75 61 6c 20 65 | 6c 65 6d 65 6e 74 73 20 |vidual e|lements |
|00002f20| 69 6e 20 74 68 65 20 61 | 72 72 61 79 2e 20 20 57 |in the a|rray. W|
|00002f30| 68 65 6e 0d 20 20 20 20 | 20 20 20 20 20 20 74 68 |hen. | th|
|00002f40| 65 20 73 65 61 72 63 68 | 20 68 61 73 20 62 65 65 |e search| has bee|
|00002f50| 6e 20 20 63 6f 6d 70 6c | 65 74 65 64 2c 20 20 74 |n compl|eted, t|
|00002f60| 68 65 20 20 61 72 72 61 | 79 20 20 64 6f 6e 65 73 |he arra|y dones|
|00002f70| 65 61 72 63 68 0d 20 20 | 20 20 20 20 20 20 20 20 |earch. | |
|00002f80| 63 6f 6d 6d 61 6e 64 20 | 20 73 68 6f 75 6c 64 20 |command | should |
|00002f90| 20 62 65 20 20 69 6e 76 | 6f 6b 65 64 2e 20 20 20 | be inv|oked. |
|00002fa0| 54 68 65 20 20 72 65 74 | 75 72 6e 20 20 76 61 6c |The ret|urn val|
|00002fb0| 75 65 20 69 73 20 61 0d | 20 20 20 20 20 20 20 20 |ue is a.| |
|00002fc0| 20 20 73 65 61 72 63 68 | 20 69 64 65 6e 74 69 66 | search| identif|
|00002fd0| 69 65 72 20 74 68 61 74 | 20 6d 75 73 74 20 62 65 |ier that| must be|
|00002fe0| 20 75 73 65 64 20 69 6e | 20 20 61 72 72 61 79 20 | used in| array |
|00002ff0| 20 6e 65 78 74 65 6c 65 | 2d 0d 20 20 20 20 20 20 | nextele|-. |
|00003000| 20 20 20 20 6d 65 6e 74 | 20 20 61 6e 64 20 61 72 | ment| and ar|
|00003010| 72 61 79 20 64 6f 6e 65 | 73 65 61 72 63 68 20 63 |ray done|search c|
|00003020| 6f 6d 6d 61 6e 64 73 3b | 20 69 74 20 61 6c 6c 6f |ommands;| it allo|
|00003030| 77 73 20 6d 75 6c 74 69 | 70 6c 65 0d 20 20 20 20 |ws multi|ple. |
|00003040| 20 20 20 20 20 20 73 65 | 61 72 63 68 65 73 20 74 | se|arches t|
|00003050| 6f 20 62 65 20 75 6e 64 | 65 72 77 61 79 20 20 73 |o be und|erway s|
|00003060| 69 6d 75 6c 74 61 6e 65 | 6f 75 73 6c 79 20 20 66 |imultane|ously f|
|00003070| 6f 72 20 20 74 68 65 20 | 20 73 61 6d 65 0d 20 20 |or the | same. |
|00003080| 20 20 20 20 20 20 20 20 | 61 72 72 61 79 2e 0d 0d | |array...|
|00003090| 0d 4b 45 59 57 4f 52 44 | 53 0d 20 20 20 20 20 61 |.KEYWORD|S. a|
|000030a0| 72 72 61 79 2c 20 65 6c | 65 6d 65 6e 74 20 6e 61 |rray, el|ement na|
|000030b0| 6d 65 73 2c 20 73 65 61 | 72 63 68 0d 0d 0d 5f 5f |mes, sea|rch...__|
|000030c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000030d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000030e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000030f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00003100| 0d 4e 41 4d 45 0d 20 20 | 20 20 20 62 72 65 61 6b |.NAME. | break|
|00003110| 20 2d 20 41 62 6f 72 74 | 20 6c 6f 6f 70 69 6e 67 | - Abort| looping|
|00003120| 20 63 6f 6d 6d 61 6e 64 | 0d 0d 53 59 4e 4f 50 53 | command|..SYNOPS|
|00003130| 49 53 0d 20 20 20 20 20 | 62 72 65 61 6b 0d 5f 5f |IS. |break.__|
|00003140| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003150| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003160| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003170| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00003180| 0d 0d 44 45 53 43 52 49 | 50 54 49 4f 4e 0d 20 20 |..DESCRI|PTION. |
|00003190| 20 20 20 54 68 69 73 20 | 63 6f 6d 6d 61 6e 64 20 | This |command |
|000031a0| 6d 61 79 20 62 65 20 69 | 6e 76 6f 6b 65 64 20 6f |may be i|nvoked o|
|000031b0| 6e 6c 79 20 69 6e 73 69 | 64 65 20 74 68 65 20 62 |nly insi|de the b|
|000031c0| 6f 64 79 20 6f 66 20 61 | 20 20 6c 6f 6f 70 2d 0d |ody of a| loop-.|
|000031d0| 20 20 20 20 20 69 6e 67 | 20 20 63 6f 6d 6d 61 6e | ing| comman|
|000031e0| 64 20 20 73 75 63 68 20 | 61 73 20 66 6f 72 20 6f |d such |as for o|
|000031f0| 72 20 66 6f 72 65 61 63 | 68 20 6f 72 20 77 68 69 |r foreac|h or whi|
|00003200| 6c 65 2e 20 20 49 74 20 | 72 65 74 75 72 6e 73 20 |le. It |returns |
|00003210| 61 0d 20 20 20 20 20 54 | 43 4c 5f 42 52 45 41 4b |a. T|CL_BREAK|
|00003220| 20 63 6f 64 65 20 74 6f | 20 73 69 67 6e 61 6c 20 | code to| signal |
|00003230| 74 68 65 20 69 6e 6e 65 | 72 6d 6f 73 74 20 63 6f |the inne|rmost co|
|00003240| 6e 74 61 69 6e 69 6e 67 | 20 6c 6f 6f 70 20 20 63 |ntaining| loop c|
|00003250| 6f 6d 2d 0d 20 20 20 20 | 20 6d 61 6e 64 20 74 6f |om-. | mand to|
|00003260| 20 72 65 74 75 72 6e 20 | 69 6d 6d 65 64 69 61 74 | return |immediat|
|00003270| 65 6c 79 2e 0d 0d 0d 4b | 45 59 57 4f 52 44 53 0d |ely....K|EYWORDS.|
|00003280| 20 20 20 20 20 61 62 6f | 72 74 2c 20 62 72 65 61 | abo|rt, brea|
|00003290| 6b 2c 20 6c 6f 6f 70 0d | 0d 0d 5f 5f 5f 5f 5f 5f |k, loop.|..______|
|000032a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000032b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000032c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000032d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 0d 0d 4e 41 4d |________|___..NAM|
|000032e0| 45 0d 20 20 20 20 20 63 | 61 73 65 20 2d 20 45 76 |E. c|ase - Ev|
|000032f0| 61 6c 75 61 74 65 20 6f | 6e 65 20 6f 66 20 73 65 |aluate o|ne of se|
|00003300| 76 65 72 61 6c 20 73 63 | 72 69 70 74 73 2c 20 64 |veral sc|ripts, d|
|00003310| 65 70 65 6e 64 69 6e 67 | 20 6f 6e 20 61 20 67 69 |epending| on a gi|
|00003320| 76 65 6e 0d 20 20 20 20 | 20 76 61 6c 75 65 0d 0d |ven. | value..|
|00003330| 53 59 4e 4f 50 53 49 53 | 0d 20 20 20 20 20 63 61 |SYNOPSIS|. ca|
|00003340| 73 65 20 73 74 72 69 6e | 67 20 3f 69 6e 3f 20 70 |se strin|g ?in? p|
|00003350| 61 74 4c 69 73 74 20 62 | 6f 64 79 20 3f 70 61 74 |atList b|ody ?pat|
|00003360| 4c 69 73 74 20 62 6f 64 | 79 20 2e 2e 2e 3f 0d 20 |List bod|y ...?. |
|00003370| 20 20 20 20 63 61 73 65 | 20 73 74 72 69 6e 67 20 | case| string |
|00003380| 3f 69 6e 3f 20 7b 70 61 | 74 4c 69 73 74 20 62 6f |?in? {pa|tList bo|
|00003390| 64 79 20 3f 70 61 74 4c | 69 73 74 20 62 6f 64 79 |dy ?patL|ist body|
|000033a0| 20 2e 2e 2e 3f 7d 0d 5f | 5f 5f 5f 5f 5f 5f 5f 5f | ...?}._|________|
|000033b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000033c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000033d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000033e0| 5f 5f 5f 5f 5f 5f 5f 5f | 0d 0d 0d 44 45 53 43 52 |________|...DESCR|
|000033f0| 49 50 54 49 4f 4e 0d 20 | 20 20 20 20 4e 6f 74 65 |IPTION. | Note|
|00003400| 3a 20 74 68 65 20 63 61 | 73 65 20 63 6f 6d 6d 61 |: the ca|se comma|
|00003410| 6e 64 20 69 73 20 6f 62 | 73 6f 6c 65 74 65 20 61 |nd is ob|solete a|
|00003420| 6e 64 20 69 73 20 73 75 | 70 70 6f 72 74 65 64 20 |nd is su|pported |
|00003430| 6f 6e 6c 79 20 66 6f 72 | 0d 20 20 20 20 20 62 61 |only for|. ba|
|00003440| 63 6b 77 61 72 64 20 20 | 63 6f 6d 70 61 74 69 62 |ckward |compatib|
|00003450| 69 6c 69 74 79 2e 20 20 | 41 74 20 73 6f 6d 65 20 |ility. |At some |
|00003460| 70 6f 69 6e 74 20 69 6e | 20 74 68 65 20 66 75 74 |point in| the fut|
|00003470| 75 72 65 20 69 74 20 6d | 61 79 0d 20 20 20 20 20 |ure it m|ay. |
|00003480| 62 65 20 72 65 6d 6f 76 | 65 64 20 65 6e 74 69 72 |be remov|ed entir|
|00003490| 65 6c 79 2e 20 20 59 6f | 75 20 20 73 68 6f 75 6c |ely. Yo|u shoul|
|000034a0| 64 20 20 75 73 65 20 20 | 74 68 65 20 20 73 77 69 |d use |the swi|
|000034b0| 74 63 68 20 20 63 6f 6d | 6d 61 6e 64 0d 20 20 20 |tch com|mand. |
|000034c0| 20 20 69 6e 73 74 65 61 | 64 2e 0d 0d 20 20 20 20 | instea|d... |
|000034d0| 20 54 68 65 20 63 61 73 | 65 20 63 6f 6d 6d 61 6e | The cas|e comman|
|000034e0| 64 20 6d 61 74 63 68 65 | 73 20 73 74 72 69 6e 67 |d matche|s string|
|000034f0| 20 61 67 61 69 6e 73 74 | 20 65 61 63 68 20 6f 66 | against| each of|
|00003500| 20 74 68 65 20 20 70 61 | 74 4c 69 73 74 0d 20 20 | the pa|tList. |
|00003510| 20 20 20 61 72 67 75 6d | 65 6e 74 73 20 20 69 6e | argum|ents in|
|00003520| 20 6f 72 64 65 72 2e 20 | 20 45 61 63 68 20 70 61 | order. | Each pa|
|00003530| 74 4c 69 73 74 20 61 72 | 67 75 6d 65 6e 74 20 69 |tList ar|gument i|
|00003540| 73 20 61 20 6c 69 73 74 | 20 6f 66 20 6f 6e 65 0d |s a list| of one.|
|00003550| 20 20 20 20 20 6f 72 20 | 6d 6f 72 65 20 70 61 74 | or |more pat|
|00003560| 74 65 72 6e 73 2e 20 20 | 49 66 20 61 6e 79 20 6f |terns. |If any o|
|00003570| 66 20 74 68 65 73 65 20 | 70 61 74 74 65 72 6e 73 |f these |patterns|
|00003580| 20 20 6d 61 74 63 68 65 | 73 20 20 73 74 72 69 6e | matche|s strin|
|00003590| 67 0d 20 20 20 20 20 74 | 68 65 6e 20 20 63 61 73 |g. t|hen cas|
|000035a0| 65 20 20 65 76 61 6c 75 | 61 74 65 73 20 74 68 65 |e evalu|ates the|
|000035b0| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 62 6f 64 79 20 | followi|ng body |
|000035c0| 61 72 67 75 6d 65 6e 74 | 20 62 79 20 70 61 73 73 |argument| by pass|
|000035d0| 69 6e 67 0d 20 20 20 20 | 20 69 74 20 72 65 63 75 |ing. | it recu|
|000035e0| 72 73 69 76 65 6c 79 20 | 74 6f 20 74 68 65 20 54 |rsively |to the T|
|000035f0| 63 6c 20 69 6e 74 65 72 | 70 72 65 74 65 72 20 61 |cl inter|preter a|
|00003600| 6e 64 20 72 65 74 75 72 | 6e 73 20 74 68 65 20 72 |nd retur|ns the r|
|00003610| 65 73 75 6c 74 0d 20 20 | 20 20 20 6f 66 20 20 74 |esult. | of t|
|00003620| 68 61 74 20 20 65 76 61 | 6c 75 61 74 69 6f 6e 2e |hat eva|luation.|
|00003630| 20 20 20 45 61 63 68 20 | 20 70 61 74 4c 69 73 74 | Each | patList|
|00003640| 20 61 72 67 75 6d 65 6e | 74 20 63 6f 6e 73 69 73 | argumen|t consis|
|00003650| 74 73 20 6f 66 20 61 0d | 20 20 20 20 20 73 69 6e |ts of a.| sin|
|00003660| 67 6c 65 20 70 61 74 74 | 65 72 6e 20 6f 72 20 6c |gle patt|ern or l|
|00003670| 69 73 74 20 6f 66 20 70 | 61 74 74 65 72 6e 73 2e |ist of p|atterns.|
|00003680| 20 20 45 61 63 68 20 70 | 61 74 74 65 72 6e 20 20 | Each p|attern |
|00003690| 6d 61 79 20 20 63 6f 6e | 2d 0d 20 20 20 20 20 74 |may con|-. t|
|000036a0| 61 69 6e 20 61 6e 79 20 | 6f 66 20 74 68 65 20 77 |ain any |of the w|
|000036b0| 69 6c 64 2d 63 61 72 64 | 73 20 64 65 73 63 72 69 |ild-card|s descri|
|000036c0| 62 65 64 20 75 6e 64 65 | 72 20 73 74 72 69 6e 67 |bed unde|r string|
|000036d0| 20 6d 61 74 63 68 2e 20 | 20 49 66 0d 20 20 20 20 | match. | If. |
|000036e0| 20 61 20 70 61 74 4c 69 | 73 74 20 61 72 67 75 6d | a patLi|st argum|
|000036f0| 65 6e 74 20 69 73 20 64 | 65 66 61 75 6c 74 2c 20 |ent is d|efault, |
|00003700| 74 68 65 20 63 6f 72 72 | 65 73 70 6f 6e 64 69 6e |the corr|espondin|
|00003710| 67 20 20 62 6f 64 79 20 | 20 77 69 6c 6c 0d 20 20 |g body | will. |
|00003720| 20 20 20 62 65 20 20 65 | 76 61 6c 75 61 74 65 64 | be e|valuated|
|00003730| 20 20 69 66 20 20 6e 6f | 20 70 61 74 4c 69 73 74 | if no| patList|
|00003740| 20 6d 61 74 63 68 65 73 | 20 73 74 72 69 6e 67 2e | matches| string.|
|00003750| 20 20 49 66 20 6e 6f 20 | 70 61 74 4c 69 73 74 0d | If no |patList.|
|00003760| 20 20 20 20 20 61 72 67 | 75 6d 65 6e 74 20 6d 61 | arg|ument ma|
|00003770| 74 63 68 65 73 20 73 74 | 72 69 6e 67 20 61 6e 64 |tches st|ring and|
|00003780| 20 6e 6f 20 64 65 66 61 | 75 6c 74 20 69 73 20 20 | no defa|ult is |
|00003790| 67 69 76 65 6e 2c 20 20 | 74 68 65 6e 20 20 74 68 |given, |then th|
|000037a0| 65 0d 20 20 20 20 20 63 | 61 73 65 20 63 6f 6d 6d |e. c|ase comm|
|000037b0| 61 6e 64 20 72 65 74 75 | 72 6e 73 20 61 6e 20 65 |and retu|rns an e|
|000037c0| 6d 70 74 79 20 73 74 72 | 69 6e 67 2e 0d 0d 20 20 |mpty str|ing... |
|000037d0| 20 20 20 54 77 6f 20 73 | 79 6e 74 61 78 65 73 20 | Two s|yntaxes |
|000037e0| 61 72 65 20 70 72 6f 76 | 69 64 65 64 20 66 6f 72 |are prov|ided for|
|000037f0| 20 74 68 65 20 20 70 61 | 74 4c 69 73 74 20 20 61 | the pa|tList a|
|00003800| 6e 64 20 20 62 6f 64 79 | 20 20 61 72 67 75 2d 0d |nd body| argu-.|
|00003810| 20 20 20 20 20 6d 65 6e | 74 73 2e 20 20 20 54 68 | men|ts. Th|
|00003820| 65 20 20 66 69 72 73 74 | 20 75 73 65 73 20 61 20 |e first| uses a |
|00003830| 73 65 70 61 72 61 74 65 | 20 61 72 67 75 6d 65 6e |separate| argumen|
|00003840| 74 20 66 6f 72 20 65 61 | 63 68 20 6f 66 20 74 68 |t for ea|ch of th|
|00003850| 65 0d 20 20 20 20 20 70 | 61 74 74 65 72 6e 73 20 |e. p|atterns |
|00003860| 61 6e 64 20 63 6f 6d 6d | 61 6e 64 73 3b 20 74 68 |and comm|ands; th|
|00003870| 69 73 20 66 6f 72 6d 20 | 69 73 20 63 6f 6e 76 65 |is form |is conve|
|00003880| 6e 69 65 6e 74 20 69 66 | 20 20 73 75 62 73 74 69 |nient if| substi|
|00003890| 74 75 2d 0d 20 20 20 20 | 20 74 69 6f 6e 73 20 20 |tu-. | tions |
|000038a0| 61 72 65 20 64 65 73 69 | 72 65 64 20 6f 6e 20 73 |are desi|red on s|
|000038b0| 6f 6d 65 20 6f 66 20 74 | 68 65 20 70 61 74 74 65 |ome of t|he patte|
|000038c0| 72 6e 73 20 6f 72 20 63 | 6f 6d 6d 61 6e 64 73 2e |rns or c|ommands.|
|000038d0| 20 20 54 68 65 0d 20 20 | 20 20 20 73 65 63 6f 6e | The. | secon|
|000038e0| 64 20 66 6f 72 6d 20 70 | 6c 61 63 65 73 20 61 6c |d form p|laces al|
|000038f0| 6c 20 6f 66 20 74 68 65 | 20 70 61 74 74 65 72 6e |l of the| pattern|
|00003900| 73 20 61 6e 64 20 63 6f | 6d 6d 61 6e 64 73 20 74 |s and co|mmands t|
|00003910| 6f 67 65 74 68 65 72 0d | 20 20 20 20 20 69 6e 74 |ogether.| int|
|00003920| 6f 20 20 61 20 20 73 69 | 6e 67 6c 65 20 61 72 67 |o a si|ngle arg|
|00003930| 75 6d 65 6e 74 3b 20 74 | 68 65 20 61 72 67 75 6d |ument; t|he argum|
|00003940| 65 6e 74 20 6d 75 73 74 | 20 68 61 76 65 20 70 72 |ent must| have pr|
|00003950| 6f 70 65 72 20 6c 69 73 | 74 0d 20 20 20 20 20 73 |oper lis|t. s|
|00003960| 74 72 75 63 74 75 72 65 | 2c 20 77 69 74 68 20 74 |tructure|, with t|
|00003970| 68 65 20 65 6c 65 6d 65 | 6e 74 73 20 6f 66 20 74 |he eleme|nts of t|
|00003980| 68 65 20 6c 69 73 74 20 | 62 65 69 6e 67 20 74 68 |he list |being th|
|00003990| 65 20 20 70 61 74 74 65 | 72 6e 73 0d 20 20 20 20 |e patte|rns. |
|000039a0| 20 61 6e 64 20 20 63 6f | 6d 6d 61 6e 64 73 2e 20 | and co|mmands. |
|000039b0| 20 20 54 68 65 20 20 73 | 65 63 6f 6e 64 20 66 6f | The s|econd fo|
|000039c0| 72 6d 20 6d 61 6b 65 73 | 20 69 74 20 65 61 73 79 |rm makes| it easy|
|000039d0| 20 74 6f 20 63 6f 6e 73 | 74 72 75 63 74 0d 20 20 | to cons|truct. |
|000039e0| 20 20 20 6d 75 6c 74 69 | 2d 6c 69 6e 65 20 63 61 | multi|-line ca|
|000039f0| 73 65 20 63 6f 6d 6d 61 | 6e 64 73 2c 20 73 69 6e |se comma|nds, sin|
|00003a00| 63 65 20 74 68 65 20 62 | 72 61 63 65 73 20 61 72 |ce the b|races ar|
|00003a10| 6f 75 6e 64 20 74 68 65 | 20 20 77 68 6f 6c 65 0d |ound the| whole.|
|00003a20| 20 20 20 20 20 6c 69 73 | 74 20 20 6d 61 6b 65 20 | lis|t make |
|00003a30| 20 69 74 20 75 6e 6e 65 | 63 65 73 73 61 72 79 20 | it unne|cessary |
|00003a40| 74 6f 20 69 6e 63 6c 75 | 64 65 20 61 20 62 61 63 |to inclu|de a bac|
|00003a50| 6b 73 6c 61 73 68 20 61 | 74 20 74 68 65 20 65 6e |kslash a|t the en|
|00003a60| 64 0d 20 20 20 20 20 6f | 66 20 65 61 63 68 20 6c |d. o|f each l|
|00003a70| 69 6e 65 2e 20 20 53 69 | 6e 63 65 20 74 68 65 20 |ine. Si|nce the |
|00003a80| 70 61 74 4c 69 73 74 20 | 61 72 67 75 6d 65 6e 74 |patList |argument|
|00003a90| 73 20 61 72 65 20 69 6e | 20 62 72 61 63 65 73 20 |s are in| braces |
|00003aa0| 20 69 6e 0d 20 20 20 20 | 20 74 68 65 20 20 73 65 | in. | the se|
|00003ab0| 63 6f 6e 64 20 20 66 6f | 72 6d 2c 20 20 6e 6f 20 |cond fo|rm, no |
|00003ac0| 63 6f 6d 6d 61 6e 64 20 | 6f 72 20 76 61 72 69 61 |command |or varia|
|00003ad0| 62 6c 65 20 73 75 62 73 | 74 69 74 75 74 69 6f 6e |ble subs|titution|
|00003ae0| 73 20 61 72 65 0d 20 20 | 20 20 20 70 65 72 66 6f |s are. | perfo|
|00003af0| 72 6d 65 64 20 6f 6e 20 | 74 68 65 6d 3b 20 20 74 |rmed on |them; t|
|00003b00| 68 69 73 20 6d 61 6b 65 | 73 20 74 68 65 20 62 65 |his make|s the be|
|00003b10| 68 61 76 69 6f 72 20 20 | 6f 66 20 20 74 68 65 20 |havior |of the |
|00003b20| 20 73 65 63 6f 6e 64 0d | 20 20 20 20 20 66 6f 72 | second.| for|
|00003b30| 6d 20 64 69 66 66 65 72 | 65 6e 74 20 74 68 61 6e |m differ|ent than|
|00003b40| 20 74 68 65 20 66 69 72 | 73 74 20 66 6f 72 6d 20 | the fir|st form |
|00003b50| 69 6e 20 73 6f 6d 65 20 | 63 61 73 65 73 2e 0d 0d |in some |cases...|
|00003b60| 0d 4b 45 59 57 4f 52 44 | 53 0d 20 20 20 20 20 63 |.KEYWORD|S. c|
|00003b70| 61 73 65 2c 20 6d 61 74 | 63 68 2c 20 72 65 67 75 |ase, mat|ch, regu|
|00003b80| 6c 61 72 20 65 78 70 72 | 65 73 73 69 6f 6e 0d 0d |lar expr|ession..|
|00003b90| 0d 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |._______|________|
|00003ba0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003bb0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003bc0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003bd0| 5f 5f 0d 0d 4e 41 4d 45 | 0d 20 20 20 20 20 63 61 |__..NAME|. ca|
|00003be0| 74 63 68 20 2d 20 45 76 | 61 6c 75 61 74 65 20 73 |tch - Ev|aluate s|
|00003bf0| 63 72 69 70 74 20 61 6e | 64 20 74 72 61 70 20 65 |cript an|d trap e|
|00003c00| 78 63 65 70 74 69 6f 6e | 61 6c 20 72 65 74 75 72 |xception|al retur|
|00003c10| 6e 73 0d 0d 53 59 4e 4f | 50 53 49 53 0d 20 20 20 |ns..SYNO|PSIS. |
|00003c20| 20 20 63 61 74 63 68 20 | 73 63 72 69 70 74 20 3f | catch |script ?|
|00003c30| 76 61 72 4e 61 6d 65 3f | 0d 5f 5f 5f 5f 5f 5f 5f |varName?|._______|
|00003c40| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003c50| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003c60| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003c70| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 0d 0d 44 45 53 |________|__...DES|
|00003c80| 43 52 49 50 54 49 4f 4e | 0d 20 20 20 20 20 54 68 |CRIPTION|. Th|
|00003c90| 65 20 63 61 74 63 68 20 | 63 6f 6d 6d 61 6e 64 20 |e catch |command |
|00003ca0| 6d 61 79 20 62 65 20 75 | 73 65 64 20 74 6f 20 70 |may be u|sed to p|
|00003cb0| 72 65 76 65 6e 74 20 65 | 72 72 6f 72 73 20 66 72 |revent e|rrors fr|
|00003cc0| 6f 6d 20 20 61 62 6f 72 | 74 2d 0d 20 20 20 20 20 |om abor|t-. |
|00003cd0| 69 6e 67 20 63 6f 6d 6d | 61 6e 64 20 69 6e 74 65 |ing comm|and inte|
|00003ce0| 72 70 72 65 74 61 74 69 | 6f 6e 2e 20 20 43 61 74 |rpretati|on. Cat|
|00003cf0| 63 68 20 63 61 6c 6c 73 | 20 74 68 65 20 54 63 6c |ch calls| the Tcl|
|00003d00| 20 69 6e 74 65 72 70 72 | 65 74 65 72 0d 20 20 20 | interpr|eter. |
|00003d10| 20 20 72 65 63 75 72 73 | 69 76 65 6c 79 20 74 6f | recurs|ively to|
|00003d20| 20 65 78 65 63 75 74 65 | 20 73 63 72 69 70 74 2c | execute| script,|
|00003d30| 20 61 6e 64 20 61 6c 77 | 61 79 73 20 72 65 74 75 | and alw|ays retu|
|00003d40| 72 6e 73 20 20 61 20 20 | 54 43 4c 5f 4f 4b 0d 20 |rns a |TCL_OK. |
|00003d50| 20 20 20 20 63 6f 64 65 | 2c 20 20 72 65 67 61 72 | code|, regar|
|00003d60| 64 6c 65 73 73 20 20 6f | 66 20 61 6e 79 20 65 72 |dless o|f any er|
|00003d70| 72 6f 72 73 20 74 68 61 | 74 20 6d 69 67 68 74 20 |rors tha|t might |
|00003d80| 6f 63 63 75 72 20 77 68 | 69 6c 65 20 65 78 65 2d |occur wh|ile exe-|
|00003d90| 0d 20 20 20 20 20 63 75 | 74 69 6e 67 20 73 63 72 |. cu|ting scr|
|00003da0| 69 70 74 2e 20 20 54 68 | 65 20 72 65 74 75 72 6e |ipt. Th|e return|
|00003db0| 20 76 61 6c 75 65 20 66 | 72 6f 6d 20 20 63 61 74 | value f|rom cat|
|00003dc0| 63 68 20 20 69 73 20 20 | 61 20 20 64 65 63 69 6d |ch is |a decim|
|00003dd0| 61 6c 0d 20 20 20 20 20 | 73 74 72 69 6e 67 20 67 |al. |string g|
|00003de0| 69 76 69 6e 67 20 74 68 | 65 20 63 6f 64 65 20 72 |iving th|e code r|
|00003df0| 65 74 75 72 6e 65 64 20 | 62 79 20 74 68 65 20 54 |eturned |by the T|
|00003e00| 63 6c 20 69 6e 74 65 72 | 70 72 65 74 65 72 20 61 |cl inter|preter a|
|00003e10| 66 74 65 72 0d 20 20 20 | 20 20 65 78 65 63 75 74 |fter. | execut|
|00003e20| 69 6e 67 20 73 63 72 69 | 70 74 2e 20 20 54 68 69 |ing scri|pt. Thi|
|00003e30| 73 20 77 69 6c 6c 20 62 | 65 20 30 20 28 54 43 4c |s will b|e 0 (TCL|
|00003e40| 5f 4f 4b 29 20 69 66 20 | 74 68 65 72 65 20 77 65 |_OK) if |there we|
|00003e50| 72 65 20 20 6e 6f 0d 20 | 20 20 20 20 65 72 72 6f |re no. | erro|
|00003e60| 72 73 20 20 69 6e 20 20 | 73 63 72 69 70 74 3b 20 |rs in |script; |
|00003e70| 20 6f 74 68 65 72 77 69 | 73 65 20 69 74 20 77 69 | otherwi|se it wi|
|00003e80| 6c 6c 20 68 61 76 65 20 | 61 20 6e 6f 6e 2d 7a 65 |ll have |a non-ze|
|00003e90| 72 6f 20 76 61 6c 75 65 | 0d 20 20 20 20 20 63 6f |ro value|. co|
|00003ea0| 72 72 65 73 70 6f 6e 64 | 69 6e 67 20 74 6f 20 6f |rrespond|ing to o|
|00003eb0| 6e 65 20 6f 66 20 74 68 | 65 20 65 78 63 65 70 74 |ne of th|e except|
|00003ec0| 69 6f 6e 61 6c 20 20 72 | 65 74 75 72 6e 20 20 63 |ional r|eturn c|
|00003ed0| 6f 64 65 73 20 20 28 73 | 65 65 0d 20 20 20 20 20 |odes (s|ee. |
|00003ee0| 74 63 6c 2e 68 20 20 66 | 6f 72 20 20 74 68 65 20 |tcl.h f|or the |
|00003ef0| 64 65 66 69 6e 69 74 69 | 6f 6e 73 20 6f 66 20 63 |definiti|ons of c|
|00003f00| 6f 64 65 20 76 61 6c 75 | 65 73 29 2e 20 20 49 66 |ode valu|es). If|
|00003f10| 20 74 68 65 20 76 61 72 | 4e 61 6d 65 0d 20 20 20 | the var|Name. |
|00003f20| 20 20 61 72 67 75 6d 65 | 6e 74 20 69 73 20 67 69 | argume|nt is gi|
|00003f30| 76 65 6e 2c 20 74 68 65 | 6e 20 69 74 20 67 69 76 |ven, the|n it giv|
|00003f40| 65 73 20 74 68 65 20 20 | 6e 61 6d 65 20 20 6f 66 |es the |name of|
|00003f50| 20 20 61 20 20 76 61 72 | 69 61 62 6c 65 3b 0d 20 | a var|iable;. |
|00003f60| 20 20 20 20 63 61 74 63 | 68 20 20 77 69 6c 6c 20 | catc|h will |
|00003f70| 20 73 65 74 20 20 74 68 | 65 20 20 76 61 72 69 61 | set th|e varia|
|00003f80| 62 6c 65 20 20 74 6f 20 | 74 68 65 20 73 74 72 69 |ble to |the stri|
|00003f90| 6e 67 20 72 65 74 75 72 | 6e 65 64 20 66 72 6f 6d |ng retur|ned from|
|00003fa0| 0d 20 20 20 20 20 73 63 | 72 69 70 74 20 28 65 69 |. sc|ript (ei|
|00003fb0| 74 68 65 72 20 61 20 72 | 65 73 75 6c 74 20 6f 72 |ther a r|esult or|
|00003fc0| 20 61 6e 20 65 72 72 6f | 72 20 6d 65 73 73 61 67 | an erro|r messag|
|00003fd0| 65 29 2e 0d 0d 0d 4b 45 | 59 57 4f 52 44 53 0d 20 |e)....KE|YWORDS. |
|00003fe0| 20 20 20 20 63 61 74 63 | 68 2c 20 65 72 72 6f 72 | catc|h, error|
|00003ff0| 0d 0d 0d 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..._____|________|
|00004000| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004010| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004020| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004030| 5f 5f 5f 5f 0d 0d 4e 41 | 4d 45 0d 20 20 20 20 20 |____..NA|ME. |
|00004040| 63 64 20 2d 20 43 68 61 | 6e 67 65 20 77 6f 72 6b |cd - Cha|nge work|
|00004050| 69 6e 67 20 64 69 72 65 | 63 74 6f 72 79 0d 0d 53 |ing dire|ctory..S|
|00004060| 59 4e 4f 50 53 49 53 0d | 20 20 20 20 20 63 64 20 |YNOPSIS.| cd |
|00004070| 3f 64 69 72 4e 61 6d 65 | 3f 0d 5f 5f 5f 5f 5f 5f |?dirName|?.______|
|00004080| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004090| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000040a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000040b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 0d 0d 0d 44 45 |________|___...DE|
|000040c0| 53 43 52 49 50 54 49 4f | 4e 0d 20 20 20 20 20 43 |SCRIPTIO|N. C|
|000040d0| 68 61 6e 67 65 20 74 68 | 65 20 63 75 72 72 65 6e |hange th|e curren|
|000040e0| 74 20 77 6f 72 6b 69 6e | 67 20 64 69 72 65 63 74 |t workin|g direct|
|000040f0| 6f 72 79 20 74 6f 20 64 | 69 72 4e 61 6d 65 2c 20 |ory to d|irName, |
|00004100| 6f 72 20 20 74 6f 20 20 | 74 68 65 0d 20 20 20 20 |or to |the. |
|00004110| 20 68 6f 6d 65 20 20 64 | 69 72 65 63 74 6f 72 79 | home d|irectory|
|00004120| 20 20 28 61 73 20 73 70 | 65 63 69 66 69 65 64 20 | (as sp|ecified |
|00004130| 69 6e 20 74 68 65 20 48 | 4f 4d 45 20 65 6e 76 69 |in the H|OME envi|
|00004140| 72 6f 6e 6d 65 6e 74 20 | 76 61 72 69 2d 0d 20 20 |ronment |vari-. |
|00004150| 20 20 20 61 62 6c 65 29 | 20 69 66 20 64 69 72 4e | able)| if dirN|
|00004160| 61 6d 65 20 69 73 20 6e | 6f 74 20 67 69 76 65 6e |ame is n|ot given|
|00004170| 2e 20 20 49 66 20 20 64 | 69 72 4e 61 6d 65 20 20 |. If d|irName |
|00004180| 73 74 61 72 74 73 20 20 | 77 69 74 68 20 20 61 0d |starts |with a.|
|00004190| 20 20 20 20 20 74 69 6c | 64 65 2c 20 20 20 74 68 | til|de, th|
|000041a0| 65 6e 20 20 74 69 6c 64 | 65 2d 65 78 70 61 6e 73 |en tild|e-expans|
|000041b0| 69 6f 6e 20 20 69 73 20 | 20 64 6f 6e 65 20 20 61 |ion is | done a|
|000041c0| 73 20 20 64 65 73 63 72 | 69 62 65 64 20 20 66 6f |s descr|ibed fo|
|000041d0| 72 0d 20 20 20 20 20 54 | 63 6c 5f 54 69 6c 64 65 |r. T|cl_Tilde|
|000041e0| 53 75 62 73 74 2e 20 20 | 52 65 74 75 72 6e 73 20 |Subst. |Returns |
|000041f0| 61 6e 20 65 6d 70 74 79 | 20 73 74 72 69 6e 67 2e |an empty| string.|
|00004200| 0d 0d 0d 4b 45 59 57 4f | 52 44 53 0d 20 20 20 20 |...KEYWO|RDS. |
|00004210| 20 77 6f 72 6b 69 6e 67 | 20 64 69 72 65 63 74 6f | working| directo|
|00004220| 72 79 0d 0d 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ry...___|________|
|00004230| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004240| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004250| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004260| 5f 5f 5f 5f 5f 5f 0d 0d | 4e 41 4d 45 0d 20 20 20 |______..|NAME. |
|00004270| 20 20 63 6c 6f 73 65 20 | 2d 20 43 6c 6f 73 65 20 | close |- Close |
|00004280| 61 6e 20 6f 70 65 6e 20 | 66 69 6c 65 0d 0d 53 59 |an open |file..SY|
|00004290| 4e 4f 50 53 49 53 0d 20 | 20 20 20 20 63 6c 6f 73 |NOPSIS. | clos|
|000042a0| 65 20 66 69 6c 65 49 64 | 0d 5f 5f 5f 5f 5f 5f 5f |e fileId|._______|
|000042b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000042c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000042d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000042e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 0d 0d 44 45 53 |________|__...DES|
|000042f0| 43 52 49 50 54 49 4f 4e | 0d 20 20 20 20 20 43 6c |CRIPTION|. Cl|
|00004300| 6f 73 65 73 20 74 68 65 | 20 66 69 6c 65 20 67 69 |oses the| file gi|
|00004310| 76 65 6e 20 62 79 20 66 | 69 6c 65 49 64 2e 20 20 |ven by f|ileId. |
|00004320| 46 69 6c 65 49 64 20 6d | 75 73 74 20 62 65 20 74 |FileId m|ust be t|
|00004330| 68 65 20 20 72 65 74 75 | 72 6e 0d 20 20 20 20 20 |he retu|rn. |
|00004340| 76 61 6c 75 65 20 20 66 | 72 6f 6d 20 61 20 70 72 |value f|rom a pr|
|00004350| 65 76 69 6f 75 73 20 69 | 6e 76 6f 63 61 74 69 6f |evious i|nvocatio|
|00004360| 6e 20 6f 66 20 74 68 65 | 20 6f 70 65 6e 20 63 6f |n of the| open co|
|00004370| 6d 6d 61 6e 64 3b 20 61 | 66 74 65 72 0d 20 20 20 |mmand; a|fter. |
|00004380| 20 20 74 68 69 73 20 63 | 6f 6d 6d 61 6e 64 2c 20 | this c|ommand, |
|00004390| 69 74 20 73 68 6f 75 6c | 64 20 6e 6f 74 20 20 62 |it shoul|d not b|
|000043a0| 65 20 20 75 73 65 64 20 | 20 61 6e 79 6d 6f 72 65 |e used | anymore|
|000043b0| 2e 20 20 20 49 66 20 20 | 66 69 6c 65 49 64 0d 20 |. If |fileId. |
|000043c0| 20 20 20 20 72 65 66 65 | 72 73 20 20 74 6f 20 20 | refe|rs to |
|000043d0| 61 20 63 6f 6d 6d 61 6e | 64 20 70 69 70 65 6c 69 |a comman|d pipeli|
|000043e0| 6e 65 20 69 6e 73 74 65 | 61 64 20 6f 66 20 61 20 |ne inste|ad of a |
|000043f0| 66 69 6c 65 2c 20 74 68 | 65 6e 20 63 6c 6f 73 65 |file, th|en close|
|00004400| 0d 20 20 20 20 20 77 61 | 69 74 73 20 66 6f 72 20 |. wa|its for |
|00004410| 74 68 65 20 63 68 69 6c | 64 72 65 6e 20 74 6f 20 |the chil|dren to |
|00004420| 63 6f 6d 70 6c 65 74 65 | 2e 20 20 54 68 65 20 20 |complete|. The |
|00004430| 6e 6f 72 6d 61 6c 20 20 | 72 65 73 75 6c 74 20 20 |normal |result |
|00004440| 6f 66 0d 20 20 20 20 20 | 74 68 69 73 20 20 63 6f |of. |this co|
|00004450| 6d 6d 61 6e 64 20 69 73 | 20 61 6e 20 65 6d 70 74 |mmand is| an empt|
|00004460| 79 20 73 74 72 69 6e 67 | 2c 20 62 75 74 20 65 72 |y string|, but er|
|00004470| 72 6f 72 73 20 61 72 65 | 20 72 65 74 75 72 6e 65 |rors are| returne|
|00004480| 64 20 69 66 0d 20 20 20 | 20 20 74 68 65 72 65 20 |d if. | there |
|00004490| 61 72 65 20 70 72 6f 62 | 6c 65 6d 73 20 69 6e 20 |are prob|lems in |
|000044a0| 63 6c 6f 73 69 6e 67 20 | 74 68 65 20 66 69 6c 65 |closing |the file|
|000044b0| 20 6f 72 20 77 61 69 74 | 69 6e 67 20 66 6f 72 20 | or wait|ing for |
|000044c0| 20 63 68 69 6c 2d 0d 20 | 20 20 20 20 64 72 65 6e | chil-. | dren|
|000044d0| 20 74 6f 20 63 6f 6d 70 | 6c 65 74 65 2e 0d 0d 0d | to comp|lete....|
|000044e0| 4b 45 59 57 4f 52 44 53 | 0d 20 20 20 20 20 63 6c |KEYWORDS|. cl|
|000044f0| 6f 73 65 2c 20 66 69 6c | 65 0d 0d 0d 5f 5f 5f 5f |ose, fil|e...____|
|00004500| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004510| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004520| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004530| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 0d 0d 4e |________|_____..N|
|00004540| 41 4d 45 0d 20 20 20 20 | 20 63 6f 6e 63 61 74 20 |AME. | concat |
|00004550| 2d 20 4a 6f 69 6e 20 6c | 69 73 74 73 20 74 6f 67 |- Join l|ists tog|
|00004560| 65 74 68 65 72 0d 0d 53 | 59 4e 4f 50 53 49 53 0d |ether..S|YNOPSIS.|
|00004570| 20 20 20 20 20 63 6f 6e | 63 61 74 20 3f 61 72 67 | con|cat ?arg|
|00004580| 20 61 72 67 20 2e 2e 2e | 3f 20 20 20 20 20 20 20 | arg ...|? |
|00004590| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000045a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000045b0| 20 20 20 7c 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f | |.___|________|
|000045c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000045d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000045e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000045f0| 5f 5f 5f 5f 5f 5f 0d 0d | 0d 44 45 53 43 52 49 50 |______..|.DESCRIP|
|00004600| 54 49 4f 4e 0d 20 20 20 | 20 20 54 68 69 73 20 63 |TION. | This c|
|00004610| 6f 6d 6d 61 6e 64 20 74 | 72 65 61 74 73 20 65 61 |ommand t|reats ea|
|00004620| 63 68 20 61 72 67 75 6d | 65 6e 74 20 61 73 20 61 |ch argum|ent as a|
|00004630| 20 6c 69 73 74 20 61 6e | 64 20 63 6f 6e 63 61 74 | list an|d concat|
|00004640| 65 6e 61 74 65 73 0d 20 | 20 20 20 20 74 68 65 6d |enates. | them|
|00004650| 20 20 69 6e 74 6f 20 20 | 61 20 20 73 69 6e 67 6c | into |a singl|
|00004660| 65 20 20 6c 69 73 74 2e | 20 20 49 74 20 61 6c 73 |e list.| It als|
|00004670| 6f 20 65 6c 69 6d 69 6e | 61 74 65 73 20 6c 65 61 |o elimin|ates lea|
|00004680| 64 69 6e 67 20 61 6e 64 | 0d 20 20 20 20 20 74 72 |ding and|. tr|
|00004690| 61 69 6c 69 6e 67 20 73 | 70 61 63 65 73 20 69 6e |ailing s|paces in|
|000046a0| 20 74 68 65 20 61 72 67 | 27 73 20 61 6e 64 20 20 | the arg|'s and |
|000046b0| 61 64 64 73 20 20 61 20 | 20 73 69 6e 67 6c 65 20 |adds a | single |
|000046c0| 20 73 65 70 61 72 61 74 | 6f 72 0d 20 20 20 20 20 | separat|or. |
|000046d0| 73 70 61 63 65 20 20 62 | 65 74 77 65 65 6e 20 20 |space b|etween |
|000046e0| 61 72 67 27 73 2e 20 20 | 20 49 74 20 70 65 72 6d |arg's. | It perm|
|000046f0| 69 74 73 20 61 6e 79 20 | 6e 75 6d 62 65 72 20 6f |its any |number o|
|00004700| 66 20 61 72 67 75 6d 65 | 6e 74 73 2e 0d 20 20 20 |f argume|nts.. |
|00004710| 20 20 46 6f 72 20 65 78 | 61 6d 70 6c 65 2c 20 74 | For ex|ample, t|
|00004720| 68 65 20 63 6f 6d 6d 61 | 6e 64 0d 0d 20 20 20 20 |he comma|nd.. |
|00004730| 20 20 20 20 20 20 63 6f | 6e 63 61 74 20 61 20 62 | co|ncat a b|
|00004740| 20 7b 63 20 64 20 65 7d | 20 7b 66 20 7b 67 20 68 | {c d e}| {f {g h|
|00004750| 7d 7d 0d 20 20 20 20 20 | 77 69 6c 6c 20 72 65 74 |}}. |will ret|
|00004760| 75 72 6e 0d 0d 20 20 20 | 20 20 20 20 20 20 20 61 |urn.. | a|
|00004770| 20 62 20 63 20 64 20 65 | 20 66 20 7b 67 20 68 7d | b c d e| f {g h}|
|00004780| 0d 20 20 20 20 20 61 73 | 20 69 74 73 20 72 65 73 |. as| its res|
|00004790| 75 6c 74 2e 0d 0d 20 20 | 20 20 20 49 66 20 6e 6f |ult... | If no|
|000047a0| 20 61 72 67 73 20 61 72 | 65 20 73 75 70 70 6c 69 | args ar|e suppli|
|000047b0| 65 64 2c 20 74 68 65 20 | 72 65 73 75 6c 74 20 69 |ed, the |result i|
|000047c0| 73 20 61 6e 20 65 6d 70 | 74 79 20 73 74 72 69 6e |s an emp|ty strin|
|000047d0| 67 2e 20 20 20 20 20 20 | 20 7c 0d 0d 0d 4b 45 59 |g. | |...KEY|
|000047e0| 57 4f 52 44 53 0d 20 20 | 20 20 20 63 6f 6e 63 61 |WORDS. | conca|
|000047f0| 74 65 6e 61 74 65 2c 20 | 6a 6f 69 6e 2c 20 6c 69 |tenate, |join, li|
|00004800| 73 74 73 0d 0d 0d 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |sts...__|________|
|00004810| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004820| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004830| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004840| 5f 5f 5f 5f 5f 5f 5f 0d | 0d 4e 41 4d 45 0d 20 20 |_______.|.NAME. |
|00004850| 20 20 20 63 6f 6e 74 69 | 6e 75 65 20 2d 20 53 6b | conti|nue - Sk|
|00004860| 69 70 20 74 6f 20 74 68 | 65 20 6e 65 78 74 20 69 |ip to th|e next i|
|00004870| 74 65 72 61 74 69 6f 6e | 20 6f 66 20 61 20 6c 6f |teration| of a lo|
|00004880| 6f 70 0d 0d 53 59 4e 4f | 50 53 49 53 0d 20 20 20 |op..SYNO|PSIS. |
|00004890| 20 20 63 6f 6e 74 69 6e | 75 65 0d 5f 5f 5f 5f 5f | contin|ue._____|
|000048a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000048b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000048c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000048d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 0d 0d 44 |________|____...D|
|000048e0| 45 53 43 52 49 50 54 49 | 4f 4e 0d 20 20 20 20 20 |ESCRIPTI|ON. |
|000048f0| 54 68 69 73 20 63 6f 6d | 6d 61 6e 64 20 6d 61 79 |This com|mand may|
|00004900| 20 62 65 20 69 6e 76 6f | 6b 65 64 20 6f 6e 6c 79 | be invo|ked only|
|00004910| 20 69 6e 73 69 64 65 20 | 74 68 65 20 62 6f 64 79 | inside |the body|
|00004920| 20 6f 66 20 61 20 20 6c | 6f 6f 70 2d 0d 20 20 20 | of a l|oop-. |
|00004930| 20 20 69 6e 67 20 20 63 | 6f 6d 6d 61 6e 64 20 20 | ing c|ommand |
|00004940| 73 75 63 68 20 61 73 20 | 66 6f 72 20 6f 72 20 66 |such as |for or f|
|00004950| 6f 72 65 61 63 68 20 6f | 72 20 77 68 69 6c 65 2e |oreach o|r while.|
|00004960| 20 20 49 74 20 72 65 74 | 75 72 6e 73 20 61 0d 20 | It ret|urns a. |
|00004970| 20 20 20 20 54 43 4c 5f | 43 4f 4e 54 49 4e 55 45 | TCL_|CONTINUE|
|00004980| 20 63 6f 64 65 20 74 6f | 20 73 69 67 6e 61 6c 20 | code to| signal |
|00004990| 74 68 65 20 20 69 6e 6e | 65 72 6d 6f 73 74 20 20 |the inn|ermost |
|000049a0| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 20 6c 6f 6f 70 |containi|ng loop|
|000049b0| 0d 20 20 20 20 20 63 6f | 6d 6d 61 6e 64 20 20 74 |. co|mmand t|
|000049c0| 6f 20 20 73 6b 69 70 20 | 20 74 68 65 20 72 65 6d |o skip | the rem|
|000049d0| 61 69 6e 64 65 72 20 6f | 66 20 74 68 65 20 6c 6f |ainder o|f the lo|
|000049e0| 6f 70 27 73 20 62 6f 64 | 79 20 62 75 74 20 63 6f |op's bod|y but co|
|000049f0| 6e 2d 0d 20 20 20 20 20 | 74 69 6e 75 65 20 77 69 |n-. |tinue wi|
|00004a00| 74 68 20 74 68 65 20 6e | 65 78 74 20 69 74 65 72 |th the n|ext iter|
|00004a10| 61 74 69 6f 6e 20 6f 66 | 20 74 68 65 20 6c 6f 6f |ation of| the loo|
|00004a20| 70 2e 0d 0d 0d 4b 45 59 | 57 4f 52 44 53 0d 20 20 |p....KEY|WORDS. |
|00004a30| 20 20 20 63 6f 6e 74 69 | 6e 75 65 2c 20 69 74 65 | conti|nue, ite|
|00004a40| 72 61 74 69 6f 6e 2c 20 | 6c 6f 6f 70 0d 0d 0d 5f |ration, |loop..._|
|00004a50| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004a60| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004a70| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004a80| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004a90| 0d 0d 4e 41 4d 45 0d 20 | 20 20 20 20 65 6f 66 20 |..NAME. | eof |
|00004aa0| 2d 20 43 68 65 63 6b 20 | 66 6f 72 20 65 6e 64 2d |- Check |for end-|
|00004ab0| 6f 66 2d 66 69 6c 65 20 | 63 6f 6e 64 69 74 69 6f |of-file |conditio|
|00004ac0| 6e 20 6f 6e 20 6f 70 65 | 6e 20 66 69 6c 65 0d 0d |n on ope|n file..|
|00004ad0| 53 59 4e 4f 50 53 49 53 | 0d 20 20 20 20 20 65 6f |SYNOPSIS|. eo|
|00004ae0| 66 20 66 69 6c 65 49 64 | 0d 5f 5f 5f 5f 5f 5f 5f |f fileId|._______|
|00004af0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004b00| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004b10| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004b20| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 0d 0d 44 45 53 |________|__...DES|
|00004b30| 43 52 49 50 54 49 4f 4e | 0d 20 20 20 20 20 52 65 |CRIPTION|. Re|
|00004b40| 74 75 72 6e 73 20 31 20 | 20 69 66 20 20 61 6e 20 |turns 1 | if an |
|00004b50| 20 65 6e 64 2d 6f 66 2d | 66 69 6c 65 20 20 63 6f | end-of-|file co|
|00004b60| 6e 64 69 74 69 6f 6e 20 | 20 68 61 73 20 20 6f 63 |ndition | has oc|
|00004b70| 63 75 72 72 65 64 20 20 | 6f 6e 0d 20 20 20 20 20 |curred |on. |
|00004b80| 66 69 6c 65 49 64 2c 20 | 30 20 6f 74 68 65 72 77 |fileId, |0 otherw|
|00004b90| 69 73 65 2e 20 20 46 69 | 6c 65 49 64 20 6d 75 73 |ise. Fi|leId mus|
|00004ba0| 74 20 68 61 76 65 20 62 | 65 65 6e 20 74 68 65 20 |t have b|een the |
|00004bb0| 72 65 74 75 72 6e 20 76 | 61 6c 75 65 0d 20 20 20 |return v|alue. |
|00004bc0| 20 20 66 72 6f 6d 20 61 | 20 70 72 65 76 69 6f 75 | from a| previou|
|00004bd0| 73 20 63 61 6c 6c 20 74 | 6f 20 6f 70 65 6e 2c 20 |s call t|o open, |
|00004be0| 6f 72 20 69 74 20 6d 61 | 79 20 62 65 20 73 74 64 |or it ma|y be std|
|00004bf0| 69 6e 2c 20 73 74 64 6f | 75 74 2c 20 6f 72 0d 20 |in, stdo|ut, or. |
|00004c00| 20 20 20 20 73 74 64 65 | 72 72 20 74 6f 20 72 65 | stde|rr to re|
|00004c10| 66 65 72 20 74 6f 20 6f | 6e 65 20 6f 66 20 74 68 |fer to o|ne of th|
|00004c20| 65 20 73 74 61 6e 64 61 | 72 64 20 49 2f 4f 20 63 |e standa|rd I/O c|
|00004c30| 68 61 6e 6e 65 6c 73 2e | 0d 0d 0d 4b 45 59 57 4f |hannels.|...KEYWO|
|00004c40| 52 44 53 0d 20 20 20 20 | 20 65 6e 64 2c 20 66 69 |RDS. | end, fi|
|00004c50| 6c 65 0d 0d 0d 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |le...___|________|
|00004c60| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004c70| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004c80| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004c90| 5f 5f 5f 5f 5f 5f 0d 0d | 4e 41 4d 45 0d 20 20 20 |______..|NAME. |
|00004ca0| 20 20 65 72 72 6f 72 20 | 2d 20 47 65 6e 65 72 61 | error |- Genera|
|00004cb0| 74 65 20 61 6e 20 65 72 | 72 6f 72 0d 0d 53 59 4e |te an er|ror..SYN|
|00004cc0| 4f 50 53 49 53 0d 20 20 | 20 20 20 65 72 72 6f 72 |OPSIS. | error|
|00004cd0| 20 6d 65 73 73 61 67 65 | 20 3f 69 6e 66 6f 3f 20 | message| ?info? |
|00004ce0| 3f 63 6f 64 65 3f 0d 5f | 5f 5f 5f 5f 5f 5f 5f 5f |?code?._|________|
|00004cf0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004d00| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004d10| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004d20| 5f 5f 5f 5f 5f 5f 5f 5f | 0d 0d 0d 44 45 53 43 52 |________|...DESCR|
|00004d30| 49 50 54 49 4f 4e 0d 20 | 20 20 20 20 52 65 74 75 |IPTION. | Retu|
|00004d40| 72 6e 73 20 61 20 54 43 | 4c 5f 45 52 52 4f 52 20 |rns a TC|L_ERROR |
|00004d50| 63 6f 64 65 2c 20 77 68 | 69 63 68 20 63 61 75 73 |code, wh|ich caus|
|00004d60| 65 73 20 20 63 6f 6d 6d | 61 6e 64 20 20 69 6e 74 |es comm|and int|
|00004d70| 65 72 70 72 65 74 61 2d | 0d 20 20 20 20 20 74 69 |erpreta-|. ti|
|00004d80| 6f 6e 20 74 6f 20 62 65 | 20 75 6e 77 6f 75 6e 64 |on to be| unwound|
|00004d90| 2e 20 20 4d 65 73 73 61 | 67 65 20 69 73 20 61 20 |. Messa|ge is a |
|00004da0| 73 74 72 69 6e 67 20 74 | 68 61 74 20 69 73 20 72 |string t|hat is r|
|00004db0| 65 74 75 72 6e 65 64 20 | 74 6f 0d 20 20 20 20 20 |eturned |to. |
|00004dc0| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |the appl|ication |
|00004dd0| 74 6f 20 69 6e 64 69 63 | 61 74 65 20 77 68 61 74 |to indic|ate what|
|00004de0| 20 77 65 6e 74 20 77 72 | 6f 6e 67 2e 0d 0d 20 20 | went wr|ong... |
|00004df0| 20 20 20 49 66 20 74 68 | 65 20 69 6e 66 6f 20 61 | If th|e info a|
|00004e00| 72 67 75 6d 65 6e 74 20 | 69 73 20 70 72 6f 76 69 |rgument |is provi|
|00004e10| 64 65 64 20 61 6e 64 20 | 20 69 73 20 20 6e 6f 6e |ded and | is non|
|00004e20| 2d 65 6d 70 74 79 2c 20 | 20 69 74 20 20 69 73 0d |-empty, | it is.|
|00004e30| 20 20 20 20 20 75 73 65 | 64 20 74 6f 20 69 6e 69 | use|d to ini|
|00004e40| 74 69 61 6c 69 7a 65 20 | 74 68 65 20 67 6c 6f 62 |tialize |the glob|
|00004e50| 61 6c 20 76 61 72 69 61 | 62 6c 65 20 65 72 72 6f |al varia|ble erro|
|00004e60| 72 49 6e 66 6f 2e 20 20 | 65 72 72 6f 72 49 6e 66 |rInfo. |errorInf|
|00004e70| 6f 0d 20 20 20 20 20 69 | 73 20 75 73 65 64 20 74 |o. i|s used t|
|00004e80| 6f 20 61 63 63 75 6d 75 | 6c 61 74 65 20 61 20 73 |o accumu|late a s|
|00004e90| 74 61 63 6b 20 74 72 61 | 63 65 20 6f 66 20 77 68 |tack tra|ce of wh|
|00004ea0| 61 74 20 77 61 73 20 69 | 6e 20 20 70 72 6f 67 72 |at was i|n progr|
|00004eb0| 65 73 73 0d 20 20 20 20 | 20 77 68 65 6e 20 20 61 |ess. | when a|
|00004ec0| 6e 20 20 65 72 72 6f 72 | 20 6f 63 63 75 72 72 65 |n error| occurre|
|00004ed0| 64 3b 20 61 73 20 6e 65 | 73 74 65 64 20 63 6f 6d |d; as ne|sted com|
|00004ee0| 6d 61 6e 64 73 20 75 6e | 77 69 6e 64 2c 20 74 68 |mands un|wind, th|
|00004ef0| 65 20 54 63 6c 0d 20 20 | 20 20 20 69 6e 74 65 72 |e Tcl. | inter|
|00004f00| 70 72 65 74 65 72 20 61 | 64 64 73 20 69 6e 66 6f |preter a|dds info|
|00004f10| 72 6d 61 74 69 6f 6e 20 | 20 74 6f 20 20 65 72 72 |rmation | to err|
|00004f20| 6f 72 49 6e 66 6f 2e 20 | 20 20 49 66 20 20 74 68 |orInfo. | If th|
|00004f30| 65 20 20 69 6e 66 6f 0d | 20 20 20 20 20 61 72 67 |e info.| arg|
|00004f40| 75 6d 65 6e 74 20 20 69 | 73 20 70 72 65 73 65 6e |ument i|s presen|
|00004f50| 74 2c 20 69 74 20 69 73 | 20 75 73 65 64 20 74 6f |t, it is| used to|
|00004f60| 20 69 6e 69 74 69 61 6c | 69 7a 65 20 65 72 72 6f | initial|ize erro|
|00004f70| 72 49 6e 66 6f 20 61 6e | 64 0d 20 20 20 20 20 74 |rInfo an|d. t|
|00004f80| 68 65 20 66 69 72 73 74 | 20 69 6e 63 72 65 6d 65 |he first| increme|
|00004f90| 6e 74 20 6f 66 20 75 6e | 77 69 6e 64 20 69 6e 66 |nt of un|wind inf|
|00004fa0| 6f 72 6d 61 74 69 6f 6e | 20 77 69 6c 6c 20 6e 6f |ormation| will no|
|00004fb0| 74 20 62 65 20 20 61 64 | 64 65 64 0d 20 20 20 20 |t be ad|ded. |
|00004fc0| 20 62 79 20 20 74 68 65 | 20 20 54 63 6c 20 20 69 | by the| Tcl i|
|00004fd0| 6e 74 65 72 70 72 65 74 | 65 72 2e 20 20 49 6e 20 |nterpret|er. In |
|00004fe0| 6f 74 68 65 72 20 77 6f | 72 64 73 2c 20 74 68 65 |other wo|rds, the|
|00004ff0| 20 63 6f 6d 6d 61 6e 64 | 20 63 6f 6e 2d 0d 20 20 | command| con-. |
|00005000| 20 20 20 74 61 69 6e 69 | 6e 67 20 74 68 65 20 65 | taini|ng the e|
|00005010| 72 72 6f 72 20 63 6f 6d | 6d 61 6e 64 20 77 69 6c |rror com|mand wil|
|00005020| 6c 20 6e 6f 74 20 61 70 | 70 65 61 72 20 69 6e 20 |l not ap|pear in |
|00005030| 20 65 72 72 6f 72 49 6e | 66 6f 3b 20 20 69 6e 0d | errorIn|fo; in.|
|00005040| 20 20 20 20 20 69 74 73 | 20 70 6c 61 63 65 20 77 | its| place w|
|00005050| 69 6c 6c 20 62 65 20 69 | 6e 66 6f 2e 20 20 54 68 |ill be i|nfo. Th|
|00005060| 69 73 20 66 65 61 74 75 | 72 65 20 69 73 20 6d 6f |is featu|re is mo|
|00005070| 73 74 20 75 73 65 66 75 | 6c 20 69 6e 20 63 6f 6e |st usefu|l in con|
|00005080| 2d 0d 20 20 20 20 20 6a | 75 6e 63 74 69 6f 6e 20 |-. j|unction |
|00005090| 77 69 74 68 20 74 68 65 | 20 63 61 74 63 68 20 63 |with the| catch c|
|000050a0| 6f 6d 6d 61 6e 64 3a 20 | 69 66 20 61 20 63 61 75 |ommand: |if a cau|
|000050b0| 67 68 74 20 65 72 72 6f | 72 20 63 61 6e 6e 6f 74 |ght erro|r cannot|
|000050c0| 20 62 65 0d 20 20 20 20 | 20 68 61 6e 64 6c 65 64 | be. | handled|
|000050d0| 20 20 73 75 63 63 65 73 | 73 66 75 6c 6c 79 2c 20 | succes|sfully, |
|000050e0| 20 69 6e 66 6f 20 20 63 | 61 6e 20 20 62 65 20 75 | info c|an be u|
|000050f0| 73 65 64 20 74 6f 20 72 | 65 74 75 72 6e 20 61 20 |sed to r|eturn a |
|00005100| 73 74 61 63 6b 0d 20 20 | 20 20 20 74 72 61 63 65 |stack. | trace|
|00005110| 20 72 65 66 6c 65 63 74 | 69 6e 67 20 74 68 65 20 | reflect|ing the |
|00005120| 6f 72 69 67 69 6e 61 6c | 20 70 6f 69 6e 74 20 20 |original| point |
|00005130| 6f 66 20 20 6f 63 63 75 | 72 72 65 6e 63 65 20 20 |of occu|rrence |
|00005140| 6f 66 20 20 74 68 65 0d | 20 20 20 20 20 65 72 72 |of the.| err|
|00005150| 6f 72 3a 0d 0d 20 20 20 | 20 20 20 20 20 20 20 63 |or:.. | c|
|00005160| 61 74 63 68 20 7b 2e 2e | 2e 7d 20 65 72 72 4d 73 |atch {..|.} errMs|
|00005170| 67 0d 20 20 20 20 20 20 | 20 20 20 20 73 65 74 20 |g. | set |
|00005180| 73 61 76 65 64 49 6e 66 | 6f 20 24 65 72 72 6f 72 |savedInf|o $error|
|00005190| 49 6e 66 6f 0d 20 20 20 | 20 20 20 20 20 20 20 2e |Info. | .|
|000051a0| 2e 2e 0d 20 20 20 20 20 | 20 20 20 20 20 65 72 72 |... | err|
|000051b0| 6f 72 20 24 65 72 72 4d | 73 67 20 24 73 61 76 65 |or $errM|sg $save|
|000051c0| 64 49 6e 66 6f 0d 0d 20 | 20 20 20 20 49 66 20 74 |dInfo.. | If t|
|000051d0| 68 65 20 63 6f 64 65 20 | 61 72 67 75 6d 65 6e 74 |he code |argument|
|000051e0| 20 69 73 20 70 72 65 73 | 65 6e 74 2c 20 74 68 65 | is pres|ent, the|
|000051f0| 6e 20 69 74 73 20 76 61 | 6c 75 65 20 69 73 20 73 |n its va|lue is s|
|00005200| 74 6f 72 65 64 20 69 6e | 0d 20 20 20 20 20 74 68 |tored in|. th|
|00005210| 65 20 65 72 72 6f 72 43 | 6f 64 65 20 67 6c 6f 62 |e errorC|ode glob|
|00005220| 61 6c 20 76 61 72 69 61 | 62 6c 65 2e 20 20 54 68 |al varia|ble. Th|
|00005230| 69 73 20 76 61 72 69 61 | 62 6c 65 20 69 73 20 69 |is varia|ble is i|
|00005240| 6e 74 65 6e 64 65 64 20 | 74 6f 0d 20 20 20 20 20 |ntended |to. |
|00005250| 68 6f 6c 64 20 61 20 6d | 61 63 68 69 6e 65 2d 72 |hold a m|achine-r|
|00005260| 65 61 64 61 62 6c 65 20 | 64 65 73 63 72 69 70 74 |eadable |descript|
|00005270| 69 6f 6e 20 6f 66 20 74 | 68 65 20 20 65 72 72 6f |ion of t|he erro|
|00005280| 72 20 20 69 6e 20 20 63 | 61 73 65 73 0d 20 20 20 |r in c|ases. |
|00005290| 20 20 77 68 65 72 65 20 | 20 73 75 63 68 20 69 6e | where | such in|
|000052a0| 66 6f 72 6d 61 74 69 6f | 6e 20 69 73 20 61 76 61 |formatio|n is ava|
|000052b0| 69 6c 61 62 6c 65 3b 20 | 73 65 65 20 74 68 65 20 |ilable; |see the |
|000052c0| 73 65 63 74 69 6f 6e 20 | 42 55 49 4c 54 2d 0d 20 |section |BUILT-. |
|000052d0| 20 20 20 20 49 4e 20 56 | 41 52 49 41 42 4c 45 53 | IN V|ARIABLES|
|000052e0| 20 62 65 6c 6f 77 20 66 | 6f 72 20 69 6e 66 6f 72 | below f|or infor|
|000052f0| 6d 61 74 69 6f 6e 20 6f | 6e 20 74 68 65 20 70 72 |mation o|n the pr|
|00005300| 6f 70 65 72 20 66 6f 72 | 6d 61 74 20 20 66 6f 72 |oper for|mat for|
|00005310| 0d 20 20 20 20 20 74 68 | 65 20 20 76 61 72 69 61 |. th|e varia|
|00005320| 62 6c 65 2e 20 20 20 49 | 66 20 20 74 68 65 20 20 |ble. I|f the |
|00005330| 63 6f 64 65 20 61 72 67 | 75 6d 65 6e 74 20 69 73 |code arg|ument is|
|00005340| 20 6e 6f 74 20 70 72 65 | 73 65 6e 74 2c 20 74 68 | not pre|sent, th|
|00005350| 65 6e 0d 20 20 20 20 20 | 65 72 72 6f 72 43 6f 64 |en. |errorCod|
|00005360| 65 20 69 73 20 61 75 74 | 6f 6d 61 74 69 63 61 6c |e is aut|omatical|
|00005370| 6c 79 20 72 65 73 65 74 | 20 20 74 6f 20 20 60 60 |ly reset| to ``|
|00005380| 4e 4f 4e 45 27 27 20 20 | 62 79 20 20 74 68 65 20 |NONE'' |by the |
|00005390| 20 54 63 6c 0d 20 20 20 | 20 20 69 6e 74 65 72 70 | Tcl. | interp|
|000053a0| 72 65 74 65 72 20 61 73 | 20 70 61 72 74 20 6f 66 |reter as| part of|
|000053b0| 20 70 72 6f 63 65 73 73 | 69 6e 67 20 74 68 65 20 | process|ing the |
|000053c0| 65 72 72 6f 72 20 67 65 | 6e 65 72 61 74 65 64 20 |error ge|nerated |
|000053d0| 62 79 20 74 68 65 0d 20 | 20 20 20 20 63 6f 6d 6d |by the. | comm|
|000053e0| 61 6e 64 2e 0d 0d 0d 4b | 45 59 57 4f 52 44 53 0d |and....K|EYWORDS.|
|000053f0| 20 20 20 20 20 65 72 72 | 6f 72 2c 20 65 72 72 6f | err|or, erro|
|00005400| 72 43 6f 64 65 2c 20 65 | 72 72 6f 72 49 6e 66 6f |rCode, e|rrorInfo|
|00005410| 0d 0d 0d 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..._____|________|
|00005420| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005430| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005440| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005450| 5f 5f 5f 5f 0d 0d 4e 41 | 4d 45 0d 20 20 20 20 20 |____..NA|ME. |
|00005460| 65 76 61 6c 20 2d 20 45 | 76 61 6c 75 61 74 65 20 |eval - E|valuate |
|00005470| 61 20 54 63 6c 20 73 63 | 72 69 70 74 0d 0d 53 59 |a Tcl sc|ript..SY|
|00005480| 4e 4f 50 53 49 53 0d 20 | 20 20 20 20 65 76 61 6c |NOPSIS. | eval|
|00005490| 20 61 72 67 20 3f 61 72 | 67 20 2e 2e 2e 3f 0d 5f | arg ?ar|g ...?._|
|000054a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000054b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000054c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000054d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000054e0| 0d 0d 0d 44 45 53 43 52 | 49 50 54 49 4f 4e 0d 20 |...DESCR|IPTION. |
|000054f0| 20 20 20 20 45 76 61 6c | 20 74 61 6b 65 73 20 6f | Eval| takes o|
|00005500| 6e 65 20 6f 72 20 6d 6f | 72 65 20 61 72 67 75 6d |ne or mo|re argum|
|00005510| 65 6e 74 73 2c 20 77 68 | 69 63 68 20 74 6f 67 65 |ents, wh|ich toge|
|00005520| 74 68 65 72 20 63 6f 6d | 70 72 69 73 65 20 20 61 |ther com|prise a|
|00005530| 0d 20 20 20 20 20 54 63 | 6c 20 20 73 63 72 69 70 |. Tc|l scrip|
|00005540| 74 20 63 6f 6e 74 61 69 | 6e 69 6e 67 20 6f 6e 65 |t contai|ning one|
|00005550| 20 6f 72 20 6d 6f 72 65 | 20 63 6f 6d 6d 61 6e 64 | or more| command|
|00005560| 73 2e 20 20 45 76 61 6c | 20 63 6f 6e 63 61 74 65 |s. Eval| concate|
|00005570| 6e 2d 0d 20 20 20 20 20 | 61 74 65 73 20 61 6c 6c |n-. |ates all|
|00005580| 20 69 74 73 20 61 72 67 | 75 6d 65 6e 74 73 20 69 | its arg|uments i|
|00005590| 6e 20 74 68 65 20 73 61 | 6d 65 20 20 66 61 73 68 |n the sa|me fash|
|000055a0| 69 6f 6e 20 20 61 73 20 | 20 74 68 65 20 20 63 6f |ion as | the co|
|000055b0| 6e 63 61 74 0d 20 20 20 | 20 20 63 6f 6d 6d 61 6e |ncat. | comman|
|000055c0| 64 2c 20 20 70 61 73 73 | 65 73 20 20 74 68 65 20 |d, pass|es the |
|000055d0| 20 63 6f 6e 63 61 74 65 | 6e 61 74 65 64 20 73 74 | concate|nated st|
|000055e0| 72 69 6e 67 20 74 6f 20 | 74 68 65 20 54 63 6c 20 |ring to |the Tcl |
|000055f0| 69 6e 74 65 72 2d 0d 20 | 20 20 20 20 70 72 65 74 |inter-. | pret|
|00005600| 65 72 20 72 65 63 75 72 | 73 69 76 65 6c 79 2c 20 |er recur|sively, |
|00005610| 61 6e 64 20 72 65 74 75 | 72 6e 73 20 74 68 65 20 |and retu|rns the |
|00005620| 72 65 73 75 6c 74 20 6f | 66 20 20 74 68 61 74 20 |result o|f that |
|00005630| 20 65 76 61 6c 75 61 2d | 0d 20 20 20 20 20 74 69 | evalua-|. ti|
|00005640| 6f 6e 20 28 6f 72 20 61 | 6e 79 20 65 72 72 6f 72 |on (or a|ny error|
|00005650| 20 67 65 6e 65 72 61 74 | 65 64 20 62 79 20 69 74 | generat|ed by it|
|00005660| 29 2e 0d 0d 0d 4b 45 59 | 57 4f 52 44 53 0d 20 20 |)....KEY|WORDS. |
|00005670| 20 20 20 63 6f 6e 63 61 | 74 65 6e 61 74 65 2c 20 | conca|tenate, |
|00005680| 65 76 61 6c 75 61 74 65 | 2c 20 73 63 72 69 70 74 |evaluate|, script|
|00005690| 0d 0d 0d 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..._____|________|
|000056a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000056b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000056c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000056d0| 5f 5f 5f 5f 0d 0d 4e 41 | 4d 45 0d 20 20 20 20 20 |____..NA|ME. |
|000056e0| 65 78 65 63 20 2d 20 49 | 6e 76 6f 6b 65 20 73 75 |exec - I|nvoke su|
|000056f0| 62 70 72 6f 63 65 73 73 | 28 65 73 29 0d 0d 53 59 |bprocess|(es)..SY|
|00005700| 4e 4f 50 53 49 53 0d 20 | 20 20 20 20 65 78 65 63 |NOPSIS. | exec|
|00005710| 20 3f 73 77 69 74 63 68 | 65 73 3f 20 61 72 67 20 | ?switch|es? arg |
|00005720| 3f 61 72 67 20 2e 2e 2e | 3f 0d 5f 5f 5f 5f 5f 5f |?arg ...|?.______|
|00005730| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005740| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005750| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005760| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 0d 0d 0d 44 45 |________|___...DE|
|00005770| 53 43 52 49 50 54 49 4f | 4e 0d 20 20 20 20 20 54 |SCRIPTIO|N. T|
|00005780| 68 69 73 20 63 6f 6d 6d | 61 6e 64 20 74 72 65 61 |his comm|and trea|
|00005790| 74 73 20 69 74 73 20 61 | 72 67 75 6d 65 6e 74 73 |ts its a|rguments|
|000057a0| 20 61 73 20 20 74 68 65 | 20 20 73 70 65 63 69 66 | as the| specif|
|000057b0| 69 63 61 74 69 6f 6e 20 | 20 6f 66 0d 20 20 20 20 |ication | of. |
|000057c0| 20 6f 6e 65 20 6f 72 20 | 6d 6f 72 65 20 73 75 62 | one or |more sub|
|000057d0| 70 72 6f 63 65 73 73 65 | 73 20 74 6f 20 65 78 65 |processe|s to exe|
|000057e0| 63 75 74 65 2e 20 20 54 | 68 65 20 61 72 67 75 6d |cute. T|he argum|
|000057f0| 65 6e 74 73 20 74 61 6b | 65 20 74 68 65 0d 20 20 |ents tak|e the. |
|00005800| 20 20 20 66 6f 72 6d 20 | 6f 66 20 61 20 73 74 61 | form |of a sta|
|00005810| 6e 64 61 72 64 20 73 68 | 65 6c 6c 20 70 69 70 65 |ndard sh|ell pipe|
|00005820| 6c 69 6e 65 20 77 68 65 | 72 65 20 65 61 63 68 20 |line whe|re each |
|00005830| 61 72 67 20 62 65 63 6f | 6d 65 73 20 6f 6e 65 0d |arg beco|mes one.|
|00005840| 20 20 20 20 20 77 6f 72 | 64 20 20 6f 66 20 61 20 | wor|d of a |
|00005850| 63 6f 6d 6d 61 6e 64 2c | 20 61 6e 64 20 65 61 63 |command,| and eac|
|00005860| 68 20 64 69 73 74 69 6e | 63 74 20 63 6f 6d 6d 61 |h distin|ct comma|
|00005870| 6e 64 20 62 65 63 6f 6d | 65 73 20 61 20 73 75 62 |nd becom|es a sub|
|00005880| 2d 0d 20 20 20 20 20 70 | 72 6f 63 65 73 73 2e 0d |-. p|rocess..|
|00005890| 0d 20 20 20 20 20 49 66 | 20 74 68 65 20 69 6e 69 |. If| the ini|
|000058a0| 74 69 61 6c 20 61 72 67 | 75 6d 65 6e 74 73 20 74 |tial arg|uments t|
|000058b0| 6f 20 65 78 65 63 20 73 | 74 61 72 74 20 77 69 74 |o exec s|tart wit|
|000058c0| 68 20 2d 20 74 68 65 6e | 20 74 68 65 79 20 20 61 |h - then| they a|
|000058d0| 72 65 20 20 7c 0d 20 20 | 20 20 20 74 72 65 61 74 |re |. | treat|
|000058e0| 65 64 20 20 61 73 20 20 | 63 6f 6d 6d 61 6e 64 2d |ed as |command-|
|000058f0| 6c 69 6e 65 20 20 73 77 | 69 74 63 68 65 73 20 20 |line sw|itches |
|00005900| 61 6e 64 20 61 72 65 20 | 6e 6f 74 20 70 61 72 74 |and are |not part|
|00005910| 20 6f 66 20 74 68 65 20 | 20 7c 0d 20 20 20 20 20 | of the | |. |
|00005920| 70 69 70 65 6c 69 6e 65 | 20 20 73 70 65 63 69 66 |pipeline| specif|
|00005930| 69 63 61 74 69 6f 6e 2e | 20 20 20 20 54 68 65 20 |ication.| The |
|00005940| 20 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 20 20 73 77 | follow|ing sw|
|00005950| 69 74 63 68 65 73 20 20 | 20 61 72 65 20 20 7c 0d |itches | are |.|
|00005960| 20 20 20 20 20 63 75 72 | 72 65 6e 74 6c 79 20 73 | cur|rently s|
|00005970| 75 70 70 6f 72 74 65 64 | 3a 20 20 20 20 20 20 20 |upported|: |
|00005980| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005990| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000059a0| 20 20 20 7c 0d 0d 20 20 | 20 20 20 2d 6b 65 65 70 | |.. | -keep|
|000059b0| 6e 65 77 2d 20 20 7c 0d | 20 20 20 20 20 20 20 20 |new- |.| |
|000059c0| 20 20 20 20 20 20 20 20 | 20 20 6c 69 6e 65 20 20 | | line |
|000059d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000059e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000059f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005a00| 20 20 20 20 20 7c 7c 0d | 20 20 20 20 20 20 20 20 | ||.| |
|00005a10| 20 20 20 20 20 20 20 20 | 20 20 52 65 74 61 69 6e | | Retain|
|00005a20| 73 20 61 20 74 72 61 69 | 6c 69 6e 67 20 6e 65 77 |s a trai|ling new|
|00005a30| 6c 69 6e 65 20 20 69 6e | 20 20 74 68 65 20 20 70 |line in| the p|
|00005a40| 69 70 65 6c 69 6e 65 27 | 73 20 20 7c 0d 20 20 20 |ipeline'|s |. |
|00005a50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 6f | | o|
|00005a60| 75 74 70 75 74 2e 20 20 | 20 4e 6f 72 6d 61 6c 6c |utput. | Normall|
|00005a70| 79 20 20 61 20 20 74 72 | 61 69 6c 69 6e 67 20 6e |y a tr|ailing n|
|00005a80| 65 77 6c 69 6e 65 20 77 | 69 6c 6c 20 62 65 20 20 |ewline w|ill be |
|00005a90| 7c 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||. | |
|00005aa0| 20 20 20 20 64 65 6c 65 | 74 65 64 2e 20 20 20 20 | dele|ted. |
|00005ab0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005ac0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005ad0| 20 20 20 20 20 7c 0d 0d | 20 20 20 20 20 2d 2d 20 | |..| -- |
|00005ae0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005af0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005b00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005b10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005b20| 7c 7c 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |||. | |
|00005b30| 20 20 20 20 20 4d 61 72 | 6b 73 20 20 74 68 65 20 | Mar|ks the |
|00005b40| 20 65 6e 64 20 6f 66 20 | 73 77 69 74 63 68 65 73 | end of |switches|
|00005b50| 2e 20 20 54 68 65 20 61 | 72 67 75 6d 65 6e 74 20 |. The a|rgument |
|00005b60| 66 6f 6c 2d 20 20 7c 0d | 20 20 20 20 20 20 20 20 |fol- |.| |
|00005b70| 20 20 20 20 20 20 20 20 | 20 20 6c 6f 77 69 6e 67 | | lowing|
|00005b80| 20 74 68 69 73 20 6f 6e | 65 20 77 69 6c 6c 20 62 | this on|e will b|
|00005b90| 65 20 74 72 65 61 74 65 | 64 20 20 61 73 20 20 74 |e treate|d as t|
|00005ba0| 68 65 20 20 66 69 72 73 | 74 20 20 7c 0d 20 20 20 |he firs|t |. |
|00005bb0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 61 | | a|
|00005bc0| 72 67 20 65 76 65 6e 20 | 69 66 20 69 74 20 73 74 |rg even |if it st|
|00005bd0| 61 72 74 73 20 77 69 74 | 68 20 61 20 2d 2e 0d 0d |arts wit|h a -...|
|00005be0| 20 20 20 20 20 49 66 20 | 61 6e 20 61 72 67 20 28 | If |an arg (|
|00005bf0| 6f 72 20 70 61 69 72 20 | 6f 66 20 61 72 67 27 73 |or pair |of arg's|
|00005c00| 29 20 68 61 73 20 6f 6e | 65 20 6f 66 20 74 68 65 |) has on|e of the|
|00005c10| 20 66 6f 72 6d 73 20 20 | 64 65 73 63 72 69 62 65 | forms |describe|
|00005c20| 64 0d 20 20 20 20 20 62 | 65 6c 6f 77 20 20 74 68 |d. b|elow th|
|00005c30| 65 6e 20 20 69 74 20 69 | 73 20 75 73 65 64 20 62 |en it i|s used b|
|00005c40| 79 20 65 78 65 63 20 74 | 6f 20 63 6f 6e 74 72 6f |y exec t|o contro|
|00005c50| 6c 20 74 68 65 20 66 6c | 6f 77 20 6f 66 20 69 6e |l the fl|ow of in|
|00005c60| 70 75 74 0d 20 20 20 20 | 20 61 6e 64 20 6f 75 74 |put. | and out|
|00005c70| 70 75 74 20 61 6d 6f 6e | 67 20 74 68 65 20 73 75 |put amon|g the su|
|00005c80| 62 70 72 6f 63 65 73 73 | 28 65 73 29 2e 20 20 20 |bprocess|(es). |
|00005c90| 53 75 63 68 20 20 61 72 | 67 75 6d 65 6e 74 73 20 |Such ar|guments |
|00005ca0| 20 77 69 6c 6c 0d 20 20 | 20 20 20 6e 6f 74 20 20 | will. | not |
|00005cb0| 62 65 20 20 70 61 73 73 | 65 64 20 74 6f 20 74 68 |be pass|ed to th|
|00005cc0| 65 20 73 75 62 70 72 6f | 63 65 73 73 28 65 73 29 |e subpro|cess(es)|
|00005cd0| 2e 20 20 49 6e 20 66 6f | 72 6d 73 20 73 75 63 68 |. In fo|rms such|
|00005ce0| 20 61 73 20 60 60 3c 20 | 20 7c 0d 20 20 20 20 20 | as ``< | |. |
|00005cf0| 66 69 6c 65 4e 61 6d 65 | 27 27 20 66 69 6c 65 4e |fileName|'' fileN|
|00005d00| 61 6d 65 20 6d 61 79 20 | 65 69 74 68 65 72 20 62 |ame may |either b|
|00005d10| 65 20 20 69 6e 20 20 61 | 20 20 73 65 70 61 72 61 |e in a| separa|
|00005d20| 74 65 20 20 61 72 67 75 | 6d 65 6e 74 20 20 7c 0d |te argu|ment |.|
|00005d30| 20 20 20 20 20 66 72 6f | 6d 20 60 60 3c 27 27 20 | fro|m ``<'' |
|00005d40| 6f 72 20 69 6e 20 74 68 | 65 20 73 61 6d 65 20 61 |or in th|e same a|
|00005d50| 72 67 75 6d 65 6e 74 20 | 77 69 74 68 20 6e 6f 20 |rgument |with no |
|00005d60| 69 6e 74 65 72 76 65 6e | 69 6e 67 20 73 70 61 63 |interven|ing spac|
|00005d70| 65 20 20 7c 0d 20 20 20 | 20 20 28 69 2e 65 2e 20 |e |. | (i.e. |
|00005d80| 60 60 3c 66 69 6c 65 4e | 61 6d 65 27 27 29 2e 0d |``<fileN|ame'')..|
|00005d90| 0d 20 20 20 20 20 7c 20 | 20 20 20 20 20 20 20 20 |. | | |
|00005da0| 20 20 20 20 20 53 65 70 | 61 72 61 74 65 73 20 64 | Sep|arates d|
|00005db0| 69 73 74 69 6e 63 74 20 | 63 6f 6d 6d 61 6e 64 73 |istinct |commands|
|00005dc0| 20 69 6e 20 74 68 65 20 | 20 70 69 70 65 6c 69 6e | in the | pipelin|
|00005dd0| 65 2e 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |e.. | |
|00005de0| 20 20 20 20 20 20 20 54 | 68 65 20 20 73 74 61 6e | T|he stan|
|00005df0| 64 61 72 64 20 6f 75 74 | 70 75 74 20 6f 66 20 74 |dard out|put of t|
|00005e00| 68 65 20 70 72 65 63 65 | 64 69 6e 67 20 63 6f 6d |he prece|ding com|
|00005e10| 6d 61 6e 64 0d 20 20 20 | 20 20 20 20 20 20 20 20 |mand. | |
|00005e20| 20 20 20 20 20 20 20 20 | 20 77 69 6c 6c 20 62 65 | | will be|
|00005e30| 20 70 69 70 65 64 20 69 | 6e 74 6f 20 74 68 65 20 | piped i|nto the |
|00005e40| 73 74 61 6e 64 61 72 64 | 20 69 6e 70 75 74 20 6f |standard| input o|
|00005e50| 66 20 20 74 68 65 0d 20 | 20 20 20 20 20 20 20 20 |f the. | |
|00005e60| 20 20 20 20 20 20 20 20 | 20 20 20 6e 65 78 74 20 | | next |
|00005e70| 63 6f 6d 6d 61 6e 64 2e | 0d 0d 20 20 20 20 20 7c |command.|.. ||
|00005e80| 26 20 20 20 20 20 20 20 | 20 20 20 20 20 20 53 65 |& | Se|
|00005e90| 70 61 72 61 74 65 73 20 | 64 69 73 74 69 6e 63 74 |parates |distinct|
|00005ea0| 20 63 6f 6d 6d 61 6e 64 | 73 20 69 6e 20 74 68 65 | command|s in the|
|00005eb0| 20 20 70 69 70 65 6c 69 | 6e 65 2e 0d 20 20 20 20 | pipeli|ne.. |
|00005ec0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005ed0| 42 6f 74 68 20 20 73 74 | 61 6e 64 61 72 64 20 20 |Both st|andard |
|00005ee0| 6f 75 74 70 75 74 20 20 | 61 6e 64 20 73 74 61 6e |output |and stan|
|00005ef0| 64 61 72 64 20 65 72 72 | 6f 72 20 6f 66 0d 20 20 |dard err|or of. |
|00005f00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005f10| 20 20 74 68 65 20 70 72 | 65 63 65 64 69 6e 67 20 | the pr|eceding |
|00005f20| 63 6f 6d 6d 61 6e 64 20 | 77 69 6c 6c 20 62 65 20 |command |will be |
|00005f30| 70 69 70 65 64 20 69 6e | 74 6f 20 20 74 68 65 0d |piped in|to the.|
|00005f40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005f50| 20 20 20 20 73 74 61 6e | 64 61 72 64 20 20 69 6e | stan|dard in|
|00005f60| 70 75 74 20 20 6f 66 20 | 20 74 68 65 20 20 6e 65 |put of | the ne|
|00005f70| 78 74 20 63 6f 6d 6d 61 | 6e 64 2e 20 20 54 68 69 |xt comma|nd. Thi|
|00005f80| 73 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |s. | |
|00005f90| 20 20 20 20 20 20 66 6f | 72 6d 20 6f 66 20 72 65 | fo|rm of re|
|00005fa0| 64 69 72 65 63 74 69 6f | 6e 20 6f 76 65 72 72 69 |directio|n overri|
|00005fb0| 64 65 73 20 66 6f 72 6d | 73 20 20 73 75 63 68 20 |des form|s such |
|00005fc0| 20 61 73 0d 20 20 20 20 | 20 20 20 20 20 20 20 20 | as. | |
|00005fd0| 20 20 20 20 20 20 20 20 | 32 3e 20 61 6e 64 20 3e | |2> and >|
|00005fe0| 26 2e 0d 0d 20 20 20 20 | 20 3c 20 66 69 6c 65 4e |&... | < fileN|
|00005ff0| 61 6d 65 20 20 20 20 20 | 54 68 65 20 66 69 6c 65 |ame |The file|
|00006000| 20 6e 61 6d 65 64 20 62 | 79 20 66 69 6c 65 4e 61 | named b|y fileNa|
|00006010| 6d 65 20 69 73 20 6f 70 | 65 6e 65 64 20 61 6e 64 |me is op|ened and|
|00006020| 20 75 73 65 64 0d 20 20 | 20 20 20 20 20 20 20 20 | used. | |
|00006030| 20 20 20 20 20 20 20 20 | 20 20 61 73 20 20 74 68 | | as th|
|00006040| 65 20 20 73 74 61 6e 64 | 61 72 64 20 69 6e 70 75 |e stand|ard inpu|
|00006050| 74 20 66 6f 72 20 74 68 | 65 20 66 69 72 73 74 20 |t for th|e first |
|00006060| 63 6f 6d 6d 61 6e 64 0d | 20 20 20 20 20 20 20 20 |command.| |
|00006070| 20 20 20 20 20 20 20 20 | 20 20 20 20 69 6e 20 74 | | in t|
|00006080| 68 65 20 70 69 70 65 6c | 69 6e 65 2e 0d 0d 20 20 |he pipel|ine... |
|00006090| 20 20 20 3c 40 20 66 69 | 6c 65 49 64 20 20 20 20 | <@ fi|leId |
|000060a0| 20 20 46 69 6c 65 49 64 | 20 6d 75 73 74 20 62 65 | FileId| must be|
|000060b0| 20 74 68 65 20 20 69 64 | 65 6e 74 69 66 69 65 72 | the id|entifier|
|000060c0| 20 20 66 6f 72 20 20 61 | 6e 20 20 6f 70 65 6e 20 | for a|n open |
|000060d0| 20 7c 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | |. | |
|000060e0| 20 20 20 20 20 20 20 66 | 69 6c 65 2c 20 20 73 75 | f|ile, su|
|000060f0| 63 68 20 61 73 20 74 68 | 65 20 72 65 74 75 72 6e |ch as th|e return|
|00006100| 20 76 61 6c 75 65 20 66 | 72 6f 6d 20 61 20 70 72 | value f|rom a pr|
|00006110| 65 76 69 2d 20 20 7c 0d | 20 20 20 20 20 20 20 20 |evi- |.| |
|00006120| 20 20 20 20 20 20 20 20 | 20 20 20 20 6f 75 73 20 | | ous |
|00006130| 63 61 6c 6c 20 74 6f 20 | 6f 70 65 6e 2e 20 20 49 |call to |open. I|
|00006140| 74 20 69 73 20 75 73 65 | 64 20 61 73 20 74 68 65 |t is use|d as the|
|00006150| 20 73 74 61 6e 64 61 72 | 64 20 20 7c 0d 20 20 20 | standar|d |. |
|00006160| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00006170| 20 69 6e 70 75 74 20 20 | 66 6f 72 20 74 68 65 20 | input |for the |
|00006180| 66 69 72 73 74 20 63 6f | 6d 6d 61 6e 64 20 69 6e |first co|mmand in|
|00006190| 20 74 68 65 20 70 69 70 | 65 6c 69 6e 65 2e 20 20 | the pip|eline. |
|000061a0| 7c 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||. | |
|000061b0| 20 20 20 20 20 20 46 69 | 6c 65 49 64 20 6d 75 73 | Fi|leId mus|
|000061c0| 74 20 68 61 76 65 20 62 | 65 65 6e 20 6f 70 65 6e |t have b|een open|
|000061d0| 65 64 20 66 6f 72 20 72 | 65 61 64 69 6e 67 2e 0d |ed for r|eading..|
|000061e0| 0d 20 20 20 20 20 3c 3c | 20 76 61 6c 75 65 20 20 |. <<| value |
|000061f0| 20 20 20 20 20 56 61 6c | 75 65 20 69 73 20 70 61 | Val|ue is pa|
|00006200| 73 73 65 64 20 74 6f 20 | 74 68 65 20 66 69 72 73 |ssed to |the firs|
|00006210| 74 20 63 6f 6d 6d 61 6e | 64 20 20 61 73 20 20 69 |t comman|d as i|
|00006220| 74 73 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |ts. | |
|00006230| 20 20 20 20 20 20 20 73 | 74 61 6e 64 61 72 64 20 | s|tandard |
|00006240| 69 6e 70 75 74 2e 0d 0d | 20 20 20 20 20 3e 20 66 |input...| > f|
|00006250| 69 6c 65 4e 61 6d 65 20 | 20 20 20 20 53 74 61 6e |ileName | Stan|
|00006260| 64 61 72 64 20 6f 75 74 | 70 75 74 20 20 66 72 6f |dard out|put fro|
|00006270| 6d 20 20 74 68 65 20 20 | 6c 61 73 74 20 20 63 6f |m the |last co|
|00006280| 6d 6d 61 6e 64 20 20 69 | 73 0d 20 20 20 20 20 20 |mmand i|s. |
|00006290| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 72 65 | | re|
|000062a0| 64 69 72 65 63 74 65 64 | 20 20 20 74 6f 20 20 20 |directed| to |
|000062b0| 74 68 65 20 20 66 69 6c | 65 20 20 6e 61 6d 65 64 |the fil|e named|
|000062c0| 20 20 66 69 6c 65 4e 61 | 6d 65 2c 0d 20 20 20 20 | fileNa|me,. |
|000062d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000062e0| 6f 76 65 72 77 72 69 74 | 69 6e 67 20 69 74 73 20 |overwrit|ing its |
|000062f0| 70 72 65 76 69 6f 75 73 | 20 63 6f 6e 74 65 6e 74 |previous| content|
|00006300| 73 2e 0d 0d 20 20 20 20 | 20 32 3e 20 66 69 6c 65 |s... | 2> file|
|00006310| 4e 61 6d 65 20 20 20 20 | 53 74 61 6e 64 61 72 64 |Name |Standard|
|00006320| 20 65 72 72 6f 72 20 66 | 72 6f 6d 20 61 6c 6c 20 | error f|rom all |
|00006330| 63 6f 6d 6d 61 6e 64 73 | 20 69 6e 20 74 68 65 20 |commands| in the |
|00006340| 70 69 70 65 2d 20 20 7c | 0d 20 20 20 20 20 20 20 |pipe- ||. |
|00006350| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 6c 69 6e | | lin|
|00006360| 65 20 20 20 69 73 20 20 | 20 72 65 64 69 72 65 63 |e is | redirec|
|00006370| 74 65 64 20 20 20 74 6f | 20 20 74 68 65 20 20 66 |ted to| the f|
|00006380| 69 6c 65 20 20 6e 61 6d | 65 64 20 20 7c 0d 20 20 |ile nam|ed |. |
|00006390| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000063a0| 20 20 66 69 6c 65 4e 61 | 6d 65 2c 20 6f 76 65 72 | fileNa|me, over|
|000063b0| 77 72 69 74 69 6e 67 20 | 69 74 73 20 70 72 65 76 |writing |its prev|
|000063c0| 69 6f 75 73 20 63 6f 6e | 74 65 6e 74 73 2e 20 20 |ious con|tents. |
|000063d0| 20 7c 0d 0d 20 20 20 20 | 20 3e 26 20 66 69 6c 65 | |.. | >& file|
|000063e0| 4e 61 6d 65 20 20 20 20 | 20 20 20 20 20 20 20 20 |Name | |
|000063f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
