Developer CD Series 1995 February: Tool Chest

home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1995 February: Tool Chest / Dev.CD Feb 95 / Dev.CD Feb 95.toast / Sample Code / Newton Sample Code 1.2 / Data Storage (Soups) / Q&A Data Storage < prev next >
MacBinary | 1994-07-12 | 82.9 KB | [ONLN/HLX2]
open in:
MacOS 8.1 extracted |
Win98 extracted |
DOS extracted
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
`100%`	file	MacBinary II, inited, Thu Jul 7 14:28:10 1994, modified Tue Jul 12 09:52:10 1994, creator 'HLX2', type 'ONLN', 79400 bytes "Q&A Data Storage" , at 0x136a8 5191 bytes resource	default (weak)
`99%`	file	data	default
`100%`	TrID	MacBinary 2	default (weak)
`100%`	siegfried	fmt/1762 MacBinary (II)	default
`100%`	lsar	MacBinary	default
id metadata
key	value
macFileType	`[ONLN]`
macFileCreator	`[HLX2]`
hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 10 51 26 41 20 44 61 | 74 61 20 53 74 6f 72 61 |..Q&A Da|ta Stora|
|00000010| 67 65 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |ge......|........|
|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 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 01 36 28 00 | 00 14 47 aa 41 f9 ba aa |.....6(.|..G.A...|
|00000060| 48 50 8a 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |HP......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 c1 37 00 00 |........|.....7..|
|00000080| 44 41 54 41 20 53 54 4f | 52 41 47 45 20 41 4e 44 |DATA STO|RAGE AND|
|00000090| 20 52 45 54 52 49 45 56 | 41 4c 0d a9 20 43 6f 70 | RETRIEV|AL.. Cop|
|000000a0| 79 72 69 67 68 74 20 31 | 39 39 33 2d 39 34 20 41 |yright 1|993-94 A|
|000000b0| 70 70 6c 65 20 43 6f 6d | 70 75 74 65 72 2c 20 49 |pple Com|puter, I|
|000000c0| 6e 63 2c 20 41 6c 6c 20 | 52 69 67 68 74 73 20 52 |nc, All |Rights R|
|000000d0| 65 73 65 72 76 65 64 0d | 5f 5f 5f 5f 5f 5f 5f 5f |eserved.|________|
|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 0d 09 0d | 49 6e 74 72 6f 64 75 63 |_____...|Introduc|
|00000110| 74 69 6f 6e 0d 54 68 69 | 73 20 64 6f 63 75 6d 65 |tion.Thi|s docume|
|00000120| 6e 74 20 61 64 64 72 65 | 73 73 65 73 20 4e 65 77 |nt addre|sses New|
|00000130| 74 6f 6e 20 44 61 74 61 | 20 53 74 6f 72 61 67 65 |ton Data| Storage|
|00000140| 20 61 6e 64 20 52 65 74 | 72 69 65 76 61 6c 20 69 | and Ret|rieval i|
|00000150| 73 73 75 65 73 20 74 68 | 61 74 20 61 72 65 20 6e |ssues th|at are n|
|00000160| 6f 74 20 61 76 61 69 6c | 61 62 6c 65 20 69 6e 20 |ot avail|able in |
|00000170| 74 68 65 20 63 75 72 72 | 65 6e 74 6c 79 20 70 72 |the curr|ently pr|
|00000180| 69 6e 74 65 64 20 64 6f | 63 75 6d 65 6e 74 61 74 |inted do|cumentat|
|00000190| 69 6f 6e 20 2e 20 50 6c | 65 61 73 65 20 6e 6f 74 |ion . Pl|ease not|
|000001a0| 65 20 74 68 61 74 20 74 | 68 69 73 20 69 6e 66 6f |e that t|his info|
|000001b0| 72 6d 61 74 69 6f 6e 20 | 69 73 20 73 75 62 6a 65 |rmation |is subje|
|000001c0| 63 74 20 74 6f 20 63 68 | 61 6e 67 65 20 61 73 20 |ct to ch|ange as |
|000001d0| 74 68 65 20 4e 65 77 74 | 6f 6e 20 74 65 63 68 6e |the Newt|on techn|
|000001e0| 6f 6c 6f 67 79 20 61 6e | 64 20 64 65 76 65 6c 6f |ology an|d develo|
|000001f0| 70 6d 65 6e 74 20 65 6e | 76 69 72 6f 6e 6d 65 6e |pment en|vironmen|
|00000200| 74 20 65 76 6f 6c 76 65 | 2e 0d 54 41 42 4c 45 20 |t evolve|..TABLE |
|00000210| 4f 46 20 43 4f 4e 54 45 | 4e 54 53 3a 0d 44 61 74 |OF CONTE|NTS:.Dat|
|00000220| 61 20 53 74 6f 72 61 67 | 65 20 61 6e 64 20 52 65 |a Storag|e and Re|
|00000230| 74 72 69 65 76 61 6c 20 | 51 26 41 73 0d a5 20 55 |trieval |Q&As.. U|
|00000240| 73 69 6e 67 20 47 6f 74 | 6f 4b 65 79 20 28 39 2f |sing Got|oKey (9/|
|00000250| 31 35 2f 39 33 29 20 28 | 4f 62 73 6f 6c 65 74 65 |15/93) (|Obsolete|
|00000260| 64 20 62 79 20 31 2e 30 | 20 4e 65 77 74 6f 6e 20 |d by 1.0| Newton |
|00000270| 50 72 6f 67 72 61 6d 6d | 65 72 27 73 20 47 75 69 |Programm|er's Gui|
|00000280| 64 65 20 70 37 2d 35 31 | 29 0d a5 20 48 61 6e 64 |de p7-51|).. Hand|
|00000290| 2d 52 6f 6c 6c 69 6e 67 | 20 61 6e 20 45 6e 74 72 |-Rolling| an Entr|
|000002a0| 79 20 28 39 2f 31 35 2f | 39 33 29 20 28 4f 62 73 |y (9/15/|93) (Obs|
|000002b0| 6f 6c 65 74 65 64 20 62 | 79 20 31 2e 30 20 4e 65 |oleted b|y 1.0 Ne|
|000002c0| 77 74 6f 6e 20 50 72 6f | 67 72 61 6d 6d 65 72 27 |wton Pro|grammer'|
|000002d0| 73 20 47 75 69 64 65 20 | 70 37 2d 35 30 29 0d a5 |s Guide |p7-50)..|
|000002e0| 20 45 6e 74 72 79 43 68 | 61 6e 67 65 2c 20 45 6e | EntryCh|ange, En|
|000002f0| 74 72 79 55 6e 64 6f 43 | 68 61 6e 67 65 73 2c 20 |tryUndoC|hanges, |
|00000300| 61 6e 64 20 41 75 74 6f | 73 61 76 69 6e 67 20 28 |and Auto|saving (|
|00000310| 39 2f 31 35 2f 39 33 29 | 28 4f 62 73 6f 6c 65 74 |9/15/93)|(Obsolet|
|00000320| 65 64 20 62 79 20 31 2e | 30 20 4e 65 77 74 6f 6e |ed by 1.|0 Newton|
|00000330| 20 50 72 6f 67 72 61 6d | 6d 65 72 27 73 20 47 75 | Program|mer's Gu|
|00000340| 69 64 65 20 70 37 2d 35 | 39 29 0d a5 20 43 75 72 |ide p7-5|9).. Cur|
|00000350| 73 6f 72 73 20 61 72 65 | 20 66 75 6c 6c 79 20 64 |sors are| fully d|
|00000360| 79 6e 61 6d 69 63 21 20 | 28 39 2f 31 35 2f 39 33 |ynamic! |(9/15/93|
|00000370| 29 20 28 4f 62 73 6f 6c | 65 74 65 64 20 62 79 20 |) (Obsol|eted by |
|00000380| 31 2e 30 20 4e 65 77 74 | 6f 6e 20 50 72 6f 67 72 |1.0 Newt|on Progr|
|00000390| 61 6d 6d 65 72 27 73 20 | 47 75 69 64 65 20 70 37 |ammer's |Guide p7|
|000003a0| 2d 33 35 29 0d a5 20 52 | 65 6d 6f 76 65 41 6c 6c |-35).. R|emoveAll|
|000003b0| 45 6e 74 72 69 65 73 20 | 50 72 6f 62 6c 65 6d 73 |Entries |Problems|
|000003c0| 20 28 39 2f 31 35 2f 39 | 33 29 20 28 4f 62 73 6f | (9/15/9|3) (Obso|
|000003d0| 6c 65 74 65 64 20 62 79 | 20 31 2e 30 20 4e 65 77 |leted by| 1.0 New|
|000003e0| 74 6f 6e 20 50 72 6f 67 | 72 61 6d 6d 65 72 27 73 |ton Prog|rammer's|
|000003f0| 20 47 75 69 64 65 20 70 | 37 2d 34 34 29 0d a5 20 | Guide p|7-44).. |
|00000400| 57 68 65 6e 20 74 6f 20 | 52 65 6d 6f 76 65 20 55 |When to |Remove U|
|00000410| 6e 75 73 65 64 20 53 6f | 75 70 73 3f 20 28 39 2f |nused So|ups? (9/|
|00000420| 31 35 2f 39 33 29 20 28 | 4f 62 73 6f 6c 65 74 65 |15/93) (|Obsolete|
|00000430| 64 20 62 79 20 31 2e 30 | 20 4e 65 77 74 6f 6e 20 |d by 1.0| Newton |
|00000440| 50 72 6f 67 72 61 6d 6d | 65 72 27 73 20 47 75 69 |Programm|er's Gui|
|00000450| 64 65 20 70 37 2d 33 31 | 29 0d a5 20 43 72 65 61 |de p7-31|).. Crea|
|00000460| 74 69 6e 67 20 53 6f 75 | 70 73 20 50 72 6f 70 65 |ting Sou|ps Prope|
|00000470| 72 6c 79 20 28 31 30 2f | 35 2f 39 33 29 20 28 6f |rly (10/|5/93) (o|
|00000480| 62 73 6f 6c 65 74 65 64 | 20 62 79 20 31 2e 30 20 |bsoleted| by 1.0 |
|00000490| 4e 65 77 74 6f 6e 20 50 | 72 6f 67 72 61 6d 6d 65 |Newton P|rogramme|
|000004a0| 72 27 73 20 47 75 69 64 | 65 20 70 37 2d 32 34 29 |r's Guid|e p7-24)|
|000004b0| 0d a5 20 43 6f 75 6e 74 | 20 53 6f 75 70 20 45 6e |.. Count| Soup En|
|000004c0| 74 72 69 65 73 2c 20 48 | 6f 77 3f 20 28 31 30 2f |tries, H|ow? (10/|
|000004d0| 31 34 2f 39 33 29 20 28 | 4f 62 73 6f 6c 65 74 65 |14/93) (|Obsolete|
|000004e0| 64 20 62 79 20 31 2e 30 | 20 4e 65 77 74 6f 6e 20 |d by 1.0| Newton |
|000004f0| 50 72 6f 67 72 61 6d 6d | 65 72 27 73 20 47 75 69 |Programm|er's Gui|
|00000500| 64 65 20 70 37 2d 34 38 | 29 0d a5 20 47 65 74 74 |de p7-48|).. Gett|
|00000510| 69 6e 67 2f 53 65 74 74 | 69 6e 67 20 74 68 65 20 |ing/Sett|ing the |
|00000520| 44 65 66 61 75 6c 74 20 | 53 74 6f 72 65 20 28 31 |Default |Store (1|
|00000530| 31 2f 31 30 2f 39 33 29 | 20 28 6f 62 73 6f 6c 65 |1/10/93)| (obsole|
|00000540| 74 65 64 20 62 79 20 31 | 2e 30 20 4e 65 77 74 6f |ted by 1|.0 Newto|
|00000550| 6e 20 50 72 6f 67 72 61 | 6d 6d 65 72 27 73 20 47 |n Progra|mmer's G|
|00000560| 75 69 64 65 20 70 37 2d | 36 35 29 0d a5 20 4e 75 |uide p7-|65).. Nu|
|00000570| 6c 6c 20 55 6e 69 6f 6e | 2d 53 6f 75 70 73 3f 20 |ll Union|-Soups? |
|00000580| 28 31 31 2f 31 30 2f 39 | 33 29 20 28 4f 62 73 6f |(11/10/9|3) (Obso|
|00000590| 6c 65 74 65 64 20 62 79 | 20 31 2e 30 20 4e 65 77 |leted by| 1.0 New|
|000005a0| 74 6f 6e 20 50 72 6f 67 | 72 61 6d 6d 65 72 27 73 |ton Prog|rammer's|
|000005b0| 20 47 75 69 64 65 20 70 | 37 2d 36 36 29 0d a5 20 | Guide p|7-66).. |
|000005c0| 55 6e 69 6f 6e 53 6f 75 | 70 20 44 61 6e 67 65 72 |UnionSou|p Danger|
|000005d0| 73 20 28 31 31 2f 31 30 | 2f 39 33 29 0d a5 20 55 |s (11/10|/93).. U|
|000005e0| 6e 69 71 75 65 49 44 73 | 20 28 31 31 2f 31 30 2f |niqueIDs| (11/10/|
|000005f0| 39 33 29 0d a5 20 53 6f | 75 70 20 52 65 6d 6f 76 |93).. So|up Remov|
|00000600| 61 6c 20 50 72 6f 62 6c | 65 6d 73 2c 20 49 6e 64 |al Probl|ems, Ind|
|00000610| 65 78 69 6e 67 2c 20 45 | 72 72 6f 72 20 2d 34 38 |exing, E|rror -48|
|00000620| 30 32 32 20 28 31 31 2f | 31 30 2f 39 33 29 20 28 |022 (11/|10/93) (|
|00000630| 4f 62 73 6f 6c 65 74 65 | 64 20 62 79 20 31 2e 30 |Obsolete|d by 1.0|
|00000640| 20 4e 65 77 74 6f 6e 20 | 50 72 6f 67 72 61 6d 6d | Newton |Programm|
|00000650| 65 72 27 73 20 47 75 69 | 64 65 20 70 37 2d 33 32 |er's Gui|de p7-32|
|00000660| 29 0d a5 20 53 6f 75 70 | 20 53 69 7a 65 73 20 2d |).. Soup| Sizes -|
|00000670| 20 47 65 6e 65 72 61 74 | 65 20 54 65 73 74 20 53 | Generat|e Test S|
|00000680| 6f 75 70 20 28 31 31 2f | 33 30 2f 39 33 29 20 28 |oup (11/|30/93) (|
|00000690| 4f 62 73 6f 6c 65 74 65 | 64 20 62 79 20 31 2e 30 |Obsolete|d by 1.0|
|000006a0| 20 4e 65 77 74 6f 6e 20 | 50 72 6f 67 72 61 6d 6d | Newton |Programm|
|000006b0| 65 72 27 73 20 47 75 69 | 64 65 20 70 37 2d 33 32 |er's Gui|de p7-32|
|000006c0| 29 0d a5 20 42 65 20 43 | 61 72 65 66 75 6c 20 57 |).. Be C|areful W|
|000006d0| 68 61 74 20 79 6f 75 20 | 53 74 6f 72 65 20 69 6e |hat you |Store in|
|000006e0| 20 53 6f 75 70 20 28 31 | 32 2f 36 2f 39 33 29 20 | Soup (1|2/6/93) |
|000006f0| 28 4f 62 73 6f 6c 65 74 | 65 64 20 62 79 20 31 2e |(Obsolet|ed by 1.|
|00000700| 30 20 4e 65 77 74 6f 6e | 20 50 72 6f 67 72 61 6d |0 Newton| Program|
|00000710| 6d 65 72 27 73 20 47 75 | 69 64 65 20 70 37 2d 32 |mer's Gu|ide p7-2|
|00000720| 33 29 0d a5 20 49 66 20 | 45 6e 74 72 79 43 68 61 |3).. If |EntryCha|
|00000730| 6e 67 65 20 66 61 69 6c | 73 2c 20 77 68 61 74 20 |nge fail|s, what |
|00000740| 68 61 70 70 65 6e 73 3f | 20 28 31 32 2f 39 2f 39 |happens?| (12/9/9|
|00000750| 33 29 0d a5 20 50 65 72 | 66 6f 72 6d 61 6e 63 65 |3).. Per|formance|
|00000760| 3a 20 43 75 72 73 6f 72 | 73 20 61 6e 64 20 45 6e |: Cursor|s and En|
|00000770| 74 72 79 52 65 6d 6f 76 | 65 46 72 6f 6d 53 6f 75 |tryRemov|eFromSou|
|00000780| 70 73 20 28 31 32 2f 31 | 31 2f 39 33 29 0d a5 20 |ps (12/1|1/93).. |
|00000790| 41 6c 77 61 79 73 20 75 | 73 65 20 43 6f 6e 73 74 |Always u|se Const|
|000007a0| 61 6e 74 73 20 69 6e 73 | 74 65 61 64 20 6f 66 20 |ants ins|tead of |
|000007b0| 53 74 72 69 6e 67 73 20 | 66 6f 72 20 42 75 69 6c |Strings |for Buil|
|000007c0| 74 20 69 6e 20 53 6f 75 | 70 73 20 28 31 32 2f 31 |t in Sou|ps (12/1|
|000007d0| 32 2f 39 33 29 20 28 4f | 62 73 6f 6c 65 74 65 64 |2/93) (O|bsoleted|
|000007e0| 20 62 79 20 31 2e 30 20 | 4e 65 77 74 6f 6e 20 50 | by 1.0 |Newton P|
|000007f0| 72 6f 67 72 61 6d 6d 65 | 72 27 73 20 47 75 69 64 |rogramme|r's Guid|
|00000800| 65 20 70 37 2d 32 33 29 | 0d a5 20 44 6f 20 4e 6f |e p7-23)|.. Do No|
|00000810| 74 20 43 6c 6f 6e 65 20 | 43 75 72 73 6f 72 73 20 |t Clone |Cursors |
|00000820| 77 69 74 68 20 43 6c 6f | 6e 65 2f 54 6f 74 61 6c |with Clo|ne/Total|
|00000830| 43 6c 6f 6e 65 2f 44 65 | 65 70 43 6c 6f 6e 65 20 |Clone/De|epClone |
|00000840| 28 31 32 2f 31 39 2f 39 | 33 29 20 20 28 4f 62 73 |(12/19/9|3)  (Obs|
|00000850| 6f 6c 65 74 65 64 20 62 | 79 20 31 2e 30 20 4e 65 |oleted b|y 1.0 Ne|
|00000860| 77 74 6f 6e 20 50 72 6f | 67 72 61 6d 6d 65 72 27 |wton Pro|grammer'|
|00000870| 73 20 47 75 69 64 65 20 | 70 37 2d 35 30 29 0d a5 |s Guide |p7-50)..|
|00000880| 20 57 68 61 74 20 53 74 | 6f 72 65 20 69 73 20 52 | What St|ore is R|
|00000890| 65 6d 6f 76 65 64 3f 20 | 28 31 32 2f 31 39 2f 39 |emoved? |(12/19/9|
|000008a0| 33 29 0d a5 20 53 74 6f | 72 65 3a 20 47 65 74 49 |3).. Sto|re: GetI|
|000008b0| 6e 66 6f 2c 20 53 65 74 | 49 6e 66 6f 2c 20 47 65 |nfo, Set|Info, Ge|
|000008c0| 74 41 6c 6c 49 6e 66 6f | 20 46 75 6e 63 74 69 6f |tAllInfo| Functio|
|000008d0| 6e 73 20 28 31 32 2f 31 | 39 2f 39 33 29 20 28 4f |ns (12/1|9/93) (O|
|000008e0| 62 73 6f 6c 65 74 65 64 | 20 62 79 20 31 2e 30 20 |bsoleted| by 1.0 |
|000008f0| 4e 65 77 74 6f 6e 20 50 | 72 6f 67 72 61 6d 6d 65 |Newton P|rogramme|
|00000900| 72 27 73 20 47 75 69 64 | 65 20 70 37 2d 31 32 29 |r's Guid|e p7-12)|
|00000910| 0d a5 20 53 74 6f 72 65 | 3a 53 65 74 49 6e 66 6f |.. Store|:SetInfo|
|00000920| 20 20 61 6e 64 20 53 6f | 75 70 3a 53 65 74 49 6e |  and So|up:SetIn|
|00000930| 66 6f 20 28 33 2f 39 2f | 39 34 29 0d a5 20 4d 61 |fo (3/9/|94).. Ma|
|00000940| 67 69 63 20 50 6f 69 6e | 74 65 72 73 20 69 6e 20 |gic Poin|ters in |
|00000950| 53 6f 75 70 73 20 28 33 | 2f 31 30 2f 39 34 29 0d |Soups (3|/10/94).|
|00000960| a5 20 41 70 70 6c 69 63 | 61 74 69 6f 6e 20 50 72 |. Applic|ation Pr|
|00000970| 65 66 65 72 65 6e 63 65 | 73 20 61 6e 64 20 74 68 |eference|s and th|
|00000980| 65 20 69 6e 74 65 72 6e | 61 6c 20 73 74 6f 72 65 |e intern|al store|
|00000990| 20 28 31 2f 32 36 2f 39 | 34 29 20 28 4f 62 73 6f | (1/26/9|4) (Obso|
|000009a0| 6c 65 74 65 64 20 62 79 | 20 31 2e 30 20 4e 65 77 |leted by| 1.0 New|
|000009b0| 74 6f 6e 20 50 72 6f 67 | 72 61 6d 6d 65 72 27 73 |ton Prog|rammer's|
|000009c0| 20 47 75 69 64 65 20 70 | 37 2d 33 33 29 0d a5 20 | Guide p|7-33).. |
|000009d0| 4e 45 57 3a 20 43 6f 72 | 72 65 63 74 20 73 70 65 |NEW: Cor|rect spe|
|000009e0| 6c 6c 69 6e 67 20 6f 66 | 20 5f 75 6e 69 71 75 65 |lling of| _unique|
|000009f0| 49 44 20 73 6c 6f 74 20 | 28 35 2f 33 31 2f 39 34 |ID slot |(5/31/94|
|00000a00| 29 0d a5 20 43 48 41 4e | 47 45 44 3a 20 4e 69 6c |).. CHAN|GED: Nil|
|00000a10| 20 49 6e 64 65 78 20 53 | 6c 6f 74 2c 20 41 64 64 | Index S|lot, Add|
|00000a20| 69 6e 67 20 45 6e 74 72 | 69 65 73 20 28 36 2f 37 |ing Entr|ies (6/7|
|00000a30| 2f 39 34 29 0d a5 20 43 | 48 41 4e 47 45 44 3a 20 |/94).. C|HANGED: |
|00000a40| 49 6e 64 65 78 65 73 20 | 69 6e 20 64 65 63 72 65 |Indexes |in decre|
|00000a50| 61 73 69 6e 67 20 6f 72 | 64 65 72 3f 20 28 36 2f |asing or|der? (6/|
|00000a60| 37 2f 39 34 29 0d a5 20 | 4e 45 57 3a 20 73 74 61 |7/94).. |NEW: sta|
|00000a70| 72 74 4b 65 79 20 61 6e | 64 20 65 6e 64 54 65 73 |rtKey an|d endTes|
|00000a80| 74 20 61 6e 64 20 63 75 | 72 73 6f 72 20 6c 69 6d |t and cu|rsor lim|
|00000a90| 69 74 73 20 28 36 2f 39 | 2f 39 34 29 0d a5 20 4e |its (6/9|/94).. N|
|00000aa0| 45 57 3a 20 43 61 72 64 | 20 27 61 70 70 6c 65 74 |EW: Card| 'applet|
|00000ab0| 27 20 6d 65 6d 6f 72 79 | 20 73 69 7a 65 20 76 61 |' memory| size va|
|00000ac0| 72 69 65 73 20 28 36 2f | 39 2f 39 34 29 0d a5 20 |ries (6/|9/94).. |
|00000ad0| 4e 45 57 3a 20 49 6e 74 | 65 72 72 61 63 74 69 6f |NEW: Int|erractio|
|00000ae0| 6e 20 6f 66 20 45 6e 74 | 72 79 43 68 61 6e 67 65 |n of Ent|ryChange|
|00000af0| 20 61 6e 64 20 4d 61 70 | 43 75 72 73 6f 72 20 28 | and Map|Cursor (|
|00000b00| 36 2f 39 2f 39 34 29 0d | a5 20 4e 45 57 3a 20 55 |6/9/94).|. NEW: U|
|00000b10| 73 65 20 47 43 28 29 20 | 77 69 74 68 20 52 65 6d |se GC() |with Rem|
|00000b20| 6f 76 65 49 6e 64 65 78 | 20 28 36 2f 31 30 2f 39 |oveIndex| (6/10/9|
|00000b30| 34 29 0d a5 20 4e 45 57 | 3a 20 42 65 77 61 72 65 |4).. NEW|: Beware|
|00000b40| 20 6f 66 20 49 6e 64 65 | 78 65 73 20 69 6e 45 78 | of Inde|xes inEx|
|00000b50| 74 65 72 6e 61 6c 20 53 | 6f 75 70 73 20 69 6e 20 |ternal S|oups in |
|00000b60| 43 6f 6d 62 69 6e 61 74 | 69 6f 6e 20 77 69 74 68 |Combinat|ion with|
|00000b70| 20 52 65 6d 6f 76 65 49 | 6e 64 65 78 20 61 6e 64 | RemoveI|ndex and|
|00000b80| 20 0d 41 64 64 49 6e 64 | 65 78 20 28 36 2f 31 30 | .AddInd|ex (6/10|
|00000b90| 2f 39 34 29 0d a5 20 4e | 45 57 3a 20 41 64 64 54 |/94).. N|EW: AddT|
|00000ba0| 6f 44 65 66 61 75 6c 74 | 53 74 6f 72 65 20 63 61 |oDefault|Store ca|
|00000bb0| 74 63 68 65 73 20 65 78 | 63 65 70 74 69 6f 6e 73 |tches ex|ceptions|
|00000bc0| 20 28 37 2f 35 2f 39 34 | 29 0d 5f 5f 5f 5f 5f 5f | (7/5/94|).______|
|00000bd0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000be0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000bf0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000c00| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000c10| 5f 5f 5f 5f 5f 5f 5f 09 | 0d 44 61 74 61 20 53 74 |_______.|.Data St|
|00000c20| 6f 72 61 67 65 20 61 6e | 64 20 52 65 74 72 69 65 |orage an|d Retrie|
|00000c30| 76 61 6c 20 51 26 41 73 | 0d 09 5f 5f 5f 5f 5f 5f |val Q&As|..______|
|00000c40| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000c50| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000c60| 5f 5f 5f 5f 5f 0d 55 73 | 69 6e 67 20 47 6f 74 6f |_____.Us|ing Goto|
|00000c70| 4b 65 79 20 28 39 2f 31 | 35 2f 39 33 29 20 28 4f |Key (9/1|5/93) (O|
|00000c80| 62 73 6f 6c 65 74 65 64 | 20 62 79 20 31 2e 30 20 |bsoleted| by 1.0 |
|00000c90| 4e 65 77 74 6f 6e 20 50 | 72 6f 67 72 61 6d 6d 65 |Newton P|rogramme|
|00000ca0| 72 27 73 20 47 75 69 64 | 65 20 70 37 2d 35 31 29 |r's Guid|e p7-51)|
|00000cb0| 0d 51 3a 20 48 6f 77 20 | 64 6f 65 73 20 63 75 72 |.Q: How |does cur|
|00000cc0| 73 6f 72 3a 47 6f 74 6f | 4b 65 79 28 6b 65 79 29 |sor:Goto|Key(key)|
|00000cd0| 20 77 6f 72 6b 3f 0d 41 | 3a 20 54 68 69 73 20 6f | work?.A|: This o|
|00000ce0| 6e 6c 79 20 77 6f 72 6b | 73 20 77 69 74 68 20 63 |nly work|s with c|
|00000cf0| 75 72 73 6f 72 73 20 67 | 65 6e 65 72 61 74 65 64 |ursors g|enerated|
|00000d00| 20 77 69 74 68 20 61 20 | 71 75 65 72 79 20 6f 66 | with a |query of|
|00000d10| 20 74 79 70 65 20 69 6e | 64 65 78 2c 20 61 6e 64 | type in|dex, and|
|00000d20| 20 79 6f 75 20 63 61 6e | 20 6f 6e 6c 79 20 73 75 | you can| only su|
|00000d30| 70 70 6c 79 20 61 20 6b | 65 79 20 66 72 6f 6d 20 |pply a k|ey from |
|00000d40| 74 68 65 20 73 6c 6f 74 | 20 61 67 61 69 6e 73 74 |the slot| against|
|00000d50| 20 77 68 69 63 68 20 74 | 68 65 20 63 75 72 73 6f | which t|he curso|
|00000d60| 72 20 77 61 73 20 67 65 | 6e 65 72 61 74 65 64 2e |r was ge|nerated.|
|00000d70| 20 20 46 6f 72 20 65 78 | 61 6d 70 6c 65 2c 20 69 |  For ex|ample, i|
|00000d80| 66 20 79 6f 75 20 67 65 | 6e 65 72 61 74 65 20 61 |f you ge|nerate a|
|00000d90| 20 63 75 72 73 6f 72 20 | 62 61 73 65 64 20 6f 6e | cursor |based on|
|00000da0| 20 61 6e 20 69 6e 64 65 | 78 20 69 6e 20 61 20 73 | an inde|x in a s|
|00000db0| 6c 6f 74 20 63 61 6c 6c | 65 64 20 6e 61 6d 65 2c |lot call|ed name,|
|00000dc0| 20 61 6e 64 20 73 75 70 | 70 6c 79 20 61 20 6b 65 | and sup|ply a ke|
|00000dd0| 79 20 74 68 61 74 20 69 | 73 20 61 20 6e 75 6d 62 |y that i|s a numb|
|00000de0| 65 72 20 69 6e 20 74 68 | 65 20 73 6c 6f 74 20 63 |er in th|e slot c|
|00000df0| 61 6c 6c 65 64 20 65 78 | 74 65 6e 73 69 6f 6e 2c |alled ex|tension,|
|00000e00| 20 74 68 65 20 47 6f 74 | 6f 4b 65 79 20 66 75 6e | the Got|oKey fun|
|00000e10| 63 74 69 6f 6e 20 77 69 | 6c 6c 20 6e 6f 74 20 77 |ction wi|ll not w|
|00000e20| 6f 72 6b 20 77 69 74 68 | 20 74 68 61 74 20 6b 65 |ork with| that ke|
|00000e30| 79 2c 20 61 6e 64 20 61 | 6e 20 65 78 63 65 70 74 |y, and a|n except|
|00000e40| 69 6f 6e 20 77 69 6c 6c | 20 62 65 20 74 68 72 6f |ion will| be thro|
|00000e50| 77 6e 2c 20 62 65 63 61 | 75 73 65 20 74 68 65 20 |wn, beca|use the |
|00000e60| 63 75 72 73 6f 72 20 69 | 73 20 6f 6e 20 61 20 73 |cursor i|s on a s|
|00000e70| 74 72 69 6e 67 20 6b 65 | 79 20 61 6e 64 20 61 20 |tring ke|y and a |
|00000e80| 6e 75 6d 62 65 72 20 77 | 61 73 20 70 72 6f 76 69 |number w|as provi|
|00000e90| 64 65 64 2e 0d 09 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ded...__|________|
|00000ea0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000eb0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000ec0| 5f 0d 48 61 6e 64 2d 52 | 6f 6c 6c 69 6e 67 20 61 |_.Hand-R|olling a|
|00000ed0| 6e 20 45 6e 74 72 79 20 | 28 39 2f 31 35 2f 39 33 |n Entry |(9/15/93|
|00000ee0| 29 20 28 4f 62 73 6f 6c | 65 74 65 64 20 62 79 20 |) (Obsol|eted by |
|00000ef0| 31 2e 30 20 4e 65 77 74 | 6f 6e 20 50 72 6f 67 72 |1.0 Newt|on Progr|
|00000f00| 61 6d 6d 65 72 27 73 20 | 47 75 69 64 65 20 70 37 |ammer's |Guide p7|
|00000f10| 2d 35 30 29 0d 51 3a 09 | 49 73 20 74 68 65 72 65 |-50).Q:.|Is there|
|00000f20| 20 61 20 77 61 79 20 74 | 6f 20 75 73 20 61 20 6e | a way t|o us a n|
|00000f30| 6f 6e 2d 65 6e 74 72 79 | 20 66 72 61 6d 65 20 61 |on-entry| frame a|
|00000f40| 73 20 74 68 65 20 70 61 | 72 61 6d 61 74 65 72 20 |s the pa|ramater |
|00000f50| 66 6f 72 20 63 75 72 73 | 6f 72 3a 47 6f 74 6f 28 |for curs|or:Goto(|
|00000f60| 65 6e 74 72 79 29 3f 0d | 41 3a 20 4e 6f 2c 20 74 |entry)?.|A: No, t|
|00000f70| 68 65 72 65 20 69 73 20 | 6e 6f 20 77 61 79 20 74 |here is |no way t|
|00000f80| 6f 20 22 68 61 6e 64 20 | 72 6f 6c 6c 22 20 61 6e |o "hand |roll" an|
|00000f90| 20 65 6e 74 72 79 20 62 | 79 20 63 72 65 61 74 69 | entry b|y creati|
|00000fa0| 6e 67 20 61 20 66 72 61 | 6d 65 20 77 69 74 68 20 |ng a fra|me with |
|00000fb0| 74 68 65 20 61 70 70 72 | 6f 70 72 69 61 74 65 20 |the appr|opriate |
|00000fc0| 61 74 74 72 69 62 75 74 | 65 73 2e 20 20 4f 6e 6c |attribut|es.  Onl|
|00000fd0| 79 20 65 6e 74 72 69 65 | 73 20 74 68 61 74 20 63 |y entrie|s that c|
|00000fe0| 6f 6d 65 20 66 72 6f 6d | 20 73 6f 75 70 73 20 61 |ome from| soups a|
|00000ff0| 72 65 20 76 61 6c 69 64 | 2e 20 20 46 6f 72 20 65 |re valid|.  For e|
|00001000| 78 61 6d 70 6c 65 2c 20 | 79 6f 75 20 63 6f 75 6c |xample, |you coul|
|00001010| 64 20 65 78 74 72 61 63 | 74 20 74 68 65 20 65 6e |d extrac|t the en|
|00001020| 74 72 79 20 66 72 6f 6d | 20 61 20 63 75 72 73 6f |try from| a curso|
|00001030| 72 20 62 79 20 20 61 73 | 73 69 67 6e 69 6e 67 20 |r by  as|signing |
|00001040| 61 20 76 61 72 69 61 62 | 6c 65 20 74 6f 20 74 68 |a variab|le to th|
|00001050| 65 20 72 65 73 75 6c 74 | 20 6f 66 20 63 75 72 73 |e result| of curs|
|00001060| 6f 72 3a 65 6e 74 72 79 | 20 61 6e 64 20 70 61 73 |or:entry| and pas|
|00001070| 73 69 6e 67 20 74 68 61 | 74 20 76 61 72 69 61 62 |sing tha|t variab|
|00001080| 6c 65 20 61 73 20 69 6e | 70 75 74 20 74 6f 20 63 |le as in|put to c|
|00001090| 75 72 73 6f 72 3a 47 6f | 74 6f 2e 0d 09 5f 5f 5f |ursor:Go|to...___|
|000010a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000010b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000010c0| 5f 5f 5f 5f 5f 5f 5f 5f | 0d 45 6e 74 72 79 43 68 |________|.EntryCh|
|000010d0| 61 6e 67 65 2c 20 45 6e | 74 72 79 55 6e 64 6f 43 |ange, En|tryUndoC|
|000010e0| 68 61 6e 67 65 73 2c 20 | 61 6e 64 20 41 75 74 6f |hanges, |and Auto|
|000010f0| 73 61 76 69 6e 67 20 28 | 39 2f 31 35 2f 39 33 29 |saving (|9/15/93)|
|00001100| 28 4f 62 73 6f 6c 65 74 | 65 64 20 62 79 20 31 2e |(Obsolet|ed by 1.|
|00001110| 30 20 4e 65 77 74 6f 6e | 20 50 72 6f 67 72 61 6d |0 Newton| Program|
|00001120| 6d 65 72 27 73 20 47 75 | 69 64 65 20 70 37 2d 35 |mer's Gu|ide p7-5|
|00001130| 39 29 0d 51 3a 20 20 45 | 6e 74 72 79 43 68 61 6e |9).Q:  E|ntryChan|
|00001140| 67 65 28 65 6e 74 72 79 | 29 20 61 6e 64 20 45 6e |ge(entry|) and En|
|00001150| 74 72 79 55 6e 64 6f 43 | 68 61 6e 67 65 73 28 65 |tryUndoC|hanges(e|
|00001160| 6e 74 72 79 29 20 61 72 | 65 20 61 74 20 70 72 65 |ntry) ar|e at pre|
|00001170| 73 65 6e 74 20 75 6e 63 | 6c 65 61 72 2e 20 20 44 |sent unc|lear.  D|
|00001180| 6f 65 73 20 74 68 65 20 | 6c 61 74 74 65 72 20 65 |oes the |latter e|
|00001190| 78 69 73 74 2f 77 6f 72 | 6b 20 6f 72 20 6e 6f 74 |xist/wor|k or not|
|000011a0| 3f 20 20 49 73 20 74 68 | 65 72 65 20 61 75 74 6f |?  Is th|ere auto|
|000011b0| 73 61 76 69 6e 67 20 61 | 73 20 69 6e 20 48 79 70 |saving a|s in Hyp|
|000011c0| 65 72 43 61 72 64 20 3f | 20 20 49 66 20 79 6f 75 |erCard ?|  If you|
|000011d0| 20 64 6f 6e 27 74 20 63 | 61 6c 6c 45 6e 74 72 79 | don't c|allEntry|
|000011e0| 43 68 61 6e 67 65 28 65 | 6e 74 72 79 29 2c 20 61 |Change(e|ntry), a|
|000011f0| 6e 64 20 73 6f 6d 65 74 | 68 69 6e 67 20 6d 61 6a |nd somet|hing maj|
|00001200| 6f 72 20 68 61 70 70 65 | 6e 73 2c 20 61 72 65 20 |or happe|ns, are |
|00001210| 74 68 65 20 63 68 61 6e | 67 65 73 20 6c 6f 73 74 |the chan|ges lost|
|00001220| 3f 0d 41 3a 09 45 6e 74 | 72 79 55 6e 64 6f 43 68 |?.A:.Ent|ryUndoCh|
|00001230| 61 6e 67 65 73 20 65 78 | 69 73 74 73 20 61 6e 64 |anges ex|ists and|
|00001240| 20 77 6f 72 6b 73 20 61 | 73 20 64 6f 63 75 6d 65 | works a|s docume|
|00001250| 6e 74 65 64 2e 20 54 68 | 69 73 20 69 73 20 74 68 |nted. Th|is is th|
|00001260| 65 20 70 72 65 66 65 72 | 72 65 64 20 77 61 79 20 |e prefer|red way |
|00001270| 74 6f 20 70 65 72 66 6f | 72 6d 20 61 6e 20 75 6e |to perfo|rm an un|
|00001280| 64 6f 20 6f 70 65 72 61 | 74 69 6f 6e 20 6f 6e 20 |do opera|tion on |
|00001290| 73 6f 75 70 20 64 61 74 | 61 2e 0d 09 54 68 65 72 |soup dat|a...Ther|
|000012a0| 65 20 69 73 20 6e 6f 20 | 61 75 74 6f 73 61 76 69 |e is no |autosavi|
|000012b0| 6e 67 20 61 73 20 77 69 | 74 68 20 48 79 70 65 72 |ng as wi|th Hyper|
|000012c0| 63 61 72 64 2e 20 20 59 | 6f 75 20 61 72 65 20 72 |card.  Y|ou are r|
|000012d0| 65 73 70 6f 6e 73 69 62 | 6c 65 20 66 6f 72 20 75 |esponsib|le for u|
|000012e0| 70 64 61 74 69 6e 67 20 | 64 61 74 61 20 74 68 61 |pdating |data tha|
|000012f0| 74 20 68 61 73 20 62 65 | 65 6e 20 6d 6f 64 69 66 |t has be|en modif|
|00001300| 69 65 64 20 69 6e 20 73 | 6f 75 70 73 2e 0d 09 57 |ied in s|oups...W|
|00001310| 68 65 72 65 20 22 73 6f | 6d 65 74 68 69 6e 67 20 |here "so|mething |
|00001320| 6d 61 6a 6f 72 22 20 69 | 73 20 64 65 66 69 6e 65 |major" i|s define|
|00001330| 64 20 61 73 20 63 61 74 | 61 73 74 72 6f 70 68 69 |d as cat|astrophi|
|00001340| 63 20 70 6f 77 65 72 20 | 6c 6f 73 73 2c 20 70 72 |c power |loss, pr|
|00001350| 6f 67 72 61 6d 20 65 72 | 72 6f 72 2c 20 68 69 74 |ogram er|ror, hit|
|00001360| 74 69 6e 67 20 74 68 65 | 20 72 65 73 65 74 20 62 |ting the| reset b|
|00001370| 75 74 74 6f 6e 2c 20 61 | 6e 64 20 73 6f 20 6f 6e |utton, a|nd so on|
|00001380| 2c 20 20 64 61 74 61 20 | 74 68 61 74 20 77 61 73 |,  data |that was|
|00001390| 20 63 68 61 6e 67 65 64 | 20 69 6e 20 61 6e 20 65 | changed| in an e|
|000013a0| 6e 74 72 79 20 61 6e 64 | 20 6e 6f 74 20 70 61 73 |ntry and| not pas|
|000013b0| 73 65 64 20 74 6f 20 45 | 6e 74 72 79 43 68 61 6e |sed to E|ntryChan|
|000013c0| 67 65 20 77 69 6c 6c 20 | 62 65 20 6c 6f 73 74 2e |ge will |be lost.|
|000013d0| 0d 09 42 65 63 61 75 73 | 65 20 74 68 65 20 65 6e |..Becaus|e the en|
|000013e0| 74 72 79 20 69 73 20 63 | 61 63 68 65 64 20 61 6e |try is c|ached an|
|000013f0| 64 20 73 68 61 72 65 64 | 20 62 79 20 61 6c 6c 20 |d shared| by all |
|00001400| 63 75 72 73 6f 72 73 2c | 20 6f 74 68 65 72 20 70 |cursors,| other p|
|00001410| 61 72 74 73 20 6f 66 20 | 61 6e 20 61 70 70 6c 69 |arts of |an appli|
|00001420| 63 61 74 69 6f 6e 20 6d | 61 79 20 73 65 65 20 61 |cation m|ay see a|
|00001430| 20 22 63 68 61 6e 67 65 | 64 22 20 65 6e 74 72 79 | "change|d" entry|
|00001440| 20 65 76 65 6e 20 74 68 | 6f 75 67 68 20 45 6e 74 | even th|ough Ent|
|00001450| 72 79 43 68 61 6e 67 65 | 20 68 61 73 20 6e 6f 74 |ryChange| has not|
|00001460| 20 79 65 74 20 62 65 65 | 6e 20 63 61 6c 6c 65 64 | yet bee|n called|
|00001470| 2e 0d 09 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..._____|________|
|00001480| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001490| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 0d 43 |________|______.C|
|000014a0| 75 72 73 6f 72 73 20 61 | 72 65 20 66 75 6c 6c 79 |ursors a|re fully|
|000014b0| 20 64 79 6e 61 6d 69 63 | 21 20 28 39 2f 31 35 2f | dynamic|! (9/15/|
|000014c0| 39 33 29 20 28 4f 62 73 | 6f 6c 65 74 65 64 20 62 |93) (Obs|oleted b|
|000014d0| 79 20 31 2e 30 20 4e 65 | 77 74 6f 6e 20 50 72 6f |y 1.0 Ne|wton Pro|
|000014e0| 67 72 61 6d 6d 65 72 27 | 73 20 47 75 69 64 65 20 |grammer'|s Guide |
|000014f0| 70 37 2d 33 35 29 0d 51 | 3a 09 41 72 65 20 74 68 |p7-35).Q|:.Are th|
|00001500| 65 20 72 65 73 75 6c 74 | 73 20 6f 66 20 61 20 71 |e result|s of a q|
|00001510| 75 65 72 79 20 74 68 61 | 74 20 72 65 74 75 72 6e |uery tha|t return|
|00001520| 73 20 61 20 63 75 72 73 | 6f 72 20 64 79 6e 61 6d |s a curs|or dynam|
|00001530| 69 63 20 6f 72 20 73 74 | 61 74 69 63 3f 20 43 6f |ic or st|atic? Co|
|00001540| 6e 73 69 64 65 72 20 74 | 68 69 73 20 73 63 65 6e |nsider t|his scen|
|00001550| 61 72 69 6f 3a 20 49 20 | 68 61 76 65 20 61 20 63 |ario: I |have a c|
|00001560| 75 72 73 6f 72 20 74 68 | 61 74 20 70 6f 69 6e 74 |ursor th|at point|
|00001570| 73 20 74 6f 20 61 20 6c | 69 73 74 20 6f 66 20 65 |s to a l|ist of e|
|00001580| 6e 74 72 69 65 73 20 74 | 68 61 74 20 6d 65 65 74 |ntries t|hat meet|
|00001590| 20 74 68 65 20 63 72 69 | 74 65 72 69 61 20 73 70 | the cri|teria sp|
|000015a0| 65 63 69 66 69 65 64 20 | 69 6e 20 6d 79 20 71 75 |ecified |in my qu|
|000015b0| 65 72 79 2e 20 20 49 6e | 20 74 68 65 20 63 6f 75 |ery.  In| the cou|
|000015c0| 72 73 65 20 6f 66 20 6d | 79 20 77 6f 72 6b 2c 20 |rse of m|y work, |
|000015d0| 49 20 61 64 64 20 6d 6f | 72 65 20 65 6e 74 72 69 |I add mo|re entri|
|000015e0| 65 73 20 74 6f 20 74 68 | 65 20 73 6f 75 70 20 61 |es to th|e soup a|
|000015f0| 67 61 69 6e 73 74 20 77 | 68 69 63 68 20 49 20 6d |gainst w|hich I m|
|00001600| 61 64 65 20 74 68 65 20 | 6f 72 69 67 69 6e 61 6c |ade the |original|
|00001610| 20 71 75 65 72 79 2c 20 | 73 6f 6d 65 20 6f 66 20 | query, |some of |
|00001620| 77 68 69 63 68 20 6d 65 | 65 74 20 74 68 65 20 63 |which me|et the c|
|00001630| 72 69 74 65 72 69 61 20 | 6f 66 20 6d 79 20 6f 72 |riteria |of my or|
|00001640| 69 67 69 6e 61 6c 20 71 | 75 65 72 79 2e 20 20 49 |iginal q|uery.  I|
|00001650| 66 20 49 20 63 61 6c 6c | 20 63 75 72 73 6f 72 3a |f I call| cursor:|
|00001660| 6e 65 78 74 20 65 6e 6f | 75 67 68 20 74 69 6d 65 |next eno|ugh time|
|00001670| 73 20 77 69 6c 6c 20 49 | 20 65 76 65 6e 74 75 61 |s will I| eventua|
|00001680| 6c 6c 79 20 70 6f 69 6e | 74 20 74 6f 20 73 6f 6d |lly poin|t to som|
|00001690| 65 20 6f 66 20 6d 79 20 | 6e 65 77 20 65 6e 74 72 |e of my |new entr|
|000016a0| 69 65 73 3f 20 20 43 6f | 6e 76 65 72 73 65 6c 79 |ies?  Co|nversely|
|000016b0| 2c 20 69 66 20 49 20 6d | 6f 64 69 66 79 20 61 6e |, if I m|odify an|
|000016c0| 20 65 6e 74 72 79 20 69 | 6e 20 6d 79 20 63 75 72 | entry i|n my cur|
|000016d0| 73 6f 72 27 73 20 22 6c | 69 73 74 22 20 73 75 63 |sor's "l|ist" suc|
|000016e0| 68 20 74 68 61 74 20 69 | 74 20 6e 6f 20 6c 6f 6e |h that i|t no lon|
|000016f0| 67 65 72 20 6d 61 74 63 | 68 65 73 20 74 68 65 20 |ger matc|hes the |
|00001700| 71 75 65 72 79 20 63 72 | 69 74 65 72 69 61 2c 20 |query cr|iteria, |
|00001710| 77 69 6c 6c 20 74 68 65 | 20 63 75 72 73 6f 72 20 |will the| cursor |
|00001720| 6e 6f 20 6c 6f 6e 67 65 | 72 20 70 6f 69 6e 74 20 |no longe|r point |
|00001730| 74 6f 20 69 74 3f 0d 41 | 3a 20 20 54 68 65 20 72 |to it?.A|:  The r|
|00001740| 65 73 75 6c 74 20 70 6f | 69 6e 74 65 64 20 74 6f |esult po|inted to|
|00001750| 20 62 79 20 74 68 65 20 | 63 75 72 73 6f 72 20 69 | by the |cursor i|
|00001760| 73 20 63 6f 6d 70 6c 65 | 74 65 6c 79 20 64 79 6e |s comple|tely dyn|
|00001770| 61 6d 69 63 21 0d 09 20 | 49 66 20 79 6f 75 20 64 |amic!.. |If you d|
|00001780| 65 6c 65 74 65 20 65 6e | 74 72 69 65 73 20 77 68 |elete en|tries wh|
|00001790| 69 63 68 20 70 72 65 76 | 69 6f 75 73 6c 79 20 6d |ich prev|iously m|
|000017a0| 65 74 20 74 68 65 20 63 | 72 69 74 65 72 69 61 20 |et the c|riteria |
|000017b0| 69 6e 20 74 68 65 20 51 | 75 65 72 79 20 63 61 6c |in the Q|uery cal|
|000017c0| 6c 2c 20 74 68 65 20 63 | 75 72 73 6f 72 20 77 69 |l, the c|ursor wi|
|000017d0| 6c 6c 20 73 6b 69 70 20 | 6f 76 65 72 20 74 68 65 |ll skip |over the|
|000017e0| 6d 20 69 6e 20 74 68 65 | 20 63 6f 75 72 73 65 20 |m in the| course |
|000017f0| 6f 66 20 74 72 61 76 65 | 72 73 69 6e 67 20 74 68 |of trave|rsing th|
|00001800| 65 20 73 6f 75 70 20 65 | 6e 74 72 69 65 73 2e 20 |e soup e|ntries. |
|00001810| 20 49 6e 20 6f 74 68 65 | 72 20 77 6f 72 64 73 2c | In othe|r words,|
|00001820| 20 69 74 20 6e 65 76 65 | 72 20 70 6f 69 6e 74 73 | it neve|r points|
|00001830| 20 74 6f 20 65 6e 74 72 | 69 65 73 20 74 68 61 74 | to entr|ies that|
|00001840| 20 64 6f 6e 27 74 20 6d | 65 65 74 20 74 68 65 20 | don't m|eet the |
|00001850| 63 72 69 74 65 72 69 61 | 20 6f 66 20 74 68 65 20 |criteria| of the |
|00001860| 6f 72 69 67 69 6e 61 6c | 20 71 75 65 72 79 2e 0d |original| query..|
|00001870| 09 53 69 6d 69 6c 61 72 | 6c 79 2c 20 69 66 20 79 |.Similar|ly, if y|
|00001880| 6f 75 20 73 75 62 73 65 | 71 75 65 6e 74 6c 79 20 |ou subse|quently |
|00001890| 20 61 64 64 20 74 6f 20 | 74 68 65 20 73 6f 75 70 | add to |the soup|
|000018a0| 20 65 6e 74 72 69 65 73 | 20 6d 65 65 74 69 6e 67 | entries| meeting|
|000018b0| 20 74 68 65 20 63 72 69 | 74 65 72 69 61 20 6f 66 | the cri|teria of|
|000018c0| 20 74 68 65 20 6f 72 69 | 67 69 6e 61 6c 20 51 75 | the ori|ginal Qu|
|000018d0| 65 72 79 2c 20 74 68 65 | 20 63 75 72 73 6f 72 20 |ery, the| cursor |
|000018e0| 77 69 6c 6c 20 70 6f 69 | 6e 74 20 74 6f 20 74 68 |will poi|nt to th|
|000018f0| 65 6d 20 61 73 20 69 74 | 20 74 72 61 76 65 72 73 |em as it| travers|
|00001900| 65 73 20 74 68 65 20 65 | 6e 74 72 69 65 73 20 69 |es the e|ntries i|
|00001910| 6e 20 74 68 65 20 73 6f | 75 70 2e 0d 09 41 73 20 |n the so|up...As |
|00001920| 61 20 70 65 72 69 70 68 | 65 72 61 6c 20 6e 6f 74 |a periph|eral not|
|00001930| 65 2c 20 69 66 20 79 6f | 75 20 64 65 6c 65 74 65 |e, if yo|u delete|
|00001940| 20 61 6e 20 65 6e 74 72 | 79 20 77 68 69 6c 65 20 | an entr|y while |
|00001950| 74 68 65 20 63 75 72 73 | 6f 72 20 69 73 20 70 6f |the curs|or is po|
|00001960| 69 6e 74 69 6e 67 20 74 | 6f 20 69 74 2c 20 74 68 |inting t|o it, th|
|00001970| 65 6e 20 63 75 72 73 6f | 72 3a 45 6e 74 72 79 20 |en curso|r:Entry |
|00001980| 77 69 6c 6c 20 72 65 74 | 75 72 6e 20 74 68 65 20 |will ret|urn the |
|00001990| 73 79 6d 62 6f 6c 20 27 | 64 65 6c 65 74 65 64 2e |symbol '|deleted.|
|000019a0| 0d 09 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..______|________|
|000019b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000019c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 0d 52 65 |________|_____.Re|
|000019d0| 6d 6f 76 65 41 6c 6c 45 | 6e 74 72 69 65 73 20 50 |moveAllE|ntries P|
|000019e0| 72 6f 62 6c 65 6d 73 20 | 28 39 2f 31 35 2f 39 33 |roblems |(9/15/93|
|000019f0| 29 20 28 4f 62 73 6f 6c | 65 74 65 64 20 62 79 20 |) (Obsol|eted by |
|00001a00| 31 2e 30 20 4e 65 77 74 | 6f 6e 20 50 72 6f 67 72 |1.0 Newt|on Progr|
|00001a10| 61 6d 6d 65 72 27 73 20 | 47 75 69 64 65 20 70 37 |ammer's |Guide p7|
|00001a20| 2d 34 34 29 0d 51 3a 20 | 52 65 6d 6f 76 65 41 6c |-44).Q: |RemoveAl|
|00001a30| 6c 45 6e 74 72 69 65 73 | 20 64 6f 65 73 6e 27 74 |lEntries| doesn't|
|00001a40| 20 73 65 65 6d 20 74 6f | 20 65 78 69 73 74 2c 20 | seem to| exist, |
|00001a50| 61 74 20 6c 65 61 73 74 | 20 66 6f 72 20 75 6e 69 |at least| for uni|
|00001a60| 6f 6e 20 73 6f 75 70 73 | d1 69 74 20 77 6f 72 6b |on soups|.it work|
|00001a70| 73 20 6f 6e 20 69 6e 64 | 65 70 65 6e 64 65 6e 74 |s on ind|ependent|
|00001a80| 20 73 6f 75 70 73 2e 20 | 57 68 61 74 27 73 20 74 | soups. |What's t|
|00001a90| 68 65 20 70 72 6f 62 6c | 65 6d 3f 0d 41 3a 20 4e |he probl|em?.A: N|
|00001aa0| 6f 20 70 72 6f 62 6c 65 | 6d 2e 20 20 52 65 6d 6f |o proble|m.  Remo|
|00001ab0| 76 65 41 6c 6c 45 6e 74 | 72 69 65 73 20 69 73 20 |veAllEnt|ries is |
|00001ac0| 6e 6f 74 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 20 |not impl|emented |
|00001ad0| 66 6f 72 20 75 6e 69 6f | 6e 20 73 6f 75 70 73 2c |for unio|n soups,|
|00001ae0| 20 6f 6e 6c 79 20 66 6f | 72 20 22 70 6c 61 69 6e | only fo|r "plain|
|00001af0| 22 20 73 6f 75 70 73 2e | 0d 09 5f 5f 5f 5f 5f 5f |" soups.|..______|
|00001b00| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001b10| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001b20| 5f 5f 5f 5f 5f 0d 57 68 | 65 6e 20 74 6f 20 52 65 |_____.Wh|en to Re|
|00001b30| 6d 6f 76 65 20 55 6e 75 | 73 65 64 20 53 6f 75 70 |move Unu|sed Soup|
|00001b40| 73 3f 20 28 39 2f 31 35 | 2f 39 33 29 20 28 4f 62 |s? (9/15|/93) (Ob|
|00001b50| 73 6f 6c 65 74 65 64 20 | 62 79 20 31 2e 30 20 4e |soleted |by 1.0 N|
|00001b60| 65 77 74 6f 6e 20 50 72 | 6f 67 72 61 6d 6d 65 72 |ewton Pr|ogrammer|
|00001b70| 27 73 20 47 75 69 64 65 | 20 70 37 2d 33 31 29 0d |'s Guide| p7-31).|
|00001b80| 51 3a 09 20 49 20 68 61 | 76 65 20 61 6e 20 61 70 |Q:. I ha|ve an ap|
|00001b90| 70 6c 69 63 61 74 69 6f | 6e 20 74 68 61 74 20 63 |plicatio|n that c|
|00001ba0| 72 65 61 74 65 73 20 61 | 6e 64 20 75 73 65 73 20 |reates a|nd uses |
|00001bb0| 61 20 72 61 74 68 65 72 | 20 73 70 65 63 69 61 6c |a rather| special|
|00001bc0| 69 7a 65 64 20 73 6f 75 | 70 2e 20 20 54 68 69 73 |ized sou|p.  This|
|00001bd0| 20 73 6f 75 70 20 77 69 | 6c 6c 20 62 65 20 6f 66 | soup wi|ll be of|
|00001be0| 20 6e 6f 20 75 73 65 20 | 74 6f 20 61 6e 79 20 6f | no use |to any o|
|00001bf0| 74 68 65 72 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |ther app|lication|
|00001c00| 73 2c 20 73 6f 20 77 68 | 65 6e 20 61 20 75 73 65 |s, so wh|en a use|
|00001c10| 72 20 64 65 63 69 64 65 | 73 20 74 6f 20 72 65 6d |r decide|s to rem|
|00001c20| 6f 76 65 20 6d 79 20 61 | 70 70 6c 69 63 61 74 69 |ove my a|pplicati|
|00001c30| 6f 6e 20 66 72 6f 6d 20 | 74 68 65 20 4e 65 77 74 |on from |the Newt|
|00001c40| 6f 6e 2c 20 6d 79 20 73 | 70 65 63 69 61 6c 69 7a |on, my s|pecializ|
|00001c50| 65 64 20 73 6f 75 70 20 | 73 68 6f 75 6c 64 20 67 |ed soup |should g|
|00001c60| 65 74 20 74 68 72 6f 77 | 6e 20 6f 75 74 20 74 6f |et throw|n out to|
|00001c70| 6f 2e 20 20 48 6f 77 20 | 64 6f 20 49 20 67 65 74 |o.  How |do I get|
|00001c80| 20 6d 79 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 | my appl|ication |
|00001c90| 74 6f 20 63 6c 65 61 6e | 20 75 70 20 61 66 74 65 |to clean| up afte|
|00001ca0| 72 20 69 74 73 65 6c 66 | 20 69 6e 20 74 68 69 73 |r itself| in this|
|00001cb0| 20 77 61 79 3f 20 20 49 | 73 20 74 68 65 72 65 20 | way?  I|s there |
|00001cc0| 61 20 6d 65 73 73 61 67 | 65 20 73 65 6e 74 20 74 |a messag|e sent t|
|00001cd0| 6f 20 74 68 65 20 61 70 | 70 6c 69 63 61 74 69 6f |o the ap|plicatio|
|00001ce0| 6e 20 77 68 65 6e 20 69 | 74 20 69 73 20 62 65 69 |n when i|t is bei|
|00001cf0| 6e 67 20 72 65 6d 6f 76 | 65 64 20 74 68 61 74 20 |ng remov|ed that |
|00001d00| 63 61 6e 20 62 65 20 63 | 61 75 67 68 74 20 61 6e |can be c|aught an|
|00001d10| 64 20 6d 61 64 65 20 74 | 6f 20 74 72 69 67 67 65 |d made t|o trigge|
|00001d20| 72 20 61 20 22 63 6c 65 | 61 6e 20 75 70 22 20 6d |r a "cle|an up" m|
|00001d30| 65 74 68 6f 64 3f 0d 41 | 3a 20 09 52 65 6d 6f 76 |ethod?.A|: .Remov|
|00001d40| 65 53 63 72 69 70 74 20 | 20 69 73 20 63 61 6c 6c |eScript | is call|
|00001d50| 65 64 20 77 68 65 6e 20 | 74 68 65 20 61 70 70 6c |ed when |the appl|
|00001d60| 69 63 61 74 69 6f 6e 20 | 69 73 20 72 65 6d 6f 76 |ication |is remov|
|00001d70| 65 64 2e 20 20 48 6f 77 | 65 76 65 72 2c 20 79 6f |ed.  How|ever, yo|
|00001d80| 75 20 63 61 6e 27 74 20 | 74 65 6c 6c 20 69 66 20 |u can't |tell if |
|00001d90| 74 68 69 73 20 68 61 70 | 70 65 6e 65 64 20 61 73 |this hap|pened as|
|00001da0| 20 61 20 72 65 73 75 6c | 74 20 6f 66 20 22 72 65 | a resul|t of "re|
|00001db0| 6d 6f 76 65 20 73 6f 66 | 74 77 61 72 65 22 20 6f |move sof|tware" o|
|00001dc0| 72 20 74 68 65 20 75 73 | 65 72 20 72 65 6d 6f 76 |r the us|er remov|
|00001dd0| 69 6e 67 20 61 20 50 43 | 4d 43 49 41 20 63 61 72 |ing a PC|MCIA car|
|00001de0| 64 20 77 69 74 68 20 79 | 6f 75 72 20 61 70 70 6c |d with y|our appl|
|00001df0| 69 63 61 74 69 6f 6e 20 | 6f 6e 20 69 74 2e 0d 09 |ication |on it...|
|00001e00| 49 6d 70 6c 65 6d 65 6e | 74 20 79 6f 75 72 20 61 |Implemen|t your a|
|00001e10| 70 70 6c 69 63 61 74 69 | 6f 6e 27 73 20 72 65 6d |pplicati|on's rem|
|00001e20| 6f 76 65 53 63 72 69 70 | 74 20 73 63 72 69 70 74 |oveScrip|t script|
|00001e30| 20 69 6e 20 74 68 65 20 | 50 72 6f 6a 65 63 74 20 | in the |Project |
|00001e40| 44 61 74 61 20 66 69 6c | 65 2e 20 20 42 65 20 63 |Data fil|e.  Be c|
|00001e50| 61 72 65 66 75 6c 3a 20 | 74 68 65 20 61 70 70 6c |areful: |the appl|
|00001e60| 69 63 61 74 69 6f 6e 20 | 20 68 61 73 20 61 6c 72 |ication | has alr|
|00001e70| 65 61 64 79 20 62 65 65 | 6e 20 72 65 6d 6f 76 65 |eady bee|n remove|
|00001e80| 64 20 77 68 65 6e 20 74 | 68 65 20 52 65 6d 6f 76 |d when t|he Remov|
|00001e90| 65 53 63 72 69 70 74 20 | 69 73 20 63 61 6c 6c 65 |eScript |is calle|
|00001ea0| 64 20 73 6f 20 79 6f 75 | 20 63 61 6e 27 74 20 72 |d so you| can't r|
|00001eb0| 65 66 65 72 65 6e 63 65 | 20 74 68 65 20 61 70 70 |eference| the app|
|00001ec0| 6c 69 63 61 74 69 6f 6e | 20 69 74 73 65 6c 66 20 |lication| itself |
|00001ed0| 28 6f 72 20 69 74 73 20 | 73 6c 6f 74 73 2c 20 20 |(or its |slots,  |
|00001ee0| 66 75 6e 63 74 69 6f 6e | 73 2c 20 76 61 72 69 61 |function|s, varia|
|00001ef0| 62 6c 65 73 2c 20 65 74 | 63 2e 20 29 0d 09 54 6f |bles, et|c. )..To|
|00001f00| 20 72 65 6d 6f 76 65 20 | 79 6f 75 72 20 73 6f 75 | remove |your sou|
|00001f10| 70 73 2c 20 79 6f 75 72 | 20 72 65 6d 6f 76 65 53 |ps, your| removeS|
|00001f20| 63 72 69 70 74 20 63 6f | 75 6c 64 20 64 6f 20 73 |cript co|uld do s|
|00001f30| 6f 6d 65 74 68 69 6e 67 | 20 6c 69 6b 65 20 74 68 |omething| like th|
|00001f40| 69 73 3a 0d 41 64 64 44 | 65 66 65 72 72 65 64 41 |is:.AddD|eferredA|
|00001f50| 63 74 69 6f 6e 28 66 75 | 6e 63 28 29 20 66 6f 72 |ction(fu|nc() for|
|00001f60| 65 61 63 68 20 73 74 6f | 72 65 20 69 6e 20 47 65 |each sto|re in Ge|
|00001f70| 74 53 74 6f 72 65 73 28 | 29 20 64 6f 20 62 65 67 |tStores(|) do beg|
|00001f80| 69 6e 0d 09 6c 6f 63 61 | 6c 20 73 6f 75 70 20 3a |in..loca|l soup :|
|00001f90| 3d 20 73 74 6f 72 65 3a | 47 65 74 53 6f 75 70 28 |= store:|GetSoup(|
|00001fa0| 22 6d 79 53 6f 75 70 4e | 61 6d 65 22 29 3b 0d 09 |"mySoupN|ame");..|
|00001fb0| 69 66 20 73 6f 75 70 20 | 74 68 65 6e 0d 09 09 73 |if soup |then...s|
|00001fc0| 6f 75 70 3a 52 65 6d 6f | 76 65 46 72 6f 6d 53 74 |oup:Remo|veFromSt|
|00001fd0| 6f 72 65 28 29 3b 0d 09 | 09 2f 2f 20 6d 69 67 68 |ore();..|.// migh|
|00001fe0| 74 20 61 6c 73 6f 20 77 | 61 6e 74 20 74 6f 20 68 |t also w|ant to h|
|00001ff0| 61 6e 64 6c 65 20 63 61 | 73 65 20 77 68 65 6e 20 |andle ca|se when |
|00002000| 73 74 6f 72 65 3a 49 73 | 52 65 61 64 4f 6e 6c 79 |store:Is|ReadOnly|
|00002010| 28 29 20 3d 20 74 72 75 | 65 0d 09 65 6e 64 29 3b |() = tru|e..end);|
|00002020| 0d 09 47 65 74 53 74 6f | 72 65 73 20 68 61 73 20 |..GetSto|res has |
|00002030| 70 72 6f 62 6c 65 6d 73 | 20 69 66 20 74 68 65 20 |problems| if the |
|00002040| 72 65 6d 6f 76 65 53 63 | 72 69 70 74 20 69 73 20 |removeSc|ript is |
|00002050| 63 61 6c 6c 65 64 20 61 | 73 20 74 68 65 20 72 65 |called a|s the re|
|00002060| 73 75 6c 74 20 6f 66 20 | 61 20 63 61 72 64 20 72 |sult of |a card r|
|00002070| 65 6d 6f 76 61 6c 20 65 | 76 65 6e 74 2e 20 20 54 |emoval e|vent.  T|
|00002080| 68 65 20 41 64 64 44 65 | 66 65 72 72 65 64 41 63 |he AddDe|ferredAc|
|00002090| 74 69 6f 6e 20 77 6f 72 | 6b 73 20 61 72 6f 75 6e |tion wor|ks aroun|
|000020a0| 64 20 74 68 69 73 20 70 | 72 6f 62 6c 65 6d 2e 0d |d this p|roblem..|
|000020b0| 09 0d 09 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..._____|________|
|000020c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000020d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 0d 43 |________|______.C|
|000020e0| 72 65 61 74 69 6e 67 20 | 53 6f 75 70 73 20 50 72 |reating |Soups Pr|
|000020f0| 6f 70 65 72 6c 79 20 28 | 31 30 2f 35 2f 39 33 29 |operly (|10/5/93)|
|00002100| 20 28 6f 62 73 6f 6c 65 | 74 65 64 20 62 79 20 31 | (obsole|ted by 1|
|00002110| 2e 30 20 4e 65 77 74 6f | 6e 20 50 72 6f 67 72 61 |.0 Newto|n Progra|
|00002120| 6d 6d 65 72 27 73 20 47 | 75 69 64 65 20 70 37 2d |mmer's G|uide p7-|
|00002130| 32 34 29 0d 09 55 73 65 | 20 52 65 67 69 73 74 65 |24)..Use| Registe|
|00002140| 72 43 61 72 64 53 6f 75 | 70 20 61 6e 64 20 55 6e |rCardSou|p and Un|
|00002150| 52 65 67 69 73 74 65 72 | 43 61 72 64 53 6f 75 70 |Register|CardSoup|
|00002160| 2e 20 54 68 65 73 65 20 | 61 72 65 20 70 72 6f 76 |. These |are prov|
|00002170| 69 64 65 64 20 69 6e 20 | 74 68 65 20 6c 61 74 65 |ided in |the late|
|00002180| 73 74 20 4e 54 4b 20 70 | 6c 61 74 66 6f 72 6d 73 |st NTK p|latforms|
|00002190| 20 66 69 6c 65 20 76 69 | 61 20 74 68 65 20 63 6f | file vi|a the co|
|000021a0| 6e 73 74 61 6e 74 73 20 | 6b 52 65 67 69 73 74 65 |nstants |kRegiste|
|000021b0| 72 43 61 72 64 53 6f 75 | 70 46 75 6e 63 20 61 6e |rCardSou|pFunc an|
|000021c0| 64 20 6b 55 6e 52 65 67 | 69 73 74 65 72 43 61 72 |d kUnReg|isterCar|
|000021d0| 64 53 6f 75 70 46 75 6e | 63 2e 20 53 65 65 20 74 |dSoupFun|c. See t|
|000021e0| 68 65 20 70 6c 61 74 66 | 6f 72 6d 20 66 69 6c 65 |he platf|orm file|
|000021f0| 20 72 65 6c 65 61 73 65 | 20 6e 6f 74 65 73 20 66 | release| notes f|
|00002200| 6f 72 20 6d 6f 72 65 20 | 69 6e 66 6f 72 6d 61 74 |or more |informat|
|00002210| 69 6f 6e 2e 0d 09 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ion...__|________|
|00002220| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002230| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002240| 5f 0d 43 6f 75 6e 74 20 | 53 6f 75 70 20 45 6e 74 |_.Count |Soup Ent|
|00002250| 72 69 65 73 2c 20 48 6f | 77 3f 20 28 31 30 2f 31 |ries, Ho|w? (10/1|
|00002260| 34 2f 39 33 29 20 28 4f | 62 73 6f 6c 65 74 65 64 |4/93) (O|bsoleted|
|00002270| 20 62 79 20 31 2e 30 20 | 4e 65 77 74 6f 6e 20 50 | by 1.0 |Newton P|
|00002280| 72 6f 67 72 61 6d 6d 65 | 72 27 73 20 47 75 69 64 |rogramme|r's Guid|
|00002290| 65 20 70 37 2d 34 38 29 | 0d 51 3a 20 09 48 6f 77 |e p7-48)|.Q: .How|
|000022a0| 20 64 6f 20 49 20 64 65 | 74 65 72 6d 69 6e 65 20 | do I de|termine |
|000022b0| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 65 6e |the numb|er of en|
|000022c0| 74 72 69 65 73 20 69 6e | 20 61 20 73 6f 75 70 20 |tries in| a soup |
|000022d0| 28 6f 72 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f |(or the |number o|
|000022e0| 66 20 65 6e 74 72 69 65 | 73 20 72 65 74 75 72 6e |f entrie|s return|
|000022f0| 65 64 20 62 79 20 61 20 | 51 75 65 72 79 29 3f 20 |ed by a |Query)? |
|00002300| 49 20 66 69 67 75 72 65 | 64 20 6f 75 74 20 68 6f |I figure|d out ho|
|00002310| 77 20 74 6f 20 64 6f 20 | 69 74 20 77 69 74 68 20 |w to do |it with |
|00002320| 4d 61 70 43 75 72 73 6f | 72 2c 20 62 75 74 20 69 |MapCurso|r, but i|
|00002330| 73 20 74 68 65 72 65 20 | 61 6e 20 65 61 73 69 65 |s there |an easie|
|00002340| 72 20 77 61 79 3f 0d 41 | 3a 09 54 68 69 73 20 69 |r way?.A|:.This i|
|00002350| 73 20 6e 6f 74 20 61 20 | 73 69 6d 70 6c 65 20 63 |s not a |simple c|
|00002360| 61 73 65 2e 20 48 65 72 | 65 27 73 20 61 6e 20 65 |ase. Her|e's an e|
|00002370| 78 61 6d 70 6c 65 20 6f | 66 20 61 20 66 75 6e 63 |xample o|f a func|
|00002380| 74 69 6f 6e 20 74 68 61 | 74 20 79 6f 75 20 63 6f |tion tha|t you co|
|00002390| 75 6c 64 20 75 73 65 20 | 69 6e 73 74 65 61 64 20 |uld use |instead |
|000023a0| 6f 66 20 75 73 69 6e 67 | 20 4d 61 70 43 75 72 73 |of using| MapCurs|
|000023b0| 6f 72 2e 20 54 68 69 73 | 20 66 75 6e 63 74 69 6f |or. This| functio|
|000023c0| 6e 20 6d 61 79 20 62 65 | 20 73 6c 6f 77 65 72 20 |n may be| slower |
|000023d0| 74 68 6f 75 67 68 2c 20 | 62 75 74 20 69 74 20 64 |though, |but it d|
|000023e0| 6f 65 73 20 6e 6f 74 20 | 62 72 69 6e 67 20 73 6f |oes not |bring so|
|000023f0| 75 70 20 65 6e 74 72 69 | 65 73 20 69 6e 74 6f 20 |up entri|es into |
|00002400| 74 68 65 20 66 72 61 6d | 65 20 68 65 61 70 2c 20 |the fram|e heap, |
|00002410| 73 6f 20 6d 65 6d 6f 72 | 79 20 70 65 72 66 6f 72 |so memor|y perfor|
|00002420| 6d 61 6e 63 65 20 6d 61 | 79 20 62 65 20 62 65 74 |mance ma|y be bet|
|00002430| 74 65 72 2e 0d 20 20 20 | 20 20 20 20 20 66 75 6e |ter..   |     fun|
|00002440| 63 20 43 6f 75 6e 74 43 | 75 72 73 6f 72 45 6e 74 |c CountC|ursorEnt|
|00002450| 72 69 65 73 20 28 63 75 | 72 73 6f 72 29 0d 20 20 |ries (cu|rsor).  |
|00002460| 20 20 20 20 20 20 62 65 | 67 69 6e 0d 20 20 20 20 |      be|gin.    |
|00002470| 20 20 20 20 20 20 20 20 | 20 20 20 20 63 75 72 73 |        |    curs|
|00002480| 6f 72 20 3a 3d 20 63 75 | 72 73 6f 72 3a 43 6c 6f |or := cu|rsor:Clo|
|00002490| 6e 65 28 29 3b 0d 20 20 | 20 20 20 20 20 20 20 20 |ne();.  |        |
|000024a0| 20 20 20 20 20 20 63 75 | 72 73 6f 72 3a 52 65 73 |      cu|rsor:Res|
|000024b0| 65 74 28 29 3b 0d 20 20 | 20 20 20 20 20 20 20 20 |et();.  |        |
|000024c0| 20 20 20 20 20 20 69 66 | 20 63 75 72 73 6f 72 3a |      if| cursor:|
|000024d0| 45 6e 74 72 79 28 29 20 | 3d 20 4e 49 4c 20 74 68 |Entry() |= NIL th|
|000024e0| 65 6e 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |en.     |        |
|000024f0| 20 20 20 20 20 20 20 20 | 20 20 20 72 65 74 75 72 |        |   retur|
|00002500| 6e 20 30 3b 0d 20 20 20 | 20 20 20 20 20 20 20 20 |n 0;.   |        |
|00002510| 20 20 20 20 20 6c 6f 63 | 61 6c 20 63 6f 75 6e 74 |     loc|al count|
|00002520| 20 3a 3d 20 31 3b 0d 20 | 20 20 20 20 20 20 20 20 | := 1;. |        |
|00002530| 20 20 20 20 20 20 20 77 | 68 69 6c 65 20 63 75 72 |       w|hile cur|
|00002540| 73 6f 72 3a 4e 65 78 74 | 28 29 20 64 6f 0d 20 20 |sor:Next|() do.  |
|00002550| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002560| 20 20 20 20 20 20 63 6f | 75 6e 74 20 3a 3d 20 63 |      co|unt := c|
|00002570| 6f 75 6e 74 20 2b 20 31 | 3b 0d 20 20 20 20 20 20 |ount + 1|;.      |
|00002580| 20 20 20 20 20 20 20 20 | 20 20 63 6f 75 6e 74 0d |        |  count.|
|00002590| 20 20 20 20 20 20 20 20 | 65 6e 64 0d 09 4e 6f 74 |        |end..Not|
|000025a0| 65 20 74 68 61 74 20 75 | 73 69 6e 67 20 4d 61 70 |e that u|sing Map|
|000025b0| 43 75 72 73 6f 72 20 6f | 72 20 69 74 65 72 61 74 |Cursor o|r iterat|
|000025c0| 69 6e 67 20 74 68 72 6f | 75 67 68 20 74 68 65 20 |ing thro|ugh the |
|000025d0| 63 75 72 73 6f 72 20 77 | 69 6c 6c 20 6f 6e 6c 79 |cursor w|ill only|
|000025e0| 20 64 65 74 65 72 6d 69 | 6e 65 20 74 68 65 20 6e | determi|ne the n|
|000025f0| 75 6d 62 65 72 20 6f 66 | 20 65 6e 74 72 69 65 73 |umber of| entries|
|00002600| 20 61 74 20 74 68 65 20 | 74 69 6d 65 20 6f 66 20 | at the |time of |
|00002610| 69 74 65 72 61 74 69 6f | 6e 2e 0d 09 53 6f 75 70 |iteratio|n...Soup|
|00002620| 73 20 61 72 65 20 66 75 | 6c 6c 79 20 64 79 6e 61 |s are fu|lly dyna|
|00002630| 6d 69 63 3b 20 49 20 63 | 61 6e 20 61 64 64 20 61 |mic; I c|an add a|
|00002640| 6e 64 20 64 65 6c 65 74 | 65 20 69 74 65 6d 73 20 |nd delet|e items |
|00002650| 74 6f 2f 66 72 6f 6d 20 | 74 68 65 20 73 6f 75 70 |to/from |the soup|
|00002660| 20 61 73 20 79 6f 75 20 | 61 72 65 20 69 74 65 72 | as you |are iter|
|00002670| 61 74 69 6e 67 20 61 6e | 64 20 74 68 65 20 63 75 |ating an|d the cu|
|00002680| 72 73 6f 72 20 77 69 6c | 6c 20 74 61 6b 65 20 74 |rsor wil|l take t|
|00002690| 68 69 73 20 69 6e 74 6f | 20 61 63 63 6f 75 6e 74 |his into| account|
|000026a0| 2e 20 20 49 6e 20 6f 74 | 68 65 72 20 77 6f 72 64 |.  In ot|her word|
|000026b0| 73 2c 20 79 6f 75 20 68 | 61 76 65 20 74 6f 20 69 |s, you h|ave to i|
|000026c0| 74 65 72 61 74 65 20 74 | 6f 20 66 69 6e 64 20 74 |terate t|o find t|
|000026d0| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 65 6e 74 |he numbe|r of ent|
|000026e0| 72 69 65 73 2c 20 74 68 | 6f 75 67 68 20 74 68 65 |ries, th|ough the|
|000026f0| 79 20 63 61 6e 20 63 68 | 61 6e 67 65 2e 20 43 75 |y can ch|ange. Cu|
|00002700| 72 73 6f 72 73 20 61 72 | 65 20 64 79 6e 61 6d 69 |rsors ar|e dynami|
|00002710| 63 21 0d 09 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |c!..____|________|
|00002720| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002730| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00002740| 47 65 74 74 69 6e 67 2f | 53 65 74 74 69 6e 67 20 |Getting/|Setting |
|00002750| 74 68 65 20 44 65 66 61 | 75 6c 74 20 53 74 6f 72 |the Defa|ult Stor|
|00002760| 65 20 28 31 31 2f 31 30 | 2f 39 33 29 20 28 6f 62 |e (11/10|/93) (ob|
|00002770| 73 6f 6c 65 74 65 64 20 | 62 79 20 31 2e 30 20 4e |soleted |by 1.0 N|
|00002780| 65 77 74 6f 6e 20 50 72 | 6f 67 72 61 6d 6d 65 72 |ewton Pr|ogrammer|
|00002790| 27 73 20 47 75 69 64 65 | 20 70 37 2d 36 35 29 0d |'s Guide| p7-65).|
|000027a0| 09 54 68 65 20 6c 61 74 | 65 73 74 20 4e 54 4b 20 |.The lat|est NTK |
|000027b0| 70 6c 61 74 66 6f 72 6d | 73 20 66 69 6c 65 20 70 |platform|s file p|
|000027c0| 72 6f 76 69 64 65 73 20 | 53 65 74 44 65 66 61 75 |rovides |SetDefau|
|000027d0| 6c 74 53 74 6f 72 65 20 | 61 6e 64 20 47 65 74 44 |ltStore |and GetD|
|000027e0| 65 66 61 75 6c 74 53 74 | 6f 72 65 20 76 69 61 20 |efaultSt|ore via |
|000027f0| 74 68 65 20 63 6f 6e 73 | 74 61 6e 74 73 20 6b 53 |the cons|tants kS|
|00002800| 65 74 44 65 66 61 75 6c | 74 53 74 6f 72 65 46 75 |etDefaul|tStoreFu|
|00002810| 6e 63 20 61 6e 64 20 6b | 47 65 74 44 65 66 61 75 |nc and k|GetDefau|
|00002820| 6c 74 53 74 6f 72 65 46 | 75 6e 63 2e 20 53 65 65 |ltStoreF|unc. See|
|00002830| 20 74 68 65 20 70 6c 61 | 74 66 6f 72 6d 20 66 69 | the pla|tform fi|
|00002840| 6c 65 20 72 65 6c 65 61 | 73 65 20 6e 6f 74 65 73 |le relea|se notes|
|00002850| 20 66 6f 72 20 6d 6f 72 | 65 20 69 6e 66 6f 72 6d | for mor|e inform|
|00002860| 61 74 69 6f 6e 2e 0d 09 | 5f 5f 5f 5f 5f 5f 5f 5f |ation...|________|
|00002870| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002880| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002890| 5f 5f 5f 0d 4e 75 6c 6c | 20 55 6e 69 6f 6e 2d 53 |___.Null| Union-S|
|000028a0| 6f 75 70 73 3f 20 28 31 | 31 2f 31 30 2f 39 33 29 |oups? (1|1/10/93)|
|000028b0| 20 28 4f 62 73 6f 6c 65 | 74 65 64 20 62 79 20 31 | (Obsole|ted by 1|
|000028c0| 2e 30 20 4e 65 77 74 6f | 6e 20 50 72 6f 67 72 61 |.0 Newto|n Progra|
|000028d0| 6d 6d 65 72 27 73 20 47 | 75 69 64 65 20 70 37 2d |mmer's G|uide p7-|
|000028e0| 36 36 29 0d 09 54 68 65 | 20 6c 61 74 65 73 74 20 |66)..The| latest |
|000028f0| 4e 54 4b 20 70 6c 61 74 | 66 6f 72 6d 73 20 66 69 |NTK plat|forms fi|
|00002900| 6c 65 20 70 72 6f 76 69 | 64 65 73 20 55 6e 69 6f |le provi|des Unio|
|00002910| 6e 53 6f 75 70 49 73 4e | 75 6c 6c 20 76 69 61 20 |nSoupIsN|ull via |
|00002920| 74 68 65 20 63 6f 6e 73 | 74 61 6e 74 73 20 6b 55 |the cons|tants kU|
|00002930| 6e 69 6f 6e 53 6f 75 70 | 49 73 4e 75 6c 6c 46 75 |nionSoup|IsNullFu|
|00002940| 6e 63 2e 20 53 65 65 20 | 74 68 65 20 70 6c 61 74 |nc. See |the plat|
|00002950| 66 6f 72 6d 20 66 69 6c | 65 20 72 65 6c 65 61 73 |form fil|e releas|
|00002960| 65 20 6e 6f 74 65 73 20 | 66 6f 72 20 6d 6f 72 65 |e notes |for more|
|00002970| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 0d 09 5f | informa|tion..._|
|00002980| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002990| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000029a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 55 6e 69 6f 6e |________|__.Union|
|000029b0| 53 6f 75 70 20 44 61 6e | 67 65 72 73 20 28 31 31 |Soup Dan|gers (11|
|000029c0| 2f 31 30 2f 39 33 29 0d | 09 4e 6f 74 65 20 74 68 |/10/93).|.Note th|
|000029d0| 61 74 20 75 6e 69 71 75 | 65 20 49 44 73 20 6f 66 |at uniqu|e IDs of|
|000029e0| 20 61 20 73 6f 75 70 20 | 65 6e 74 72 79 20 61 72 | a soup |entry ar|
|000029f0| 65 20 6f 6e 6c 79 20 76 | 61 6c 69 64 20 77 69 74 |e only v|alid wit|
|00002a00| 68 69 6e 20 74 68 65 20 | 73 61 6d 65 20 73 6f 75 |hin the |same sou|
|00002a10| 70 2e 20 49 66 20 79 6f | 75 20 75 73 65 20 55 6e |p. If yo|u use Un|
|00002a20| 69 6f 6e 20 53 6f 75 70 | 73 20 79 6f 75 20 63 6f |ion Soup|s you co|
|00002a30| 75 6c 64 20 67 65 74 20 | 22 75 6e 69 71 75 65 22 |uld get |"unique"|
|00002a40| 20 49 44 73 20 74 68 61 | 74 20 61 72 65 20 74 68 | IDs tha|t are th|
|00002a50| 65 20 73 61 6d 65 20 66 | 72 6f 6d 20 74 77 6f 20 |e same f|rom two |
|00002a60| 64 69 66 66 65 72 65 6e | 74 20 6d 65 6d 62 65 72 |differen|t member|
|00002a70| 20 73 6f 75 70 73 2e 20 | 49 74 20 74 61 6b 65 73 | soups. |It takes|
|00002a80| 20 74 68 65 20 73 74 6f | 72 65 20 73 69 67 6e 61 | the sto|re signa|
|00002a90| 74 75 72 65 2c 20 73 6f | 75 70 20 73 69 67 6e 61 |ture, so|up signa|
|00002aa0| 74 75 72 65 2c 20 61 6e | 64 20 65 6e 74 72 79 27 |ture, an|d entry'|
|00002ab0| 73 20 75 6e 69 71 75 65 | 20 49 44 20 74 6f 20 75 |s unique| ID to u|
|00002ac0| 6e 69 71 75 65 6c 79 20 | 73 70 65 63 69 66 79 20 |niquely |specify |
|00002ad0| 61 6e 20 65 6e 74 72 79 | 20 69 6e 20 61 20 75 6e |an entry| in a un|
|00002ae0| 69 6f 6e 20 73 6f 75 70 | 2e 0d 09 5f 5f 5f 5f 5f |ion soup|..._____|
|00002af0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002b00| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002b10| 5f 5f 5f 5f 5f 0d 55 6e | 69 71 75 65 49 44 73 20 |_____.Un|iqueIDs |
|00002b20| 28 31 31 2f 31 30 2f 39 | 33 29 0d 09 55 73 65 20 |(11/10/9|3)..Use |
|00002b30| 74 68 65 20 45 6e 74 72 | 79 55 6e 69 71 75 65 49 |the Entr|yUniqueI|
|00002b40| 44 20 66 75 6e 63 74 69 | 6f 6e 20 69 6e 73 74 65 |D functi|on inste|
|00002b50| 61 64 20 6f 66 20 75 73 | 69 6e 67 20 74 68 65 20 |ad of us|ing the |
|00002b60| 5f 75 6e 69 71 75 65 49 | 44 20 73 6c 6f 74 20 66 |_uniqueI|D slot f|
|00002b70| 72 6f 6d 20 74 68 65 20 | 65 6e 74 72 79 2e 20 54 |rom the |entry. T|
|00002b80| 68 69 73 20 69 73 20 70 | 72 65 66 65 72 61 62 6c |his is p|referabl|
|00002b90| 65 20 62 65 63 61 75 73 | 65 20 74 68 65 20 75 6e |e becaus|e the un|
|00002ba0| 69 71 75 65 20 49 44 20 | 69 6d 70 6c 65 6d 65 6e |ique ID |implemen|
|00002bb0| 74 61 74 69 6f 6e 20 6d | 69 67 68 74 20 28 6f 72 |tation m|ight (or|
|00002bc0| 20 6d 69 67 68 74 20 6e | 6f 74 29 20 63 68 61 6e | might n|ot) chan|
|00002bd0| 67 65 20 69 6e 20 74 68 | 65 20 66 75 74 75 72 65 |ge in th|e future|
|00002be0| 2c 20 62 75 74 20 74 68 | 65 20 66 75 6e 63 74 69 |, but th|e functi|
|00002bf0| 6f 6e 20 77 69 6c 6c 20 | 61 6c 77 61 79 73 20 72 |on will |always r|
|00002c00| 65 74 75 72 6e 20 61 20 | 75 6e 69 71 75 65 20 49 |eturn a |unique I|
|00002c10| 44 2e 0d 09 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |D...____|________|
|00002c20| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00002c30| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00002c40| 53 6f 75 70 20 52 65 6d | 6f 76 61 6c 20 50 72 6f |Soup Rem|oval Pro|
|00002c50| 62 6c 65 6d 73 2c 20 49 | 6e 64 65 78 69 6e 67 2c |blems, I|ndexing,|
|00002c60| 20 45 72 72 6f 72 20 2d | 34 38 30 32 32 20 28 31 | Error -|48022 (1|
|00002c70| 31 2f 31 30 2f 39 33 29 | 20 28 4f 62 73 6f 6c 65 |1/10/93)| (Obsole|
|00002c80| 74 65 64 20 62 79 20 31 | 2e 30 20 4e 65 77 74 6f |ted by 1|.0 Newto|
|00002c90| 6e 20 50 72 6f 67 72 61 | 6d 6d 65 72 27 73 20 47 |n Progra|mmer's G|
|00002ca0| 75 69 64 65 20 70 37 2d | 33 32 29 0d 51 3a 09 4f |uide p7-|32).Q:.O|
|00002cb0| 6e 20 61 20 4e 65 77 74 | 6f 6e 20 4d 65 73 73 61 |n a Newt|on Messa|
|00002cc0| 67 65 50 61 64 2c 20 20 | 77 68 65 6e 20 74 72 69 |gePad,  |when tri|
|00002cd0| 6e 67 20 74 6f 20 72 65 | 6d 6f 76 65 20 61 20 73 |ng to re|move a s|
|00002ce0| 6f 75 70 20 66 72 6f 6d | 20 61 20 50 43 4d 43 49 |oup from| a PCMCI|
|00002cf0| 41 20 46 6c 61 73 68 20 | 63 61 72 64 20 73 74 6f |A Flash |card sto|
|00002d00| 72 65 2c 20 49 20 72 65 | 63 65 69 76 65 64 20 61 |re, I re|ceived a|
|00002d10| 20 22 49 6e 74 65 72 6e | 61 6c 20 65 72 72 6f 72 | "Intern|al error|
|00002d20| 2d 73 6f 6d 65 74 68 69 | 6e 67 20 75 6e 65 78 70 |-somethi|ng unexp|
|00002d30| 65 63 74 65 64 20 68 61 | 70 70 65 6e 65 64 2e 22 |ected ha|ppened."|
|00002d40| 20 6d 65 73 73 61 67 65 | 2c 20 65 72 72 6f 72 20 | message|, error |
|00002d50| 6e 75 6d 62 65 72 20 2d | 34 38 30 32 32 2e 20 20 |number -|48022.  |
|00002d60| 57 68 61 74 20 64 69 64 | 20 72 65 61 6c 6c 79 20 |What did| really |
|00002d70| 68 61 70 70 65 6e 3f 0d | 41 3a 20 09 54 68 69 73 |happen?.|A: .This|
|00002d80| 20 65 72 72 6f 72 20 69 | 73 20 72 65 74 75 72 6e | error i|s return|
|00002d90| 65 64 20 77 68 65 6e 20 | 61 6e 79 20 6f 66 20 74 |ed when |any of t|
|00002da0| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 74 68 69 |he follo|wing thi|
|00002db0| 6e 67 73 20 68 61 70 70 | 65 6e 2e 0d 09 a5 09 54 |ngs happ|en.....T|
|00002dc0| 68 65 72 65 20 69 73 20 | 6e 6f 20 73 70 61 63 65 |here is |no space|
|00002dd0| 20 66 6f 72 20 6d 6f 72 | 65 20 6e 6f 64 65 73 20 | for mor|e nodes |
|00002de0| 77 68 69 6c 65 20 69 6e | 64 65 78 69 6e 67 2e 0d |while in|dexing..|
|00002df0| 09 a5 09 41 20 73 6c 6f | 74 20 69 73 20 69 6e 74 |...A slo|t is int|
|00002e00| 65 72 6e 61 6c 6c 79 20 | 6f 75 74 20 6f 66 20 72 |ernally |out of r|
|00002e10| 61 6e 67 65 20 28 63 72 | 65 61 74 69 6e 67 20 61 |ange (cr|eating a|
|00002e20| 20 70 72 6f 62 6c 65 6d | 20 66 69 6e 64 69 6e 67 | problem| finding|
|00002e30| 20 69 74 20 75 73 69 6e | 67 20 6f 66 66 73 65 74 | it usin|g offset|
|00002e40| 29 0d 09 a5 09 54 68 65 | 20 73 79 73 74 65 6d 20 |)....The| system |
|00002e50| 69 73 20 75 6e 61 62 6c | 65 20 74 6f 20 63 72 65 |is unabl|e to cre|
|00002e60| 61 74 65 20 69 6e 64 65 | 78 20 72 65 73 6f 75 72 |ate inde|x resour|
|00002e70| 63 65 73 20 77 68 65 6e | 20 63 72 65 61 74 69 6e |ces when| creatin|
|00002e80| 67 20 61 20 73 6f 75 70 | 2c 20 6f 72 20 77 68 65 |g a soup|, or whe|
|00002e90| 6e 20 61 64 64 69 6e 67 | 20 6f 72 20 64 65 6c 65 |n adding| or dele|
|00002ea0| 74 69 6e 67 20 69 6e 64 | 65 78 65 73 2e 0d 09 49 |ting ind|exes...I|
|00002eb0| 66 20 79 6f 75 20 72 65 | 63 65 69 76 65 20 74 68 |f you re|ceive th|
|00002ec0| 69 73 20 65 72 72 6f 72 | 2c 20 74 68 65 72 65 20 |is error|, there |
|00002ed0| 69 73 20 61 20 73 74 72 | 6f 6e 67 20 70 6f 73 73 |is a str|ong poss|
|00002ee0| 69 62 69 6c 69 74 79 20 | 74 68 61 74 20 74 68 65 |ibility |that the|
|00002ef0| 20 73 6f 75 70 d5 73 20 | 69 6e 64 65 78 20 64 65 | soup.s |index de|
|00002f00| 66 69 6e 69 74 69 6f 6e | 73 20 61 72 65 20 6f 72 |finition|s are or|
|00002f10| 20 77 65 72 65 20 63 6f | 72 72 75 70 74 65 64 2e | were co|rrupted.|
|00002f20| 20 59 6f 75 20 6d 69 67 | 68 74 20 61 6c 73 6f 20 | You mig|ht also |
|00002f30| 63 68 65 63 6b 20 74 6f | 20 73 65 65 20 77 68 65 |check to| see whe|
|00002f40| 74 68 65 72 20 20 79 6f | 75 20 61 72 65 20 61 74 |ther  yo|u are at|
|00002f50| 74 65 6d 70 74 69 6e 67 | 20 74 6f 20 64 65 6c 65 |tempting| to dele|
|00002f60| 74 65 20 61 6e 20 69 6e | 64 65 78 20 74 68 61 74 |te an in|dex that|
|00002f70| 20 69 73 20 6e 6f 20 6c | 6f 6e 67 65 72 20 70 72 | is no l|onger pr|
|00002f80| 65 73 65 6e 74 2e 0d 09 | 57 69 74 68 20 4d 65 73 |esent...|With Mes|
|00002f90| 73 61 67 65 50 61 64 73 | 20 62 65 66 6f 72 65 20 |sagePads| before |
|00002fa0| 74 68 65 20 31 2e 30 35 | 20 73 79 73 74 65 6d 20 |the 1.05| system |
|00002fb0| 75 70 64 61 74 65 2c 20 | 69 74 20 77 61 73 20 70 |update, |it was p|
|00002fc0| 6f 73 73 69 62 6c 65 20 | 74 6f 20 22 63 6f 72 72 |ossible |to "corr|
|00002fd0| 75 70 74 22 20 73 6f 75 | 70 20 69 6e 64 65 78 65 |upt" sou|p indexe|
|00002fe0| 73 20 62 79 20 61 64 64 | 69 6e 67 20 65 6e 74 72 |s by add|ing entr|
|00002ff0| 69 65 73 20 77 69 74 68 | 20 4e 49 4c 20 69 6e 20 |ies with| NIL in |
|00003000| 61 6e 20 69 6e 64 65 78 | 65 64 20 73 6c 6f 74 2e |an index|ed slot.|
|00003010| 20 20 28 4e 6f 74 20 68 | 61 76 69 6e 67 20 74 68 |  (Not h|aving th|
|00003020| 65 20 73 6c 6f 74 20 70 | 72 65 73 65 6e 74 20 61 |e slot p|resent a|
|00003030| 74 20 61 6c 6c 20 69 73 | 20 6e 6f 20 70 72 6f 62 |t all is| no prob|
|00003040| 6c 65 6d 2c 20 62 75 74 | 20 68 61 76 69 6e 67 20 |lem, but| having |
|00003050| 74 68 65 20 73 6c 6f 74 | 20 77 69 74 68 20 4e 49 |the slot| with NI|
|00003060| 4c 20 77 61 73 2e 29 20 | 20 49 66 20 79 6f 75 20 |L was.) | If you |
|00003070| 68 61 76 65 20 61 20 31 | 2e 30 35 20 6f 72 20 6c |have a 1|.05 or l|
|00003080| 61 74 65 72 20 4d 65 73 | 73 61 67 65 50 61 64 2c |ater Mes|sagePad,|
|00003090| 20 4e 49 4c 20 69 6e 20 | 69 6e 64 65 78 65 64 20 | NIL in |indexed |
|000030a0| 73 6c 6f 74 73 20 69 73 | 20 70 65 72 66 65 63 74 |slots is| perfect|
|000030b0| 6c 79 20 6c 65 67 61 6c | 2e 0d 09 5f 5f 5f 5f 5f |ly legal|..._____|
|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 0d 53 | 6f 75 70 20 53 69 7a 65 |______.S|oup Size|
|000030f0| 73 20 2d 20 47 65 6e 65 | 72 61 74 65 20 54 65 73 |s - Gene|rate Tes|
|00003100| 74 20 53 6f 75 70 20 28 | 31 31 2f 33 30 2f 39 33 |t Soup (|11/30/93|
|00003110| 29 20 28 4f 62 73 6f 6c | 65 74 65 64 20 62 79 20 |) (Obsol|eted by |
|00003120| 31 2e 30 20 4e 65 77 74 | 6f 6e 20 50 72 6f 67 72 |1.0 Newt|on Progr|
|00003130| 61 6d 6d 65 72 27 73 20 | 47 75 69 64 65 20 70 37 |ammer's |Guide p7|
|00003140| 2d 33 32 29 0d 09 42 65 | 63 61 75 73 65 20 6f 66 |-32)..Be|cause of|
|00003150| 20 63 6f 6d 70 61 63 74 | 69 6f 6e 20 61 6e 64 20 | compact|ion and |
|00003160| 6f 74 68 65 72 20 69 6e | 74 65 72 6e 61 6c 20 69 |other in|ternal i|
|00003170| 73 73 75 65 73 2c 20 69 | 74 27 73 20 76 65 72 79 |ssues, i|t's very|
|00003180| 20 68 61 72 64 20 74 6f | 20 70 72 65 64 69 63 74 | hard to| predict|
|00003190| 20 77 68 61 74 20 61 20 | 66 69 6e 61 6c 20 73 6f | what a |final so|
|000031a0| 75 70 20 73 69 7a 65 20 | 77 69 6c 6c 20 62 65 2e |up size |will be.|
|000031b0| 20 4f 6e 65 20 77 61 79 | 20 74 6f 20 6d 65 61 73 | One way| to meas|
|000031c0| 75 72 65 20 74 68 69 73 | 20 69 73 20 74 6f 20 67 |ure this| is to g|
|000031d0| 65 6e 65 72 61 74 65 20 | 61 20 66 61 6b 65 20 73 |enerate |a fake s|
|000031e0| 6f 75 70 2c 20 61 64 64 | 20 66 61 6b 65 20 64 61 |oup, add| fake da|
|000031f0| 74 61 20 74 6f 20 69 74 | 2c 20 61 6e 64 20 6d 65 |ta to it|, and me|
|00003200| 61 73 75 72 65 20 74 68 | 65 20 73 6f 75 70 20 73 |asure th|e soup s|
|00003210| 69 7a 65 2e 0d 09 42 65 | 6c 6f 77 20 69 73 20 73 |ize...Be|low is s|
|00003220| 61 6d 70 6c 65 20 63 6f | 64 65 20 73 68 6f 77 69 |ample co|de showi|
|00003230| 6e 67 20 68 6f 77 20 20 | 74 6f 20 63 72 65 61 74 |ng how  |to creat|
|00003240| 65 20 61 20 74 65 78 74 | 20 73 6f 75 70 20 71 75 |e a text| soup qu|
|00003250| 69 63 6b 6c 79 20 75 73 | 69 6e 67 20 74 68 65 20 |ickly us|ing the |
|00003260| 49 6e 73 70 65 63 74 6f | 72 3a 0d 63 61 6c 6c 20 |Inspecto|r:.call |
|00003270| 66 75 6e 63 28 29 20 62 | 65 67 69 6e 0d 20 20 20 |func() b|egin.   |
|00003280| 6c 6f 63 61 6c 20 73 2c | 20 69 2c 20 6a 3b 0d 20 |local s,| i, j;. |
|00003290| 20 20 66 6f 72 20 69 20 | 3a 3d 20 31 20 74 6f 20 |  for i |:= 1 to |
|000032a0| 52 61 6e 64 6f 6d 28 31 | 30 2c 20 32 30 29 20 64 |Random(1|0, 20) d|
|000032b0| 6f 20 62 65 67 69 6e 0d | 20 20 20 20 20 20 73 20 |o begin.|      s |
|000032c0| 3a 3d 20 47 65 74 53 74 | 6f 72 65 73 28 29 5b 30 |:= GetSt|ores()[0|
|000032d0| 5d 3a 43 72 65 61 74 65 | 53 6f 75 70 28 22 53 6f |]:Create|Soup("So|
|000032e0| 75 70 22 26 69 26 22 3a | 50 49 45 44 54 53 22 2c |up"&i&":|PIEDTS",|
|000032f0| 20 7b 7d 29 3b 0d 20 20 | 20 20 20 20 66 6f 72 20 | {});.  |    for |
|00003300| 6a 20 3a 3d 20 31 20 74 | 6f 20 52 61 6e 64 6f 6d |j := 1 t|o Random|
|00003310| 28 31 30 30 2c 20 31 30 | 30 30 29 20 64 6f 0d 20 |(100, 10|00) do. |
|00003320| 20 20 20 20 20 20 20 20 | 73 3a 41 64 64 45 6e 74 |        |s:AddEnt|
|00003330| 72 79 28 7b 0d 20 20 20 | 20 20 20 20 20 20 20 20 |ry({.   |        |
|00003340| 20 20 73 74 72 69 6e 67 | 3a 20 47 65 74 52 61 6e |  string|: GetRan|
|00003350| 64 6f 6d 57 6f 72 64 28 | 35 2c 20 31 30 29 20 26 |domWord(|5, 10) &|
|00003360| 26 20 47 65 74 52 61 6e | 64 6f 6d 57 6f 72 64 28 |& GetRan|domWord(|
|00003370| 36 2c 20 31 32 29 2c 0d | 20 20 20 20 20 20 20 20 |6, 12),.|        |
|00003380| 20 20 20 20 20 72 65 61 | 6c 3a 20 52 61 6e 64 6f |     rea|l: Rando|
|00003390| 6d 28 31 30 30 30 29 20 | 2b 20 31 2f 52 61 6e 64 |m(1000) |+ 1/Rand|
|000033a0| 6f 6d 28 31 30 30 30 29 | 2c 0d 20 20 20 20 20 20 |om(1000)|,.      |
|000033b0| 20 20 20 20 20 20 20 69 | 6e 74 65 67 65 72 3a 20 |       i|nteger: |
|000033c0| 52 61 6e 64 6f 6d 28 31 | 30 30 30 30 29 7d 29 3b |Random(1|0000)});|
|000033d0| 0d 20 20 20 65 6e 64 3b | 0d 65 6e 64 20 77 69 74 |.   end;|.end wit|
|000033e0| 68 20 28 29 3b 0d 09 49 | 66 20 79 6f 75 20 77 61 |h ();..I|f you wa|
|000033f0| 6e 74 20 22 72 69 63 68 | 65 72 22 20 73 6f 75 70 |nt "rich|er" soup|
|00003400| 73 20 77 69 74 68 20 6f | 74 68 65 72 20 64 61 74 |s with o|ther dat|
|00003410| 61 20 74 79 70 65 73 2c | 20 20 6c 6f 6f 6b 20 61 |a types,|  look a|
|00003420| 74 20 74 68 65 20 53 79 | 6e 63 20 41 6e 6f 74 68 |t the Sy|nc Anoth|
|00003430| 65 72 20 4f 6e 65 20 73 | 61 6d 70 6c 65 3b 20 69 |er One s|ample; i|
|00003440| 74 20 63 72 65 61 74 65 | 73 20 61 20 72 61 6e 64 |t create|s a rand|
|00003450| 6f 6d 20 66 69 65 6c 64 | 20 6f 66 20 6e 65 61 72 |om field| of near|
|00003460| 6c 79 20 65 76 65 72 79 | 20 64 61 74 61 20 74 79 |ly every| data ty|
|00003470| 70 65 20 74 68 61 74 20 | 69 73 20 75 73 65 64 20 |pe that |is used |
|00003480| 69 6e 20 74 68 65 20 4e | 65 77 74 6f 6e 20 65 6e |in the N|ewton en|
|00003490| 76 69 72 6f 6e 6d 65 6e | 74 2e 0d 09 5f 5f 5f 5f |vironmen|t...____|
|000034a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000034b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000034c0| 5f 5f 5f 5f 5f 5f 5f 0d | 42 65 20 43 61 72 65 66 |_______.|Be Caref|
|000034d0| 75 6c 20 57 68 61 74 20 | 79 6f 75 20 53 74 6f 72 |ul What |you Stor|
|000034e0| 65 20 69 6e 20 53 6f 75 | 70 20 28 31 32 2f 36 2f |e in Sou|p (12/6/|
|000034f0| 39 33 29 20 28 4f 62 73 | 6f 6c 65 74 65 64 20 62 |93) (Obs|oleted b|
|00003500| 79 20 31 2e 30 20 4e 65 | 77 74 6f 6e 20 50 72 6f |y 1.0 Ne|wton Pro|
|00003510| 67 72 61 6d 6d 65 72 27 | 73 20 47 75 69 64 65 20 |grammer'|s Guide |
|00003520| 70 37 2d 32 33 29 0d 09 | 49 74 20 69 73 20 69 6d |p7-23)..|It is im|
|00003530| 70 6f 72 74 61 6e 74 20 | 74 6f 20 6b 6e 6f 77 20 |portant |to know |
|00003540| 77 68 61 74 20 79 6f 75 | 20 73 74 6f 72 65 20 69 |what you| store i|
|00003550| 6e 20 61 20 73 6f 75 70 | 2e 20 41 20 67 6f 6f 64 |n a soup|. A good|
|00003560| 20 65 78 61 6d 70 6c 65 | 20 77 6f 75 6c 64 20 62 | example| would b|
|00003570| 65 20 74 68 65 20 72 65 | 66 65 72 65 6e 63 65 73 |e the re|ferences|
|00003580| 20 79 6f 75 20 67 65 74 | 20 66 72 6f 6d 20 76 61 | you get| from va|
|00003590| 72 69 6f 75 73 20 54 6f | 6f 6c 62 6f 78 20 63 61 |rious To|olbox ca|
|000035a0| 6c 6c 73 2c 20 73 75 63 | 68 20 61 73 20 74 68 65 |lls, suc|h as the|
|000035b0| 20 47 65 74 53 74 6f 72 | 65 73 20 66 75 6e 63 74 | GetStor|es funct|
|000035c0| 69 6f 6e 2e 20 49 66 20 | 79 6f 75 20 73 61 76 65 |ion. If |you save|
|000035d0| 20 74 68 65 20 72 65 66 | 65 72 65 6e 63 65 2c 20 | the ref|erence, |
|000035e0| 69 74 20 77 69 6c 6c 20 | 63 6f 6e 74 61 69 6e 20 |it will |contain |
|000035f0| 5f 70 61 72 65 6e 74 20 | 72 65 66 65 72 65 6e 63 |_parent |referenc|
|00003600| 65 73 2c 20 61 6e 64 20 | 74 68 69 73 20 77 69 6c |es, and |this wil|
|00003610| 6c 20 62 6f 74 68 20 6d | 61 6b 65 20 74 68 65 20 |l both m|ake the |
|00003620| 65 6e 74 72 79 20 71 75 | 69 74 65 20 6c 61 72 67 |entry qu|ite larg|
|00003630| 65 2c 20 61 6e 64 20 77 | 69 6c 6c 20 6d 61 6b 65 |e, and w|ill make|
|00003640| 20 69 74 20 63 6f 6e 74 | 61 69 6e 20 72 65 66 65 | it cont|ain refe|
|00003650| 72 65 6e 63 65 73 20 74 | 6f 20 6f 74 68 65 72 20 |rences t|o other |
|00003660| 6f 75 74 73 69 64 65 20 | 74 68 69 6e 67 73 2e 20 |outside |things. |
|00003670| 53 6f 75 70 20 65 6e 74 | 72 69 65 73 20 73 68 6f |Soup ent|ries sho|
|00003680| 75 6c 64 20 6e 6f 74 20 | 63 6f 6e 74 61 69 6e 20 |uld not |contain |
|00003690| 61 6e 79 20 73 75 63 68 | 20 72 65 66 65 72 65 6e |any such| referen|
|000036a0| 63 65 73 2e 20 54 68 65 | 79 20 73 68 6f 75 6c 64 |ces. The|y should|
|000036b0| 20 62 65 20 73 65 6c 66 | 20 63 6f 6e 74 61 69 6e | be self| contain|
|000036c0| 65 64 2e 0d 09 49 6e 20 | 6f 74 68 65 72 20 63 61 |ed...In |other ca|
|000036d0| 73 65 73 2c 20 61 20 72 | 65 66 65 72 65 6e 63 65 |ses, a r|eference|
|000036e0| 73 20 6d 61 79 20 62 65 | 20 70 6f 69 6e 74 65 72 |s may be| pointer|
|000036f0| 73 20 74 6f 20 64 61 74 | 61 20 6f 75 74 73 69 64 |s to dat|a outsid|
|00003700| 65 20 74 68 65 20 4e 65 | 77 74 6f 6e 53 63 72 69 |e the Ne|wtonScri|
|00003710| 70 74 20 77 6f 72 6c 64 | 20 28 69 6e 20 74 68 65 |pt world| (in the|
|00003720| 20 63 61 73 65 20 6f 66 | 20 72 65 63 6f 67 6e 69 | case of| recogni|
|00003730| 74 69 6f 6e 20 75 6e 69 | 74 73 20 6f 72 20 76 69 |tion uni|ts or vi|
|00003740| 65 77 43 4f 62 6a 65 63 | 74 73 2c 20 66 6f 72 20 |ewCObjec|ts, for |
|00003750| 69 6e 73 74 61 6e 63 65 | 29 2e 20 59 6f 75 20 63 |instance|). You c|
|00003760| 61 6e 27 74 20 73 61 76 | 65 20 74 68 65 73 65 20 |an't sav|e these |
|00003770| 62 65 63 61 75 73 65 20 | 74 68 65 79 20 6f 6e 6c |because |they onl|
|00003780| 79 20 6d 61 6b 65 20 73 | 65 6e 73 65 20 64 75 72 |y make s|ense dur|
|00003790| 69 6e 67 20 61 20 70 61 | 72 74 69 63 75 6c 61 72 |ing a pa|rticular|
|000037a0| 20 74 69 6d 65 20 70 65 | 72 69 6f 64 2e 0d 09 5f | time pe|riod..._|
|000037b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000037c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000037d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 49 66 20 45 6e |________|__.If En|
|000037e0| 74 72 79 43 68 61 6e 67 | 65 20 66 61 69 6c 73 2c |tryChang|e fails,|
|000037f0| 20 77 68 61 74 20 68 61 | 70 70 65 6e 73 3f 20 28 | what ha|ppens? (|
|00003800| 31 32 2f 39 2f 39 33 29 | 0d 51 3a 09 53 75 70 70 |12/9/93)|.Q:.Supp|
|00003810| 6f 73 65 20 49 20 61 64 | 64 20 65 6e 74 72 69 65 |ose I ad|d entrie|
|00003820| 73 20 69 6e 20 61 20 73 | 6f 75 70 20 61 6e 64 20 |s in a s|oup and |
|00003830| 63 61 6c 6c 20 45 6e 74 | 72 79 43 68 61 6e 67 65 |call Ent|ryChange|
|00003840| 2c 20 61 6e 64 20 69 74 | 20 74 75 72 6e 73 20 6f |, and it| turns o|
|00003850| 75 74 20 74 68 65 72 65 | 27 73 20 6e 6f 20 73 70 |ut there|'s no sp|
|00003860| 61 63 65 20 69 6e 20 74 | 68 65 20 73 74 6f 72 65 |ace in t|he store|
|00003870| 2c 20 61 6e 64 20 61 6e | 20 65 78 63 65 70 74 69 |, and an| excepti|
|00003880| 6f 6e 20 69 73 20 74 68 | 72 6f 77 6e 2e 20 49 66 |on is th|rown. If|
|00003890| 20 49 20 63 61 6c 6c 20 | 45 6e 74 72 79 55 6e 64 | I call |EntryUnd|
|000038a0| 6f 43 68 61 6e 67 65 73 | 2c 20 64 6f 20 49 20 67 |oChanges|, do I g|
|000038b0| 65 74 20 74 68 65 20 6f | 72 69 67 69 6e 61 6c 2c |et the o|riginal,|
|000038c0| 20 75 6e 6d 6f 64 69 66 | 69 65 64 20 65 6e 74 72 | unmodif|ied entr|
|000038d0| 79 20 62 61 63 6b 3f 0d | 41 3a 09 59 65 73 2e 20 |y back?.|A:.Yes. |
|000038e0| 20 54 68 65 20 65 6e 74 | 72 79 20 77 69 6c 6c 20 | The ent|ry will |
|000038f0| 62 65 20 4f 4b 20 62 65 | 63 61 75 73 65 20 73 6f |be OK be|cause so|
|00003900| 75 70 73 20 61 72 65 20 | 74 72 61 6e 73 61 63 74 |ups are |transact|
|00003910| 69 6f 6e 20 62 61 73 65 | 64 2c 20 61 6e 64 20 74 |ion base|d, and t|
|00003920| 68 65 20 22 75 70 64 61 | 74 65 22 20 74 72 61 6e |he "upda|te" tran|
|00003930| 73 61 63 74 69 6f 6e 20 | 77 61 73 20 69 6e 63 6f |saction |was inco|
|00003940| 6d 70 6c 65 74 65 2e 20 | 20 45 6e 74 72 79 55 6e |mplete. | EntryUn|
|00003950| 64 6f 43 68 61 6e 67 65 | 73 20 77 69 6c 6c 20 72 |doChange|s will r|
|00003960| 65 76 65 72 74 20 74 68 | 65 20 6c 6f 63 61 6c 20 |evert th|e local |
|00003970| 63 6f 70 79 20 74 6f 20 | 74 68 65 20 73 61 6d 65 |copy to |the same|
|00003980| 20 64 61 74 61 20 73 74 | 6f 72 65 64 20 69 6e 20 | data st|ored in |
|00003990| 74 68 65 20 73 6f 75 70 | 2c 20 77 68 69 63 68 20 |the soup|, which |
|000039a0| 68 61 73 20 6e 6f 74 20 | 62 65 65 6e 20 6d 6f 64 |has not |been mod|
|000039b0| 69 66 69 65 64 2e 0d 09 | 5f 5f 5f 5f 5f 5f 5f 5f |ified...|________|
|000039c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000039d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000039e0| 5f 5f 5f 0d 50 65 72 66 | 6f 72 6d 61 6e 63 65 3a |___.Perf|ormance:|
|000039f0| 20 43 75 72 73 6f 72 73 | 20 61 6e 64 20 45 6e 74 | Cursors| and Ent|
|00003a00| 72 79 52 65 6d 6f 76 65 | 46 72 6f 6d 53 6f 75 70 |ryRemove|FromSoup|
|00003a10| 20 28 31 32 2f 31 31 2f | 39 33 29 0d 09 45 6e 74 | (12/11/|93)..Ent|
|00003a20| 72 79 52 65 6d 6f 76 65 | 46 72 6f 6d 53 6f 75 70 |ryRemove|FromSoup|
|00003a30| 20 68 61 73 20 61 20 73 | 69 64 65 2d 65 66 66 65 | has a s|ide-effe|
|00003a40| 63 74 20 6f 66 20 63 61 | 6c 6c 69 6e 67 20 4d 6f |ct of ca|lling Mo|
|00003a50| 76 65 28 31 29 20 6f 6e | 20 61 6e 79 20 63 75 72 |ve(1) on| any cur|
|00003a60| 73 6f 72 73 20 70 6f 69 | 6e 74 69 6e 67 20 74 6f |sors poi|nting to|
|00003a70| 20 74 68 61 74 20 65 6e | 74 72 79 2e 20 20 46 6f | that en|try.  Fo|
|00003a80| 72 20 70 6f 6f 72 6c 79 | 20 77 72 69 74 74 65 6e |r poorly| written|
|00003a90| 20 71 75 65 72 69 65 73 | 2c 20 74 68 69 73 20 63 | queries|, this c|
|00003aa0| 61 6e 20 63 61 75 73 65 | 20 76 61 6c 69 64 54 65 |an cause| validTe|
|00003ab0| 73 74 20 74 6f 20 62 65 | 20 63 61 6c 6c 65 64 20 |st to be| called |
|00003ac0| 6f 6e 20 61 6c 6c 20 72 | 65 6d 61 69 6e 69 6e 67 |on all r|emaining|
|00003ad0| 20 69 74 65 6d 73 20 69 | 6e 20 74 68 65 20 73 6f | items i|n the so|
|00003ae0| 75 70 2e 20 48 65 72 65 | 27 73 20 61 6e 20 65 78 |up. Here|'s an ex|
|00003af0| 61 6d 70 6c 65 20 6f 66 | 20 61 20 70 6f 73 73 69 |ample of| a possi|
|00003b00| 62 6c 65 20 73 63 65 6e | 61 72 69 6f 3a 0d 20 6c |ble scen|ario:. l|
|00003b10| 6f 63 61 6c 20 63 20 3a | 3d 20 71 75 65 72 79 28 |ocal c :|= query(|
|00003b20| 47 65 74 53 74 6f 72 65 | 73 28 29 5b 30 5d 3a 47 |GetStore|s()[0]:G|
|00003b30| 65 74 53 6f 75 70 28 22 | 73 6f 75 70 4e 61 6d 65 |etSoup("|soupName|
|00003b40| 22 29 2c 20 7b 0d 20 20 | 20 20 20 20 20 20 74 79 |"), {.  |      ty|
|00003b50| 70 65 3a 20 27 69 6e 64 | 65 78 2c 0d 20 20 20 20 |pe: 'ind|ex,.    |
|00003b60| 20 20 20 20 69 6e 64 65 | 78 70 61 74 68 3a 20 27 |    inde|xpath: '|
|00003b70| 73 6f 6d 65 50 61 74 68 | 2c 0d 20 20 20 20 20 20 |somePath|,.      |
|00003b80| 20 20 73 74 61 72 74 4b | 65 79 3a 20 78 53 79 6d |  startK|ey: xSym|
|00003b90| 62 6f 6c 2c 0d 20 20 20 | 20 20 20 20 20 76 61 6c |bol,.   |     val|
|00003ba0| 69 64 54 65 73 74 3a 20 | 66 75 6e 63 28 69 74 65 |idTest: |func(ite|
|00003bb0| 6d 29 20 69 74 65 6d 2e | 69 64 20 3d 20 6d 73 67 |m) item.|id = msg|
|00003bc0| 2e 69 64 2c 0d 20 20 20 | 20 20 20 20 7d 29 3b 0d |.id,.   |    });.|
|00003bd0| 20 20 20 20 20 20 20 20 | 0d 20 6c 6f 63 61 6c 20 |        |. local |
|00003be0| 65 20 3a 3d 20 63 3a 65 | 6e 74 72 79 28 29 3b 0d |e := c:e|ntry();.|
|00003bf0| 20 69 66 20 28 65 29 20 | 74 68 65 6e 0d 20 20 20 | if (e) |then.   |
|00003c00| 20 62 65 67 69 6e 0d 20 | 20 20 20 20 20 45 6e 74 | begin. |     Ent|
|00003c10| 72 79 52 65 6d 6f 76 65 | 46 72 6f 6d 53 6f 75 70 |ryRemove|FromSoup|
|00003c20| 28 65 29 3b 0d 20 20 20 | 20 65 6e 64 3b 0d 09 57 |(e);.   | end;..W|
|00003c30| 68 65 6e 20 45 6e 74 72 | 79 52 65 6d 6f 76 65 46 |hen Entr|yRemoveF|
|00003c40| 72 6f 6d 53 6f 75 70 28 | 65 29 20 69 73 20 65 78 |romSoup(|e) is ex|
|00003c50| 65 63 75 74 65 64 2c 20 | 74 68 65 20 63 75 72 73 |ecuted, |the curs|
|00003c60| 6f 72 20 63 20 69 73 20 | 22 70 6f 69 6e 74 69 6e |or c is |"pointin|
|00003c70| 67 20 61 74 22 20 74 68 | 61 74 20 73 6f 75 70 20 |g at" th|at soup |
|00003c80| 65 6e 74 72 79 2e 20 20 | 49 6e 20 74 68 65 20 70 |entry.  |In the p|
|00003c90| 72 6f 63 65 73 73 20 6f | 66 20 64 65 6c 65 74 69 |rocess o|f deleti|
|00003ca0| 6e 67 20 69 74 2c 20 74 | 68 65 20 73 79 73 74 65 |ng it, t|he syste|
|00003cb0| 6d 20 6d 75 73 74 20 66 | 69 67 75 72 65 20 6f 75 |m must f|igure ou|
|00003cc0| 74 20 77 68 69 63 68 20 | 65 6e 74 72 79 20 74 68 |t which |entry th|
|00003cd0| 65 20 63 75 72 73 6f 72 | 20 73 68 6f 75 6c 64 20 |e cursor| should |
|00003ce0| 70 6f 69 6e 74 20 74 6f | 20 6e 65 78 74 20 2c 20 |point to| next , |
|00003cf0| 73 6f 20 69 74 20 64 6f | 65 73 20 74 68 65 20 65 |so it do|es the e|
|00003d00| 71 75 69 76 61 6c 65 6e | 74 20 6f 66 20 63 3a 4d |quivalen|t of c:M|
|00003d10| 6f 76 65 28 31 29 2e 20 | 20 42 65 63 61 75 73 65 |ove(1). | Because|
|00003d20| 20 6f 66 20 74 68 69 73 | 2c 20 74 68 65 20 76 61 | of this|, the va|
|00003d30| 6c 69 64 54 65 73 74 20 | 66 75 6e 63 74 69 6f 6e |lidTest |function|
|00003d40| 20 77 69 6c 6c 20 62 65 | 20 63 61 6c 6c 65 64 20 | will be| called |
|00003d50| 75 6e 74 69 6c 20 61 20 | 6e 65 77 20 22 76 61 6c |until a |new "val|
|00003d60| 69 64 22 20 65 6e 74 72 | 79 20 69 73 20 66 6f 75 |id" entr|y is fou|
|00003d70| 6e 64 2c 20 77 68 69 63 | 68 20 63 6f 75 6c 64 20 |nd, whic|h could |
|00003d80| 62 65 20 73 6c 6f 77 2e | 0d 09 57 68 65 6e 20 70 |be slow.|..When p|
|00003d90| 6f 73 73 69 62 6c 65 2c | 20 61 6c 77 61 79 73 20 |ossible,| always |
|00003da0| 75 73 65 20 61 6e 20 65 | 6e 64 54 65 73 74 20 69 |use an e|ndTest i|
|00003db0| 6e 20 79 6f 75 72 20 71 | 75 65 72 69 65 73 20 74 |n your q|ueries t|
|00003dc0| 6f 20 73 74 6f 70 20 74 | 68 65 20 63 75 72 73 6f |o stop t|he curso|
|00003dd0| 72 73 20 61 73 20 73 6f | 6f 6e 20 61 73 20 70 6f |rs as so|on as po|
|00003de0| 73 73 69 62 6c 65 2e 20 | 20 41 76 6f 69 64 69 6e |ssible. | Avoidin|
|00003df0| 67 20 6b 65 65 70 69 6e | 67 20 61 72 6f 75 6e 64 |g keepin|g around|
|00003e00| 20 75 6e 75 73 65 64 20 | 63 75 72 73 6f 72 73 20 | unused |cursors |
|00003e10| 77 69 6c 6c 20 61 6c 73 | 6f 20 68 65 6c 70 2e 0d |will als|o help..|
|00003e20| 09 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |._______|________|
|00003e30| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00003e40| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 41 6c 77 |________|____.Alw|
|00003e50| 61 79 73 20 75 73 65 20 | 43 6f 6e 73 74 61 6e 74 |ays use |Constant|
|00003e60| 73 20 69 6e 73 74 65 61 | 64 20 6f 66 20 53 74 72 |s instea|d of Str|
|00003e70| 69 6e 67 73 20 66 6f 72 | 20 42 75 69 6c 74 2d 69 |ings for| Built-i|
|00003e80| 6e 20 53 6f 75 70 73 20 | 28 31 32 2f 31 32 2f 39 |n Soups |(12/12/9|
|00003e90| 33 29 20 28 4f 62 73 6f | 6c 65 74 65 64 20 62 79 |3) (Obso|leted by|
|00003ea0| 20 31 2e 30 20 4e 65 77 | 74 6f 6e 20 50 72 6f 67 | 1.0 New|ton Prog|
|00003eb0| 72 61 6d 6d 65 72 27 73 | 20 47 75 69 64 65 20 70 |rammer's| Guide p|
|00003ec0| 37 2d 32 33 29 0d 09 41 | 6c 77 61 79 73 20 75 73 |7-23)..A|lways us|
|00003ed0| 65 20 64 65 66 69 6e 65 | 64 20 63 6f 6e 73 74 61 |e define|d consta|
|00003ee0| 6e 74 73 20 69 6e 73 74 | 65 61 64 20 6f 66 20 73 |nts inst|ead of s|
|00003ef0| 74 72 69 6e 67 20 6e 61 | 6d 65 73 20 66 6f 72 20 |tring na|mes for |
|00003f00| 62 75 69 6c 74 2d 69 6e | 20 73 6f 75 70 73 21 20 |built-in| soups! |
|00003f10| 54 68 69 73 20 69 73 20 | 70 72 65 66 65 72 61 62 |This is |preferab|
|00003f20| 6c 65 20 62 65 63 61 75 | 73 65 20 69 74 20 67 75 |le becau|se it gu|
|00003f30| 61 72 61 6e 74 65 65 73 | 20 79 6f 75 72 20 73 6f |arantees| your so|
|00003f40| 66 74 77 61 72 65 20 74 | 6f 20 72 75 6e 20 6f 6e |ftware t|o run on|
|00003f50| 20 6f 74 68 65 72 20 4e | 65 77 74 6f 6e 20 64 65 | other N|ewton de|
|00003f60| 76 69 63 65 73 20 77 68 | 65 72 65 20 74 68 65 20 |vices wh|ere the |
|00003f70| 73 6f 75 70 20 6e 61 6d | 65 73 20 6d 61 79 20 68 |soup nam|es may h|
|00003f80| 61 76 65 20 63 68 61 6e | 67 65 64 2e 20 20 49 74 |ave chan|ged.  It|
|00003f90| 20 61 6c 73 6f 20 73 61 | 76 65 73 20 61 20 66 65 | also sa|ves a fe|
|00003fa0| 77 20 62 79 74 65 73 20 | 69 6e 20 79 6f 75 72 20 |w bytes |in your |
|00003fb0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 2e 20 0d 09 48 |applicat|ion. ..H|
|00003fc0| 65 72 65 27 73 20 61 20 | 6c 69 73 74 20 6f 66 20 |ere's a |list of |
|00003fd0| 74 68 65 20 63 75 72 72 | 65 6e 74 6c 79 20 61 76 |the curr|ently av|
|00003fe0| 61 69 6c 61 62 6c 65 20 | 20 62 75 69 6c 74 2d 69 |ailable | built-i|
|00003ff0| 6e 20 73 6f 75 70 20 63 | 6f 6e 73 74 61 6e 74 73 |n soup c|onstants|
|00004000| 3a 0d 52 4f 4d 5f 63 61 | 6c 65 6e 64 61 72 73 6f |:.ROM_ca|lendarso|
|00004010| 75 70 6e 61 6d 65 09 09 | 0d 52 4f 4d 5f 63 61 72 |upname..|.ROM_car|
|00004020| 64 66 69 6c 65 73 6f 75 | 70 6e 61 6d 65 0d 52 4f |dfilesou|pname.RO|
|00004030| 4d 5f 69 6e 62 6f 78 73 | 6f 75 70 6e 61 6d 65 0d |M_inboxs|oupname.|
|00004040| 52 4f 4d 5f 6f 75 74 62 | 6f 78 73 6f 75 70 6e 61 |ROM_outb|oxsoupna|
|00004050| 6d 65 0d 52 4f 4d 5f 70 | 61 70 65 72 72 6f 6c 6c |me.ROM_p|aperroll|
|00004060| 73 6f 75 70 6e 61 6d 65 | 0d 52 4f 4d 5f 73 79 73 |soupname|.ROM_sys|
|00004070| 74 65 6d 73 6f 75 70 6e | 61 6d 65 0d 52 4f 4d 5f |temsoupn|ame.ROM_|
|00004080| 74 6f 64 6f 73 6f 75 70 | 6e 61 6d 65 0d 09 5f 5f |todosoup|name..__|
|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 0d 44 6f 20 4e 6f 74 |________|_.Do Not|
|000040c0| 20 43 6c 6f 6e 65 20 43 | 75 72 73 6f 72 73 20 77 | Clone C|ursors w|
|000040d0| 69 74 68 20 43 6c 6f 6e | 65 2f 54 6f 74 61 6c 43 |ith Clon|e/TotalC|
|000040e0| 6c 6f 6e 65 2f 44 65 65 | 70 43 6c 6f 6e 65 20 28 |lone/Dee|pClone (|
|000040f0| 31 32 2f 31 39 2f 39 33 | 29 20 20 28 4f 62 73 6f |12/19/93|)  (Obso|
|00004100| 6c 65 74 65 64 20 62 79 | 20 31 2e 30 20 4e 65 77 |leted by| 1.0 New|
|00004110| 74 6f 6e 20 50 72 6f 67 | 72 61 6d 6d 65 72 27 73 |ton Prog|rammer's|
|00004120| 20 47 75 69 64 65 20 70 | 37 2d 35 30 29 0d 09 44 | Guide p|7-50)..D|
|00004130| 6f 20 6e 6f 74 20 63 6c | 6f 6e 65 20 74 68 65 20 |o not cl|one the |
|00004140| 63 75 72 73 6f 72 20 75 | 73 69 6e 67 20 74 68 65 |cursor u|sing the|
|00004150| 20 43 6c 6f 6e 65 20 66 | 75 6e 63 74 69 6f 6e 73 | Clone f|unctions|
|00004160| 20 28 43 6c 6f 6e 65 2c | 20 54 6f 74 61 6c 43 6c | (Clone,| TotalCl|
|00004170| 6f 6e 65 2c 20 44 65 65 | 70 43 6c 6f 6e 65 29 2e |one, Dee|pClone).|
|00004180| 20 55 73 65 20 74 68 65 | 20 63 75 72 73 6f 72 20 | Use the| cursor |
|00004190| 6d 65 74 68 6f 64 20 63 | 61 6c 6c 65 64 20 63 75 |method c|alled cu|
|000041a0| 72 73 6f 72 3a 43 6c 6f | 6e 65 2e 20 54 68 69 73 |rsor:Clo|ne. This|
|000041b0| 20 77 69 6c 6c 20 64 6f | 20 74 68 65 20 72 69 67 | will do| the rig|
|000041c0| 68 74 20 74 68 69 6e 67 | 2e 20 43 75 72 73 6f 72 |ht thing|. Cursor|
|000041d0| 73 20 61 72 65 20 6e 6f | 74 20 6c 69 6b 65 20 6e |s are no|t like n|
|000041e0| 6f 72 6d 61 6c 20 66 72 | 61 6d 65 73 2c 20 74 68 |ormal fr|ames, th|
|000041f0| 65 79 20 61 72 65 20 73 | 70 65 63 69 61 6c 2e 0d |ey are s|pecial..|
|00004200| 09 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |._______|________|
|00004210| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004220| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 57 68 61 |________|____.Wha|
|00004230| 74 20 53 74 6f 72 65 20 | 69 73 20 52 65 6d 6f 76 |t Store |is Remov|
|00004240| 65 64 3f 20 28 31 32 2f | 31 39 2f 39 33 29 0d 51 |ed? (12/|19/93).Q|
|00004250| 3a 09 49 73 20 74 68 65 | 72 65 20 61 20 77 61 79 |:.Is the|re a way|
|00004260| 20 69 6e 20 6d 79 20 52 | 65 6d 6f 76 65 53 63 72 | in my R|emoveScr|
|00004270| 69 70 74 20 74 6f 20 66 | 69 6e 64 20 6f 75 74 20 |ipt to f|ind out |
|00004280| 77 68 69 63 68 20 73 74 | 6f 72 65 20 69 73 20 62 |which st|ore is b|
|00004290| 65 69 6e 67 20 72 65 6d | 6f 76 65 64 20 73 6f 20 |eing rem|oved so |
|000042a0| 74 68 61 74 20 49 20 64 | 6f 6e 27 74 20 74 72 79 |that I d|on't try|
|000042b0| 20 74 6f 20 61 63 63 65 | 73 73 20 61 6e 79 74 68 | to acce|ss anyth|
|000042c0| 69 6e 67 20 6f 6e 20 69 | 74 3f 20 0d 41 3a 09 43 |ing on i|t? .A:.C|
|000042d0| 75 72 72 65 6e 74 6c 79 | 20 74 68 65 72 65 20 69 |urrently| there i|
|000042e0| 73 20 6e 6f 20 67 6f 6f | 64 20 77 61 79 20 74 6f |s no goo|d way to|
|000042f0| 20 64 65 74 65 72 6d 69 | 6e 65 20 77 68 69 63 68 | determi|ne which|
|00004300| 20 73 74 6f 72 65 20 69 | 73 20 62 65 69 6e 67 20 | store i|s being |
|00004310| 72 65 6d 6f 76 65 64 2e | 20 45 6e 67 69 6e 65 65 |removed.| Enginee|
|00004320| 72 69 6e 67 20 69 73 20 | 77 6f 72 6b 69 6e 67 20 |ring is |working |
|00004330| 6f 6e 20 61 20 6e 65 77 | 20 77 61 79 20 6f 66 20 |on a new| way of |
|00004340| 74 72 65 61 74 69 6e 67 | 20 73 74 6f 72 65 73 20 |treating| stores |
|00004350| 61 6e 64 20 73 6f 75 70 | 73 2e 20 53 74 61 79 20 |and soup|s. Stay |
|00004360| 74 75 6e 65 64 20 66 6f | 72 20 6d 6f 72 65 20 69 |tuned fo|r more i|
|00004370| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 6c 61 74 65 72 |nformati|on later|
|00004380| 2e 0d 09 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..._____|________|
|00004390| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000043a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 0d 53 |________|______.S|
|000043b0| 74 6f 72 65 3a 20 47 65 | 74 49 6e 66 6f 2c 20 53 |tore: Ge|tInfo, S|
|000043c0| 65 74 49 6e 66 6f 2c 20 | 47 65 74 41 6c 6c 49 6e |etInfo, |GetAllIn|
|000043d0| 66 6f 20 46 75 6e 63 74 | 69 6f 6e 73 20 28 31 32 |fo Funct|ions (12|
|000043e0| 2f 31 39 2f 39 33 29 20 | 28 4f 62 73 6f 6c 65 74 |/19/93) |(Obsolet|
|000043f0| 65 64 20 62 79 20 31 2e | 30 20 4e 65 77 74 6f 6e |ed by 1.|0 Newton|
|00004400| 20 50 72 6f 67 72 61 6d | 6d 65 72 27 73 20 47 75 | Program|mer's Gu|
|00004410| 69 64 65 20 70 37 2d 31 | 32 29 0d 73 74 6f 72 65 |ide p7-1|2).store|
|00004420| 3a 47 65 74 49 6e 66 6f | 28 73 79 6d 62 6f 6c 29 |:GetInfo|(symbol)|
|00004430| 0d 09 54 68 69 73 20 6d | 65 74 68 6f 64 20 74 61 |..This m|ethod ta|
|00004440| 6b 65 73 20 61 20 73 79 | 6d 62 6f 6c 20 74 68 61 |kes a sy|mbol tha|
|00004450| 74 20 77 69 6c 6c 20 73 | 70 65 63 69 66 79 20 61 |t will s|pecify a|
|00004460| 20 73 70 65 63 69 66 69 | 63 20 73 79 6d 62 6f 6c | specifi|c symbol|
|00004470| 20 66 72 61 6d 65 20 69 | 6e 20 74 68 65 20 73 74 | frame i|n the st|
|00004480| 6f 72 65 2c 20 61 6e 64 | 20 77 69 6c 6c 20 72 65 |ore, and| will re|
|00004490| 74 75 72 6e 20 74 68 65 | 20 76 61 6c 75 65 20 66 |turn the| value f|
|000044a0| 6f 72 20 74 68 69 73 20 | 73 79 6d 62 6f 6c 2e 0d |or this |symbol..|
|000044b0| 73 74 6f 72 65 3a 53 65 | 74 49 6e 66 6f 28 73 79 |store:Se|tInfo(sy|
|000044c0| 6d 62 6f 6c 2c 20 76 61 | 6c 75 65 29 0d 09 54 68 |mbol, va|lue)..Th|
|000044d0| 69 73 20 6d 65 74 68 6f | 64 20 74 61 6b 65 73 20 |is metho|d takes |
|000044e0| 61 20 73 79 6d 62 6f 6c | 20 61 6e 64 20 61 20 76 |a symbol| and a v|
|000044f0| 61 6c 75 65 2c 20 61 6e | 64 20 63 72 65 61 74 65 |alue, an|d create|
|00004500| 73 20 61 20 73 6c 6f 74 | 20 69 6e 73 69 64 65 20 |s a slot| inside |
|00004510| 74 68 65 20 69 6e 66 6f | 20 66 72 61 6d 65 20 6f |the info| frame o|
|00004520| 66 20 74 68 65 20 53 74 | 6f 72 65 2e 20 0d 73 74 |f the St|ore. .st|
|00004530| 6f 72 65 3a 47 65 74 41 | 6c 6c 49 6e 66 6f 28 29 |ore:GetA|llInfo()|
|00004540| 0d 09 54 68 69 73 20 66 | 75 6e 63 74 69 6f 6e 20 |..This f|unction |
|00004550| 77 69 6c 6c 20 72 65 74 | 75 72 6e 20 61 6c 6c 20 |will ret|urn all |
|00004560| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 73 74 6f 72 |informat|ion stor|
|00004570| 65 64 20 69 6e 20 74 68 | 65 20 69 6e 66 6f 20 66 |ed in th|e info f|
|00004580| 72 61 6d 65 20 6f 66 20 | 74 68 65 20 53 74 6f 72 |rame of |the Stor|
|00004590| 65 2e 0d 09 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |e...____|________|
|000045a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000045b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|000045c0| 53 74 6f 72 65 3a 53 65 | 74 49 6e 66 6f 20 20 61 |Store:Se|tInfo  a|
|000045d0| 6e 64 20 53 6f 75 70 3a | 53 65 74 49 6e 66 6f 20 |nd Soup:|SetInfo |
|000045e0| 28 33 2f 39 2f 39 34 29 | 0d 09 20 59 6f 75 20 6e |(3/9/94)|.. You n|
|000045f0| 65 65 64 20 74 6f 20 75 | 73 65 20 45 6e 73 75 72 |eed to u|se Ensur|
|00004600| 65 49 6e 74 65 72 6e 61 | 6c 20 6f 6e 20 62 6f 74 |eInterna|l on bot|
|00004610| 68 20 61 72 67 75 6d 65 | 6e 74 73 20 74 6f 20 53 |h argume|nts to S|
|00004620| 65 74 49 6e 66 6f 20 28 | 61 74 20 6c 65 61 73 74 |etInfo (|at least|
|00004630| 20 61 72 67 73 20 74 68 | 61 74 20 61 72 65 6e 27 | args th|at aren'|
|00004640| 74 20 69 6d 6d 65 64 69 | 61 74 65 73 29 2e 20 54 |t immedi|ates). T|
|00004650| 68 69 73 20 61 70 70 6c | 69 65 73 20 74 6f 20 62 |his appl|ies to b|
|00004660| 6f 74 68 20 74 68 65 20 | 73 6f 75 70 20 6d 65 74 |oth the |soup met|
|00004670| 68 6f 64 20 61 6e 64 20 | 74 68 65 20 73 74 6f 72 |hod and |the stor|
|00004680| 65 20 6d 65 74 68 6f 64 | 2e 0d 09 45 78 61 6d 70 |e method|...Examp|
|00004690| 6c 65 3a 0d 73 74 6f 72 | 65 3a 53 65 74 49 6e 66 |le:.stor|e:SetInf|
|000046a0| 6f 28 45 6e 73 75 72 65 | 49 6e 74 65 72 6e 61 6c |o(Ensure|Internal|
|000046b0| 28 27 70 69 53 79 6d 62 | 6f 6c 29 2c 20 45 6e 73 |('piSymb|ol), Ens|
|000046c0| 75 72 65 49 6e 74 65 72 | 6e 61 6c 28 33 2e 31 34 |ureInter|nal(3.14|
|000046d0| 31 35 29 29 3b 0d 09 5f | 5f 5f 5f 5f 5f 5f 5f 5f |15));.._|________|
|000046e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000046f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004700| 5f 5f 0d 4d 61 67 69 63 | 20 50 6f 69 6e 74 65 72 |__.Magic| Pointer|
|00004710| 73 20 69 6e 20 73 6f 75 | 70 73 20 28 33 2f 31 30 |s in sou|ps (3/10|
|00004720| 2f 39 34 29 0d 09 52 65 | 6c 61 74 65 64 20 74 6f |/94)..Re|lated to|
|00004730| 20 74 68 65 20 70 72 65 | 76 69 6f 75 73 20 74 6f | the pre|vious to|
|00004740| 70 69 63 2c 20 79 6f 75 | 20 73 68 6f 75 6c 64 20 |pic, you| should |
|00004750| 62 65 20 63 61 72 65 66 | 75 6c 20 6e 6f 74 20 74 |be caref|ul not t|
|00004760| 6f 20 74 72 79 20 74 6f | 20 70 75 74 20 6d 61 67 |o try to| put mag|
|00004770| 69 63 20 70 6f 69 6e 74 | 65 72 73 20 28 66 6f 72 |ic point|ers (for|
|00004780| 20 65 78 61 6d 70 6c 65 | 2c 20 52 4f 4d 5f 66 6f | example|, ROM_fo|
|00004790| 6e 74 73 79 73 74 65 6d | 31 30 29 20 69 6e 74 6f |ntsystem|10) into|
|000047a0| 20 73 6f 75 70 73 2e 20 | 59 6f 75 20 63 61 6e 27 | soups. |You can'|
|000047b0| 74 20 61 63 74 75 61 6c | 6c 79 20 70 75 74 20 61 |t actual|ly put a|
|000047c0| 20 6d 61 67 69 63 20 70 | 6f 69 6e 74 65 72 20 69 | magic p|ointer i|
|000047d0| 6e 74 6f 20 61 20 73 6f | 75 70 2e 20 49 66 20 79 |nto a so|up. If y|
|000047e0| 6f 75 20 74 72 79 2c 20 | 74 68 65 20 6d 61 67 69 |ou try, |the magi|
|000047f0| 63 20 70 6f 69 6e 74 65 | 72 20 69 73 20 66 6f 6c |c pointe|r is fol|
|00004800| 6c 6f 77 65 64 20 62 65 | 66 6f 72 65 20 62 65 69 |lowed be|fore bei|
|00004810| 6e 67 20 63 6f 70 69 65 | 64 20 69 6e 74 6f 20 74 |ng copie|d into t|
|00004820| 68 65 20 73 6f 75 70 2e | 20 48 6f 77 65 76 65 72 |he soup.| However|
|00004830| 2c 20 74 68 65 20 52 41 | 4d 2d 62 61 73 65 64 20 |, the RA|M-based |
|00004840| 66 72 61 6d 65 20 20 66 | 6f 72 20 61 20 73 6f 75 |frame  f|or a sou|
|00004850| 70 20 65 6e 74 72 79 20 | 28 6f 72 20 73 6f 75 70 |p entry |(or soup|
|00004860| 20 69 6e 66 6f 20 6f 72 | 20 73 74 6f 72 65 20 69 | info or| store i|
|00004870| 6e 66 6f 29 20 77 69 6c | 6c 20 73 74 69 6c 6c 20 |nfo) wil|l still |
|00004880| 68 61 76 65 20 61 20 6d | 61 67 69 63 20 70 6f 69 |have a m|agic poi|
|00004890| 6e 74 65 72 20 69 6e 20 | 69 74 2e 20 20 49 66 20 |nter in |it.  If |
|000048a0| 61 74 20 74 68 69 73 20 | 70 6f 69 6e 74 20 79 6f |at this |point yo|
|000048b0| 75 20 74 72 79 20 74 6f | 20 73 79 6e 63 20 75 73 |u try to| sync us|
|000048c0| 69 6e 67 20 4e 65 77 74 | 6f 6e 20 43 6f 6e 6e 65 |ing Newt|on Conne|
|000048d0| 63 74 69 6f 6e 2c 20 79 | 6f 75 20 6d 61 79 20 67 |ction, y|ou may g|
|000048e0| 65 74 20 61 20 20 2d 34 | 38 32 30 31 20 65 72 72 |et a  -4|8201 err|
|000048f0| 6f 72 20 20 66 72 6f 6d | 20 74 68 65 20 43 6f 6e |or  from| the Con|
|00004900| 6e 65 63 74 69 6f 6e 20 | 73 6f 66 74 77 61 72 65 |nection |software|
|00004910| 20 28 64 65 70 65 6e 64 | 69 6e 67 20 6f 6e 20 74 | (depend|ing on t|
|00004920| 68 65 20 20 4e 65 77 74 | 6f 6e 20 52 4f 4d 29 2e |he  Newt|on ROM).|
|00004930| 0d 09 59 6f 75 20 63 61 | 6e 20 64 65 74 65 63 74 |..You ca|n detect|
|00004940| 20 69 66 20 73 6f 6d 65 | 74 68 69 6e 67 20 69 73 | if some|thing is|
|00004950| 20 61 20 6d 61 67 69 63 | 20 70 6f 69 6e 74 65 72 | a magic| pointer|
|00004960| 20 75 73 69 6e 67 20 74 | 68 65 20 66 75 6e 63 74 | using t|he funct|
|00004970| 69 6f 6e 20 49 73 4d 61 | 67 69 63 50 74 72 2e 20 |ion IsMa|gicPtr. |
|00004980| 49 66 20 79 6f 75 20 43 | 6c 6f 6e 65 20 61 20 6d |If you C|lone a m|
|00004990| 61 67 69 63 20 70 6f 69 | 6e 74 65 72 2c 20 79 6f |agic poi|nter, yo|
|000049a0| 75 20 67 65 74 20 62 61 | 63 6b 20 61 20 63 6f 70 |u get ba|ck a cop|
|000049b0| 79 20 6f 66 20 74 68 65 | 20 6f 62 6a 65 63 74 2c |y of the| object,|
|000049c0| 20 6e 6f 74 20 61 20 6d | 61 67 69 63 20 70 6f 69 | not a m|agic poi|
|000049d0| 6e 74 65 72 2e 20 54 68 | 75 73 20 79 6f 75 20 63 |nter. Th|us you c|
|000049e0| 61 6e 20 75 73 65 20 43 | 6c 6f 6e 65 20 74 6f 20 |an use C|lone to |
|000049f0| 67 65 74 20 73 6f 6d 65 | 74 68 69 6e 67 20 73 61 |get some|thing sa|
|00004a00| 66 65 20 74 6f 20 70 75 | 74 20 69 6e 20 61 20 73 |fe to pu|t in a s|
|00004a10| 6f 75 70 2e 20 20 41 6c | 74 65 72 6e 61 74 65 6c |oup.  Al|ternatel|
|00004a20| 79 2c 20 79 6f 75 20 63 | 6f 75 6c 64 20 61 64 64 |y, you c|ould add|
|00004a30| 20 74 68 65 20 65 6e 74 | 72 79 2c 20 74 68 65 6e | the ent|ry, then|
|00004a40| 20 69 6d 6d 65 64 69 61 | 74 65 6c 79 20 74 68 72 | immedia|tely thr|
|00004a50| 6f 77 20 61 77 61 79 20 | 74 68 65 20 52 41 4d 20 |ow away |the RAM |
|00004a60| 63 6f 70 79 2c 20 66 6f | 72 63 65 20 61 20 67 61 |copy, fo|rce a ga|
|00004a70| 72 62 61 67 65 20 63 6f | 6c 6c 65 63 74 69 6f 6e |rbage co|llection|
|00004a80| 2c 20 61 6e 64 20 71 75 | 65 72 79 20 74 68 65 20 |, and qu|ery the |
|00004a90| 73 6f 75 70 20 74 6f 20 | 67 65 74 20 61 20 22 66 |soup to |get a "f|
|00004aa0| 72 65 73 68 22 20 63 6f | 70 79 20 6f 66 20 74 68 |resh" co|py of th|
|00004ab0| 65 20 65 6e 74 72 79 20 | 77 68 69 63 68 20 77 69 |e entry |which wi|
|00004ac0| 6c 6c 20 6e 6f 20 6c 6f | 6e 67 65 72 20 63 6f 6e |ll no lo|nger con|
|00004ad0| 74 61 69 6e 20 61 20 6d | 61 67 69 63 20 70 6f 69 |tain a m|agic poi|
|00004ae0| 6e 74 65 72 2e 0d 09 41 | 6c 74 68 6f 75 67 68 20 |nter...A|lthough |
|00004af0| 74 68 65 20 70 72 6f 62 | 6c 65 6d 20 64 65 73 63 |the prob|lem desc|
|00004b00| 72 69 62 65 64 20 68 65 | 72 65 20 69 73 20 73 75 |ribed he|re is su|
|00004b10| 62 74 6c 65 20 61 6e 64 | 20 74 72 69 63 6b 79 20 |btle and| tricky |
|00004b20| 74 6f 20 75 6e 64 65 72 | 73 74 61 6e 64 2c 20 69 |to under|stand, i|
|00004b30| 74 20 72 61 72 65 6c 79 | 20 61 72 69 73 65 73 20 |t rarely| arises |
|00004b40| 69 6e 20 70 72 61 63 74 | 69 63 65 2e 20 4f 6e 63 |in pract|ice. Onc|
|00004b50| 65 20 69 74 20 6f 63 63 | 75 72 73 2c 20 69 66 20 |e it occ|urs, if |
|00004b60| 79 6f 75 20 72 65 73 65 | 74 20 74 68 65 20 4e 65 |you rese|t the Ne|
|00004b70| 77 74 6f 6e 2c 20 69 74 | 20 77 69 6c 6c 20 75 73 |wton, it| will us|
|00004b80| 75 61 6c 6c 79 20 6e 6f | 74 20 6f 63 63 75 72 20 |ually no|t occur |
|00004b90| 61 67 61 69 6e 2e 0d 09 | 5f 5f 5f 5f 5f 5f 5f 5f |again...|________|
|00004ba0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004bb0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004bc0| 5f 5f 5f 0d 41 70 70 6c | 69 63 61 74 69 6f 6e 20 |___.Appl|ication |
|00004bd0| 50 72 65 66 65 72 65 6e | 63 65 73 20 61 6e 64 20 |Preferen|ces and |
|00004be0| 74 68 65 20 69 6e 74 65 | 72 6e 61 6c 20 73 74 6f |the inte|rnal sto|
|00004bf0| 72 65 20 28 31 2f 32 36 | 2f 39 34 29 20 28 4f 62 |re (1/26|/94) (Ob|
|00004c00| 73 6f 6c 65 74 65 64 20 | 62 79 20 31 2e 30 20 4e |soleted |by 1.0 N|
|00004c10| 65 77 74 6f 6e 20 50 72 | 6f 67 72 61 6d 6d 65 72 |ewton Pr|ogrammer|
|00004c20| 27 73 20 47 75 69 64 65 | 20 70 37 2d 33 33 29 0d |'s Guide| p7-33).|
|00004c30| 51 3a 09 49 73 20 74 68 | 65 72 65 20 61 6e 79 20 |Q:.Is th|ere any |
|00004c40| 72 65 61 73 6f 6e 20 74 | 68 65 20 69 6e 66 6f 72 |reason t|he infor|
|00004c50| 6d 61 74 69 6f 6e 20 77 | 65 20 70 75 74 20 69 6e |mation w|e put in|
|00004c60| 74 6f 20 74 68 65 20 22 | 73 79 73 74 65 6d 22 20 |to the "|system" |
|00004c70| 73 6f 75 70 20 28 6f 75 | 72 20 70 72 65 66 65 72 |soup (ou|r prefer|
|00004c80| 65 6e 63 65 73 29 20 6f | 72 20 74 68 65 20 69 6e |ences) o|r the in|
|00004c90| 66 6f 72 6d 61 74 69 6f | 6e 20 77 65 20 70 75 74 |formatio|n we put|
|00004ca0| 20 69 6e 74 6f 20 74 68 | 65 20 22 64 69 72 65 63 | into th|e "direc|
|00004cb0| 74 6f 72 79 22 20 73 6f | 75 70 20 28 6f 75 72 20 |tory" so|up (our |
|00004cc0| 64 6f 63 6b 65 72 20 69 | 6e 66 6f 29 20 6e 65 65 |docker i|nfo) nee|
|00004cd0| 64 73 20 74 6f 20 62 65 | 20 6f 6e 20 74 68 65 20 |ds to be| on the |
|00004ce0| 69 6e 74 65 72 6e 61 6c | 20 73 74 6f 72 65 20 28 |internal| store (|
|00004cf0| 73 74 6f 72 65 20 30 29 | 3f 20 20 43 61 6e 20 77 |store 0)|?  Can w|
|00004d00| 65 20 75 73 65 20 61 20 | 75 6e 69 6f 6e 73 6f 75 |e use a |unionsou|
|00004d10| 70 20 61 6e 64 20 41 64 | 64 54 6f 44 65 66 61 75 |p and Ad|dToDefau|
|00004d20| 6c 74 53 74 6f 72 65 2c | 20 73 6f 20 74 68 65 79 |ltStore,| so they|
|00004d30| 20 63 61 6e 20 66 6f 6c | 6c 6f 77 20 74 68 65 20 | can fol|low the |
|00004d40| 72 65 73 74 20 6f 66 20 | 74 68 65 20 75 73 65 72 |rest of |the user|
|00004d50| 27 73 20 64 61 74 61 20 | 61 72 6f 75 6e 64 20 77 |'s data |around w|
|00004d60| 69 74 68 20 74 68 65 20 | 63 61 72 64 3f 0d 41 3a |ith the |card?.A:|
|00004d70| 09 54 68 65 72 65 20 61 | 72 65 20 61 20 63 6f 75 |.There a|re a cou|
|00004d80| 70 6c 65 20 6f 66 20 72 | 65 61 73 6f 6e 73 20 77 |ple of r|easons w|
|00004d90| 68 79 20 79 6f 75 20 77 | 61 6e 74 20 74 6f 20 70 |hy you w|ant to p|
|00004da0| 75 74 20 79 6f 75 72 20 | 70 72 65 66 65 72 65 6e |ut your |preferen|
|00004db0| 63 65 73 20 6f 6e 20 73 | 74 6f 72 65 20 7a 65 72 |ces on s|tore zer|
|00004dc0| 6f 2e 20 20 4f 6e 65 20 | 72 65 61 73 6f 6e 20 69 |o.  One |reason i|
|00004dd0| 73 20 69 66 20 79 6f 75 | 72 20 61 70 70 6c 69 63 |s if you|r applic|
|00004de0| 61 74 69 6f 6e 20 69 73 | 20 6f 6e 20 61 20 63 61 |ation is| on a ca|
|00004df0| 72 64 20 61 6e 64 20 69 | 73 20 6d 6f 76 65 64 20 |rd and i|s moved |
|00004e00| 66 72 6f 6d 20 4e 65 77 | 74 6f 6e 20 74 6f 20 4e |from New|ton to N|
|00004e10| 65 77 74 6f 6e 2c 20 79 | 6f 75 20 77 61 6e 74 20 |ewton, y|ou want |
|00004e20| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |the appl|ication |
|00004e30| 74 6f 20 6c 6f 6f 6b 20 | 66 69 72 73 74 20 74 6f |to look |first to|
|00004e40| 20 73 65 65 20 69 66 20 | 74 68 65 20 63 75 72 72 | see if |the curr|
|00004e50| 65 6e 74 20 4e 65 77 74 | 6f 6e 20 61 6c 72 65 61 |ent Newt|on alrea|
|00004e60| 64 79 20 68 61 73 20 70 | 72 65 66 65 72 65 6e 63 |dy has p|referenc|
|00004e70| 65 73 20 66 6f 72 20 79 | 6f 75 72 20 61 70 70 6c |es for y|our appl|
|00004e80| 69 63 61 74 69 6f 6e 20 | 20 2d 2d 20 74 68 61 74 |ication | -- that|
|00004e90| 20 77 61 79 2c 20 74 68 | 61 74 20 4e 65 77 74 6f | way, th|at Newto|
|00004ea0| 6e 27 73 20 6f 77 6e 65 | 72 20 6b 6e 6f 77 73 20 |n's owne|r knows |
|00004eb0| 77 68 61 74 20 74 6f 20 | 65 78 70 65 63 74 2e 20 |what to |expect. |
|00004ec0| 20 0d 09 41 6c 73 6f 2c | 20 69 66 20 79 6f 75 20 | ..Also,| if you |
|00004ed0| 6d 65 72 65 6c 79 20 61 | 64 64 20 74 68 65 20 70 |merely a|dd the p|
|00004ee0| 72 65 66 65 72 65 6e 63 | 65 73 20 74 6f 20 74 68 |referenc|es to th|
|00004ef0| 65 20 64 65 66 61 75 6c | 74 20 73 74 6f 72 65 2c |e defaul|t store,|
|00004f00| 20 79 6f 75 20 63 6f 75 | 6c 64 20 67 65 74 20 69 | you cou|ld get i|
|00004f10| 6e 74 6f 20 61 20 73 69 | 74 75 61 74 69 6f 6e 20 |nto a si|tuation |
|00004f20| 77 68 65 72 65 20 79 6f | 75 72 20 70 72 65 66 65 |where yo|ur prefe|
|00004f30| 72 65 6e 63 65 73 20 61 | 72 65 20 6f 6e 20 74 68 |rences a|re on th|
|00004f40| 65 20 63 61 72 64 20 62 | 75 74 20 79 6f 75 72 20 |e card b|ut your |
|00004f50| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 69 73 20 69 |applicat|ion is i|
|00004f60| 6e 20 69 6e 74 65 72 6e | 61 6c 20 6d 65 6d 6f 72 |n intern|al memor|
|00004f70| 79 2e 20 49 6e 20 74 68 | 69 73 20 63 61 73 65 2c |y. In th|is case,|
|00004f80| 20 69 66 20 74 68 65 20 | 63 61 72 64 20 69 73 20 | if the |card is |
|00004f90| 70 75 6c 6c 65 64 20 79 | 6f 75 27 72 65 20 6f 75 |pulled y|ou're ou|
|00004fa0| 74 20 6f 66 20 6c 75 63 | 6b 2e 0d 09 5f 5f 5f 5f |t of luc|k...____|
|00004fb0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004fc0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00004fd0| 5f 5f 5f 5f 5f 5f 5f 0d | 4e 45 57 3a 20 43 6f 72 |_______.|NEW: Cor|
|00004fe0| 72 65 63 74 20 6e 61 6d | 65 20 6f 66 20 5f 75 6e |rect nam|e of _un|
|00004ff0| 69 71 75 65 49 44 20 73 | 6c 6f 74 20 28 4e 45 57 |iqueID s|lot (NEW|
|00005000| 20 35 2f 33 31 2f 39 34 | 29 0d 51 3a 20 49 27 6d | 5/31/94|).Q: I'm|
|00005010| 20 75 6e 61 62 6c 65 20 | 74 6f 20 75 73 65 20 74 | unable |to use t|
|00005020| 68 65 20 75 6e 69 71 75 | 65 49 44 20 73 6c 6f 74 |he uniqu|eID slot|
|00005030| 20 74 6f 20 6d 61 6e 69 | 70 75 6c 61 74 65 20 73 | to mani|pulate s|
|00005040| 6f 75 70 20 65 6e 74 72 | 69 65 73 2e 20 49 20 73 |oup entr|ies. I s|
|00005050| 65 65 20 69 74 20 69 6e | 20 74 68 65 20 49 6e 73 |ee it in| the Ins|
|00005060| 70 65 63 74 6f 72 2c 20 | 62 75 74 20 6d 79 20 63 |pector, |but my c|
|00005070| 6f 64 65 20 6b 65 65 70 | 73 20 62 72 65 61 6b 69 |ode keep|s breaki|
|00005080| 6e 67 2e 20 57 68 61 74 | 27 73 20 77 72 6f 6e 67 |ng. What|'s wrong|
|00005090| 3f 0d 41 3a 20 54 68 65 | 20 63 6f 72 72 65 63 74 |?.A: The| correct|
|000050a0| 20 6e 61 6d 65 20 6f 66 | 20 74 68 69 73 20 73 6c | name of| this sl|
|000050b0| 6f 74 2c 20 5f 75 6e 69 | 71 75 65 49 44 2c 20 20 |ot, _uni|queID,  |
|000050c0| 62 65 67 69 6e 73 20 77 | 69 74 68 20 61 6e 20 75 |begins w|ith an u|
|000050d0| 6e 64 65 72 73 63 6f 72 | 65 2e 20 20 55 6e 66 6f |nderscor|e.  Unfo|
|000050e0| 72 74 75 6e 61 74 65 6c | 79 2c 20 74 68 65 20 44 |rtunatel|y, the D|
|000050f0| 61 74 61 20 53 74 6f 72 | 61 67 65 20 61 6e 64 20 |ata Stor|age and |
|00005100| 52 65 74 72 69 65 76 61 | 6c 20 63 68 61 70 74 65 |Retrieva|l chapte|
|00005110| 72 20 6f 66 20 4e 50 47 | 20 31 2e 30 20 6f 6d 69 |r of NPG| 1.0 omi|
|00005120| 74 73 20 74 68 65 20 75 | 6e 64 65 72 73 63 6f 72 |ts the u|nderscor|
|00005130| 65 20 69 6e 20 73 65 76 | 65 72 61 6c 20 70 6c 61 |e in sev|eral pla|
|00005140| 63 65 73 3b 20 74 68 69 | 73 20 65 72 72 6f 72 20 |ces; thi|s error |
|00005150| 77 69 6c 6c 20 62 65 20 | 63 6f 72 72 65 63 74 65 |will be |correcte|
|00005160| 64 20 69 6e 20 74 68 65 | 20 6e 65 78 74 20 76 65 |d in the| next ve|
|00005170| 72 73 69 6f 6e 20 6f 66 | 20 74 68 65 20 4e 50 47 |rsion of| the NPG|
|00005180| 2e 20 20 59 6f 75 20 73 | 68 6f 75 6c 64 20 75 73 |.  You s|hould us|
|00005190| 65 20 74 68 65 20 45 6e | 74 72 79 55 6e 69 71 75 |e the En|tryUniqu|
|000051a0| 65 49 64 20 66 75 6e 63 | 74 69 6f 6e 20 69 6e 73 |eId func|tion ins|
|000051b0| 74 65 61 64 20 6f 66 20 | 61 63 63 65 73 73 69 6e |tead of |accessin|
|000051c0| 67 20 74 68 65 20 73 6c | 6f 74 20 64 69 72 65 63 |g the sl|ot direc|
|000051d0| 74 6c 79 2c 20 61 73 20 | 74 68 65 20 66 75 6e 63 |tly, as |the func|
|000051e0| 74 69 6f 6e 20 69 73 20 | 62 6f 74 68 20 66 61 73 |tion is |both fas|
|000051f0| 74 65 72 20 61 6e 64 20 | 67 75 61 72 61 6e 74 65 |ter and |guarante|
|00005200| 65 64 2e 0d 09 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |ed...___|________|
|00005210| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005220| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005230| 0d 43 48 41 4e 47 45 44 | 3a 20 4e 69 6c 20 49 6e |.CHANGED|: Nil In|
|00005240| 64 65 78 20 53 6c 6f 74 | 2c 20 41 64 64 69 6e 67 |dex Slot|, Adding|
|00005250| 20 45 6e 74 72 69 65 73 | 20 28 36 2f 37 2f 39 34 | Entries| (6/7/94|
|00005260| 29 0d 09 54 68 65 20 6f | 72 69 67 69 6e 61 6c 20 |)..The o|riginal |
|00005270| 4d 65 73 73 61 67 65 50 | 61 64 20 68 61 64 20 61 |MessageP|ad had a|
|00005280| 20 70 72 6f 62 6c 65 6d | 20 77 68 69 63 68 20 63 | problem| which c|
|00005290| 61 75 73 65 64 20 73 6f | 75 70 20 69 6e 64 65 78 |aused so|up index|
|000052a0| 65 73 20 74 6f 20 62 65 | 63 6f 6d 65 20 63 6f 72 |es to be|come cor|
|000052b0| 72 75 70 74 65 64 20 69 | 66 20 61 6e 20 69 6e 64 |rupted i|f an ind|
|000052c0| 65 78 65 64 20 73 6c 6f | 74 20 69 6e 20 61 6e 79 |exed slo|t in any|
|000052d0| 20 73 6f 75 70 20 65 6e | 74 72 79 20 65 78 69 73 | soup en|try exis|
|000052e0| 74 65 64 20 61 6e 64 20 | 63 6f 6e 74 61 69 6e 65 |ted and |containe|
|000052f0| 64 20 74 68 65 20 76 61 | 6c 75 65 20 4e 49 4c 2e |d the va|lue NIL.|
|00005300| 20 20 54 68 65 20 73 79 | 73 74 65 6d 20 77 6f 75 |  The sy|stem wou|
|00005310| 6c 64 20 6e 6f 74 20 77 | 61 72 6e 20 6f 66 20 74 |ld not w|arn of t|
|00005320| 68 69 73 2c 20 61 6e 64 | 20 79 6f 75 20 77 6f 75 |his, and| you wou|
|00005330| 6c 64 20 65 6e 64 20 75 | 70 20 69 6e 20 74 72 6f |ld end u|p in tro|
|00005340| 75 62 6c 65 20 6c 61 74 | 65 72 20 77 68 65 6e 20 |uble lat|er when |
|00005350| 64 6f 69 6e 67 20 51 75 | 65 72 69 65 73 2e 20 0d |doing Qu|eries. .|
|00005360| 20 0d 09 54 68 69 73 20 | 77 61 73 20 66 69 78 65 | ..This |was fixe|
|00005370| 64 20 69 6e 20 53 79 73 | 74 65 6d 20 55 70 64 61 |d in Sys|tem Upda|
|00005380| 74 65 20 31 2e 30 35 20 | 61 6e 64 20 6c 61 74 65 |te 1.05 |and late|
|00005390| 72 20 72 65 6c 65 61 73 | 65 73 2e 0d 09 4e 49 4c |r releas|es...NIL|
|000053a0| 20 69 6e 20 61 6e 20 69 | 6e 64 65 78 65 64 20 73 | in an i|ndexed s|
|000053b0| 6c 6f 74 20 6e 6f 77 20 | 62 65 68 61 76 65 73 20 |lot now |behaves |
|000053c0| 74 68 65 20 73 61 6d 65 | 20 61 73 20 69 66 20 74 |the same| as if t|
|000053d0| 68 65 20 73 6c 6f 74 20 | 77 65 72 65 20 6e 6f 74 |he slot |were not|
|000053e0| 20 70 72 65 73 65 6e 74 | 2e 20 20 54 68 61 74 20 | present|.  That |
|000053f0| 69 73 2c 20 74 68 61 74 | 20 73 6f 75 70 20 65 6e |is, that| soup en|
|00005400| 74 72 79 20 77 69 6c 6c | 20 6e 6f 74 20 62 65 20 |try will| not be |
|00005410| 66 69 6e 64 61 62 6c 65 | 20 75 73 69 6e 67 20 74 |findable| using t|
|00005420| 68 65 20 73 70 65 63 69 | 66 69 65 64 20 69 6e 64 |he speci|fied ind|
|00005430| 65 78 2e 20 20 28 41 6c | 6c 20 65 6e 74 72 69 65 |ex.  (Al|l entrie|
|00005440| 73 20 63 61 6e 20 61 6c | 77 61 79 73 20 62 65 20 |s can al|ways be |
|00005450| 66 6f 75 6e 64 20 77 69 | 74 68 20 74 68 65 20 64 |found wi|th the d|
|00005460| 65 66 61 75 6c 74 20 69 | 6e 64 65 78 2e 29 0d 09 |efault i|ndex.)..|
|00005470| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005480| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005490| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 0d 43 48 41 4e |________|___.CHAN|
|000054a0| 47 45 44 3a 20 49 6e 64 | 65 78 65 73 20 69 6e 20 |GED: Ind|exes in |
|000054b0| 64 65 63 72 65 61 73 69 | 6e 67 20 6f 72 64 65 72 |decreasi|ng order|
|000054c0| 3f 20 28 36 2f 37 2f 39 | 34 29 0d 51 3a 20 09 49 |? (6/7/9|4).Q: .I|
|000054d0| 27 6d 20 64 6f 69 6e 67 | 20 61 20 6c 69 74 74 6c |'m doing| a littl|
|000054e0| 65 20 64 61 74 61 62 61 | 73 65 20 61 70 70 2c 20 |e databa|se app, |
|000054f0| 61 6e 64 20 69 6e 20 6d | 79 20 6f 76 65 72 76 69 |and in m|y overvi|
|00005500| 65 77 2c 20 49 20 77 61 | 6e 74 20 74 6f 20 62 65 |ew, I wa|nt to be|
|00005510| 20 61 62 6c 65 20 74 6f | 20 64 6f 20 61 20 22 73 | able to| do a "s|
|00005520| 6f 72 74 20 62 79 22 20 | 63 6f 6e 74 72 6f 6c 2e |ort by" |control.|
|00005530| 20 20 43 68 6f 6f 73 69 | 6e 67 20 74 68 65 20 63 |  Choosi|ng the c|
|00005540| 6f 6c 75 6d 6e 20 69 73 | 20 65 61 73 79 20 28 64 |olumn is| easy (d|
|00005550| 69 66 66 65 72 65 6e 74 | 20 69 6e 64 69 63 65 73 |ifferent| indices|
|00005560| 2c 20 6a 75 73 74 20 73 | 77 69 74 63 68 20 63 75 |, just s|witch cu|
|00005570| 72 73 6f 72 73 29 2e 20 | 20 42 75 74 20 63 68 6f |rsors). | But cho|
|00005580| 6f 73 69 6e 67 20 61 73 | 63 65 6e 64 69 6e 67 2f |osing as|cending/|
|00005590| 64 65 73 63 65 6e 64 69 | 6e 67 20 69 73 20 74 72 |descendi|ng is tr|
|000055a0| 69 63 6b 69 65 72 2e 20 | 20 48 6f 77 20 64 6f 20 |ickier. | How do |
|000055b0| 79 6f 75 20 6d 61 6b 65 | 20 63 75 72 73 6f 72 73 |you make| cursors|
|000055c0| 20 67 6f 20 62 61 63 6b | 77 61 72 64 73 20 66 72 | go back|wards fr|
|000055d0| 6f 6d 20 74 68 65 69 72 | 20 22 6e 6f 72 6d 61 6c |om their| "normal|
|000055e0| 20 64 69 72 65 63 74 69 | 6f 6e 22 20 3f 0d 41 3a | directi|on" ?.A:|
|000055f0| 20 49 6e 64 65 78 65 73 | 20 61 72 65 20 61 6c 77 | Indexes| are alw|
|00005600| 61 79 73 20 73 6f 72 74 | 65 64 20 69 6e 20 61 73 |ays sort|ed in as|
|00005610| 63 65 6e 64 69 6e 67 20 | 6f 72 64 65 72 2c 20 62 |cending |order, b|
|00005620| 75 74 20 79 6f 75 72 20 | 63 75 72 73 6f 72 20 64 |ut your |cursor d|
|00005630| 6f 65 73 20 6e 6f 74 20 | 68 61 76 65 20 74 6f 20 |oes not |have to |
|00005640| 6f 6e 6c 79 20 6d 6f 76 | 65 20 69 6e 20 74 68 65 |only mov|e in the|
|00005650| 20 22 6e 61 74 75 72 61 | 6c 22 20 64 69 72 65 63 | "natura|l" direc|
|00005660| 74 69 6f 6e 2e 20 20 49 | 66 20 79 6f 75 20 75 73 |tion.  I|f you us|
|00005670| 65 20 74 68 65 20 4d 6f | 76 65 20 6d 65 74 68 6f |e the Mo|ve metho|
|00005680| 64 20 61 6e 64 20 68 61 | 76 65 20 61 20 22 64 69 |d and ha|ve a "di|
|00005690| 72 65 63 74 69 6f 6e 22 | 20 63 6f 6e 73 74 61 6e |rection"| constan|
|000056a0| 74 2f 67 6c 6f 62 61 6c | 20 74 68 61 74 20 69 73 |t/global| that is|
|000056b0| 20 65 69 74 68 65 72 20 | 31 20 6f 72 20 2d 31 2c | either |1 or -1,|
|000056c0| 20 79 6f 75 20 63 61 6e | 20 65 66 66 65 63 74 69 | you can| effecti|
|000056d0| 76 65 6c 79 20 6d 61 6b | 65 20 61 6e 20 69 6e 64 |vely mak|e an ind|
|000056e0| 65 78 20 61 70 70 65 61 | 72 20 74 6f 20 62 65 20 |ex appea|r to be |
|000056f0| 69 6e 63 72 65 61 73 69 | 6e 67 20 6f 72 20 64 65 |increasi|ng or de|
|00005700| 63 72 65 61 73 69 6e 67 | 20 62 79 20 64 6f 69 6e |creasing| by doin|
|00005710| 67 3a 0d 09 20 63 75 72 | 73 6f 72 3a 4d 6f 76 65 |g:.. cur|sor:Move|
|00005720| 28 67 44 69 72 65 63 74 | 69 6f 6e 20 2a 20 61 6d |(gDirect|ion * am|
|00005730| 6f 75 6e 74 29 3b 0d 09 | 0d 09 48 6f 77 65 76 65 |ount);..|..Howeve|
|00005740| 72 2c 20 74 68 65 20 62 | 75 69 6c 74 2d 69 6e 20 |r, the b|uilt-in |
|00005750| 62 65 68 61 76 69 6f 72 | 73 20 66 6f 72 20 6d 6f |behavior|s for mo|
|00005760| 76 69 6e 67 20 74 6f 20 | 74 68 65 20 6e 65 61 72 |ving to |the near|
|00005770| 65 73 74 20 6b 65 79 2c | 20 73 75 63 68 20 61 73 |est key,| such as|
|00005780| 20 77 69 74 68 20 74 68 | 65 20 73 74 61 72 74 4b | with th|e startK|
|00005790| 65 79 20 69 6e 20 61 6e | 20 69 6e 64 65 78 2c 20 |ey in an| index, |
|000057a0| 6f 72 20 63 75 72 73 6f | 72 3a 47 6f 74 6f 4b 65 |or curso|r:GotoKe|
|000057b0| 79 28 6b 65 79 29 2c 20 | 77 69 6c 6c 20 73 74 69 |y(key), |will sti|
|000057c0| 6c 6c 20 6f 70 65 72 61 | 74 65 20 69 6e 20 61 73 |ll opera|te in as|
|000057d0| 63 65 6e 64 69 6e 67 20 | 6f 72 64 65 72 2e 20 20 |cending |order.  |
|000057e0| 59 6f 75 20 63 61 6e 20 | 66 69 78 20 74 68 69 73 |You can |fix this|
|000057f0| 20 62 79 20 63 61 6c 6c | 69 6e 67 20 50 72 65 76 | by call|ing Prev|
|00005800| 20 69 6e 20 61 70 70 72 | 6f 70 72 69 61 74 65 20 | in appr|opriate |
|00005810| 70 6c 61 63 65 73 2e 20 | 20 46 6f 72 20 65 78 61 |places. | For exa|
|00005820| 6d 70 6c 65 3a 0d 09 63 | 75 72 73 6f 72 3a 47 6f |mple:..c|ursor:Go|
|00005830| 74 6f 4b 65 79 28 74 68 | 65 4b 65 79 29 3b 20 20 |toKey(th|eKey);  |
|00005840| 20 2f 2f 20 6d 6f 76 65 | 73 20 74 68 65 20 63 75 | // move|s the cu|
|00005850| 72 73 6f 72 20 74 6f 20 | 74 68 65 20 6b 65 79 20 |rsor to |the key |
|00005860| 73 70 65 63 69 66 69 65 | 64 09 09 09 09 09 09 09 |specifie|d.......|
|00005870| 20 20 2f 2f 20 6f 72 20 | 74 6f 20 6e 65 78 74 20 |  // or |to next |
|00005880| 68 69 67 68 65 73 74 20 | 6b 65 79 20 69 66 20 6e |highest |key if n|
|00005890| 6f 74 20 66 6f 75 6e 64 | 2e 0d 09 69 66 20 67 44 |ot found|...if gD|
|000058a0| 69 72 65 63 74 69 6f 6e | 20 3d 20 2d 31 20 61 6e |irection| = -1 an|
|000058b0| 64 20 63 75 72 73 6f 72 | 3a 45 6e 74 72 79 28 29 |d cursor|:Entry()|
|000058c0| 2e 6b 65 79 20 3c 3e 20 | 74 68 65 4b 65 79 20 74 |.key <> |theKey t|
|000058d0| 68 65 6e 0d 09 09 63 75 | 72 73 6f 72 3a 50 72 65 |hen...cu|rsor:Pre|
|000058e0| 76 28 29 3b 20 20 2f 2f | 20 6e 6f 77 20 63 75 72 |v();  //| now cur|
|000058f0| 73 6f 72 20 69 73 20 61 | 74 20 6e 65 78 74 20 6c |sor is a|t next l|
|00005900| 6f 77 65 73 74 20 6b 65 | 79 20 66 72 6f 6d 20 74 |owest ke|y from t|
|00005910| 68 65 4b 65 79 0d 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |heKey.__|________|
|00005920| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005930| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005940| 5f 0d 4e 45 57 3a 20 73 | 74 61 72 74 4b 65 79 20 |_.NEW: s|tartKey |
|00005950| 61 6e 64 20 65 6e 64 54 | 65 73 74 20 61 6e 64 20 |and endT|est and |
|00005960| 63 75 72 73 6f 72 20 6c | 69 6d 69 74 73 20 28 36 |cursor l|imits (6|
|00005970| 2f 39 2f 39 34 29 0d 51 | 3a 09 49 66 20 49 20 63 |/9/94).Q|:.If I c|
|00005980| 72 65 61 74 65 20 61 20 | 63 75 72 73 6f 72 20 77 |reate a |cursor w|
|00005990| 69 74 68 20 73 74 61 72 | 74 4b 65 79 3a 22 42 72 |ith star|tKey:"Br|
|000059a0| 75 63 65 22 2c 20 74 68 | 65 6e 20 64 6f 20 63 75 |uce", th|en do cu|
|000059b0| 72 73 6f 72 3a 52 65 73 | 65 74 20 61 6e 64 20 63 |rsor:Res|et and c|
|000059c0| 75 72 73 6f 72 3a 50 72 | 65 76 2c 20 69 74 20 73 |ursor:Pr|ev, it s|
|000059d0| 65 65 6d 73 20 6c 69 6b | 65 20 49 20 73 68 6f 75 |eems lik|e I shou|
|000059e0| 6c 64 20 67 65 74 20 4e | 49 4c 2c 20 62 75 74 20 |ld get N|IL, but |
|000059f0| 49 20 67 65 74 20 74 68 | 65 20 65 6e 74 72 79 20 |I get th|e entry |
|00005a00| 22 41 6c 6c 61 6e 22 20 | 69 6e 73 74 65 61 64 2e |"Allan" |instead.|
|00005a10| 20 20 57 68 61 74 27 73 | 20 77 72 6f 6e 67 3f 0d |  What's| wrong?.|
|00005a20| 41 3a 09 53 74 61 72 74 | 4b 65 79 20 69 73 20 75 |A:.Start|Key is u|
|00005a30| 73 65 64 20 74 6f 20 70 | 6f 73 69 74 69 6f 6e 20 |sed to p|osition |
|00005a40| 74 68 65 20 63 75 72 73 | 6f 72 20 69 6e 69 74 69 |the curs|or initi|
|00005a50| 61 6c 6c 79 20 28 61 6e | 64 20 61 66 74 65 72 20 |ally (an|d after |
|00005a60| 61 20 63 75 72 73 6f 72 | 3a 52 65 73 65 74 2e 29 |a cursor|:Reset.)|
|00005a70| 20 20 49 74 20 69 73 20 | 63 6f 72 72 65 63 74 20 |  It is |correct |
|00005a80| 74 6f 20 74 68 69 6e 6b | 20 6f 66 20 53 74 61 72 |to think| of Star|
|00005a90| 74 4b 65 79 20 61 73 20 | 61 6e 20 69 6d 70 6c 69 |tKey as |an impli|
|00005aa0| 63 69 74 20 63 75 72 73 | 6f 72 3a 47 6f 74 6f 4b |cit curs|or:GotoK|
|00005ab0| 65 79 2e 0d 09 45 6e 64 | 54 65 73 74 20 69 73 20 |ey...End|Test is |
|00005ac0| 63 61 6c 6c 65 64 20 6f | 6e 20 61 20 63 61 6e 64 |called o|n a cand|
|00005ad0| 69 64 61 74 65 20 65 6e | 74 72 79 20 77 68 65 6e |idate en|try when|
|00005ae0| 65 76 65 72 20 74 68 65 | 20 63 75 72 73 6f 72 20 |ever the| cursor |
|00005af0| 6d 6f 76 65 73 2c 20 65 | 69 74 68 65 72 20 66 6f |moves, e|ither fo|
|00005b00| 72 77 61 72 64 20 6f 72 | 20 62 61 63 6b 77 61 72 |rward or| backwar|
|00005b10| 64 2e 20 20 49 66 20 74 | 68 65 20 45 6e 64 54 65 |d.  If t|he EndTe|
|00005b20| 73 74 20 66 75 6e 63 74 | 69 6f 6e 20 72 65 74 75 |st funct|ion retu|
|00005b30| 72 6e 73 20 74 72 75 65 | 2c 20 74 68 65 20 63 75 |rns true|, the cu|
|00005b40| 72 73 6f 72 20 69 73 20 | 61 73 73 75 6d 65 64 20 |rsor is |assumed |
|00005b50| 74 6f 20 62 65 20 61 74 | 20 74 68 65 20 22 65 6e |to be at| the "en|
|00005b60| 64 22 20 6f 66 20 74 68 | 65 20 73 6f 75 70 2c 20 |d" of th|e soup, |
|00005b70| 73 69 6d 69 6c 61 72 20 | 74 6f 20 70 72 65 76 27 |similar |to prev'|
|00005b80| 69 6e 67 20 6f 72 20 6e | 65 78 74 27 69 6e 67 20 |ing or n|ext'ing |
|00005b90| 70 61 73 74 20 74 68 65 | 20 6c 61 73 74 20 65 6e |past the| last en|
|00005ba0| 74 72 79 2e 0d 09 49 74 | 27 73 20 70 65 72 66 65 |try...It|'s perfe|
|00005bb0| 63 74 6c 79 20 63 6f 72 | 72 65 63 74 20 74 6f 20 |ctly cor|rect to |
|00005bc0| 68 61 76 65 20 61 6e 20 | 65 6e 64 54 65 73 74 20 |have an |endTest |
|00005bd0| 74 68 61 74 20 6c 69 6d | 69 74 73 20 74 68 65 20 |that lim|its the |
|00005be0| 73 6f 75 70 20 74 6f 20 | 65 6e 74 72 69 65 73 20 |soup to |entries |
|00005bf0| 62 65 74 77 65 65 6e 20 | 22 43 22 20 61 6e 64 20 |between |"C" and |
|00005c00| 22 47 22 2c 20 61 6e 64 | 20 61 20 73 74 61 72 74 |"G", and| a start|
|00005c10| 4b 65 79 20 74 68 61 74 | 20 69 6e 69 74 69 61 6c |Key that| initial|
|00005c20| 6c 79 20 70 6f 73 69 74 | 69 6f 6e 73 20 74 68 65 |ly posit|ions the|
|00005c30| 20 63 75 72 73 6f 72 20 | 61 74 20 74 68 65 20 66 | cursor |at the f|
|00005c40| 69 72 73 74 20 22 45 22 | 2e 0d 09 59 6f 75 72 20 |irst "E"|...Your |
|00005c50| 65 6e 64 54 65 73 74 20 | 73 68 6f 75 6c 64 20 62 |endTest |should b|
|00005c60| 65 20 77 72 69 74 74 65 | 6e 20 73 6f 20 74 68 61 |e writte|n so tha|
|00005c70| 74 20 69 74 20 77 69 6c | 6c 20 72 65 74 75 72 6e |t it wil|l return|
|00005c80| 20 54 52 55 45 20 77 68 | 65 6e 20 74 68 65 20 63 | TRUE wh|en the c|
|00005c90| 75 72 73 6f 72 20 6d 6f | 76 65 73 20 6f 66 66 20 |ursor mo|ves off |
|00005ca0| 65 69 74 68 65 72 20 65 | 6e 64 20 6f 66 20 74 68 |either e|nd of th|
|00005cb0| 65 20 73 6f 75 70 2e 20 | 20 46 6f 72 20 65 78 61 |e soup. | For exa|
|00005cc0| 6d 70 6c 65 3a 0d 09 66 | 75 6e 63 28 65 29 20 53 |mple:..f|unc(e) S|
|00005cd0| 74 72 43 6f 6d 70 61 72 | 65 28 65 2e 73 6f 72 74 |trCompar|e(e.sort|
|00005ce0| 4f 6e 2c 20 22 44 22 29 | 20 3e 20 30 20 6f 72 20 |On, "D")| > 0 or |
|00005cf0| 53 74 72 43 6f 6d 70 61 | 72 65 28 65 2e 73 6f 72 |StrCompa|re(e.sor|
|00005d00| 74 4f 6e 2c 20 22 42 22 | 29 20 3c 20 30 29 0d 09 |tOn, "B"|) < 0)..|
|00005d10| 57 68 65 6e 20 74 68 65 | 20 65 6e 64 54 65 73 74 |When the| endTest|
|00005d20| 20 72 65 74 75 72 6e 73 | 20 54 52 55 45 2c 20 79 | returns| TRUE, y|
|00005d30| 6f 75 20 63 61 6e 20 74 | 68 69 6e 6b 20 6f 66 20 |ou can t|hink of |
|00005d40| 69 74 20 61 73 20 22 6d | 6f 76 69 6e 67 22 20 74 |it as "m|oving" t|
|00005d50| 68 65 20 63 75 72 73 6f | 72 20 6f 66 66 20 74 68 |he curso|r off th|
|00005d60| 65 20 62 65 67 69 6e 6e | 69 6e 67 20 6f 72 20 65 |e beginn|ing or e|
|00005d70| 6e 64 20 6f 66 20 74 68 | 65 20 73 6f 75 70 2c 20 |nd of th|e soup, |
|00005d80| 64 65 70 65 6e 64 69 6e | 67 20 6f 6e 20 77 68 65 |dependin|g on whe|
|00005d90| 74 68 65 72 20 79 6f 75 | 20 77 65 72 65 20 6d 6f |ther you| were mo|
|00005da0| 76 69 6e 67 20 66 6f 72 | 77 61 72 64 20 6f 72 20 |ving for|ward or |
|00005db0| 62 61 63 6b 77 61 72 64 | 2e 20 20 57 68 65 6e 20 |backward|.  When |
|00005dc0| 79 6f 75 20 74 68 65 6e | 20 74 72 79 20 74 6f 20 |you then| try to |
|00005dd0| 3a 4e 65 78 74 20 6f 72 | 20 3a 50 72 65 76 20 74 |:Next or| :Prev t|
|00005de0| 6f 20 74 68 65 20 6c 61 | 73 74 2f 66 69 72 73 74 |o the la|st/first|
|00005df0| 20 65 6e 74 72 79 2c 20 | 74 68 65 20 61 63 74 75 | entry, |the actu|
|00005e00| 61 6c 20 6c 61 73 74 2f | 66 69 72 73 74 20 65 6e |al last/|first en|
|00005e10| 74 72 79 20 69 6e 20 74 | 68 65 20 73 6f 75 70 20 |try in t|he soup |
|00005e20| 69 73 20 74 65 73 74 65 | 64 20 77 69 74 68 20 74 |is teste|d with t|
|00005e30| 68 65 20 65 6e 64 54 65 | 73 74 20 66 75 6e 63 74 |he endTe|st funct|
|00005e40| 69 6f 6e 2e 20 20 49 66 | 20 28 61 73 20 69 6e 20 |ion.  If| (as in |
|00005e50| 74 68 65 20 61 62 6f 76 | 65 20 63 61 73 65 29 2c |the abov|e case),|
|00005e60| 20 74 68 65 20 6c 61 73 | 74 20 6f 72 20 66 69 72 | the las|t or fir|
|00005e70| 73 74 20 65 6e 74 72 79 | 20 63 61 75 73 65 73 20 |st entry| causes |
|00005e80| 65 6e 64 54 65 73 74 20 | 74 6f 20 72 65 74 75 72 |endTest |to retur|
|00005e90| 6e 20 54 52 55 45 2c 20 | 74 68 65 20 63 75 72 73 |n TRUE, |the curs|
|00005ea0| 6f 72 20 77 69 6c 6c 20 | 61 67 61 69 6e 20 62 65 |or will |again be|
|00005eb0| 20 70 6f 73 69 74 69 6f | 6e 65 64 20 61 74 20 74 | positio|ned at t|
|00005ec0| 68 65 20 62 65 67 69 6e | 6e 69 6e 67 2f 65 6e 64 |he begin|ning/end|
|00005ed0| 20 6f 66 20 74 68 65 20 | 73 6f 75 70 2c 20 61 6e | of the |soup, an|
|00005ee0| 64 20 74 68 65 20 63 75 | 72 73 6f 72 27 73 20 65 |d the cu|rsor's e|
|00005ef0| 6e 74 72 79 20 77 69 6c | 6c 20 62 65 20 4e 49 4c |ntry wil|l be NIL|
|00005f00| 2e 20 20 59 6f 75 72 20 | 63 75 72 73 6f 72 20 69 |.  Your |cursor i|
|00005f10| 73 20 22 73 74 75 63 6b | 2e 22 20 61 74 20 74 68 |s "stuck|." at th|
|00005f20| 65 20 65 6e 64 2e 20 20 | 49 66 20 79 6f 75 20 65 |e end.  |If you e|
|00005f30| 78 70 65 63 74 20 74 68 | 69 73 20 74 6f 20 68 61 |xpect th|is to ha|
|00005f40| 70 70 65 6e 2c 20 79 6f | 75 20 63 61 6e 20 75 73 |ppen, yo|u can us|
|00005f50| 65 20 74 68 65 20 3a 47 | 6f 74 6f 20 6f 72 20 3a |e the :G|oto or :|
|00005f60| 47 6f 74 6f 4b 65 79 20 | 6d 65 74 68 6f 64 73 20 |GotoKey |methods |
|00005f70| 74 6f 20 22 75 6e 73 74 | 69 63 6b 22 20 74 68 65 |to "unst|ick" the|
|00005f80| 20 63 75 72 73 6f 72 2e | 0d 09 5f 5f 5f 5f 5f 5f | cursor.|..______|
|00005f90| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005fa0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00005fb0| 5f 5f 5f 5f 5f 0d 4e 45 | 57 3a 20 43 61 72 64 20 |_____.NE|W: Card |
|00005fc0| 27 61 70 70 6c 65 74 27 | 20 6d 65 6d 6f 72 79 20 |'applet'| memory |
|00005fd0| 73 69 7a 65 20 76 61 72 | 69 65 73 20 28 36 2f 39 |size var|ies (6/9|
|00005fe0| 2f 39 34 29 0d 51 3a 09 | 54 68 65 20 6e 75 6d 62 |/94).Q:.|The numb|
|00005ff0| 65 72 73 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |ers retu|rned by |
|00006000| 74 68 65 20 63 61 72 64 | 20 27 61 70 70 6c 65 74 |the card| 'applet|
|00006010| 27 20 66 6f 72 20 74 68 | 65 20 73 69 7a 65 20 66 |' for th|e size f|
|00006020| 72 65 65 20 61 6e 64 20 | 75 73 65 64 20 6f 6e 20 |ree and |used on |
|00006030| 74 68 65 20 63 61 72 64 | 20 73 65 65 6d 20 74 6f |the card| seem to|
|00006040| 20 62 65 20 69 6e 63 6f | 6e 73 69 73 74 65 6e 74 | be inco|nsistent|
|00006050| 2e 0d 41 3a 09 43 6f 72 | 72 65 63 74 2e 20 54 68 |..A:.Cor|rect. Th|
|00006060| 65 20 6e 75 6d 62 65 72 | 73 20 73 68 6f 77 6e 20 |e number|s shown |
|00006070| 69 6e 20 74 68 65 20 63 | 61 72 64 20 64 69 61 6c |in the c|ard dial|
|00006080| 6f 67 20 61 72 65 20 6f | 6e 6c 79 20 61 70 70 72 |og are o|nly appr|
|00006090| 6f 78 69 6d 61 74 65 2c | 20 61 6e 64 20 63 61 6e |oximate,| and can|
|000060a0| 20 62 65 20 74 68 6f 75 | 67 68 74 20 6f 66 20 61 | be thou|ght of a|
|000060b0| 73 20 61 20 66 6c 6f 61 | 74 69 6e 67 20 67 61 73 |s a floa|ting gas|
|000060c0| 20 28 6f 72 20 70 65 74 | 72 6f 6c 29 20 67 61 75 | (or pet|rol) gau|
|000060d0| 67 65 2e 20 41 6e 20 61 | 70 70 72 6f 78 69 6d 61 |ge. An a|pproxima|
|000060e0| 74 69 6f 6e 20 69 73 20 | 70 72 6f 76 69 64 65 64 |tion is |provided|
|000060f0| 20 62 65 63 61 75 73 65 | 20 74 68 65 20 63 6f 64 | because| the cod|
|00006100| 65 20 72 65 71 75 69 72 | 65 64 20 74 6f 20 67 65 |e requir|ed to ge|
|00006110| 74 20 61 6e 20 61 63 63 | 75 72 61 74 65 20 6e 75 |t an acc|urate nu|
|00006120| 6d 62 65 72 20 77 6f 75 | 6c 64 20 72 65 71 75 69 |mber wou|ld requi|
|00006130| 72 65 20 6f 6e 20 74 68 | 65 20 6f 72 64 65 72 20 |re on th|e order |
|00006140| 6f 66 20 35 20 6d 69 6e | 75 74 65 73 20 74 6f 20 |of 5 min|utes to |
|00006150| 65 78 65 63 75 74 65 2e | 0d 09 5f 5f 5f 5f 5f 5f |execute.|..______|
|00006160| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00006170| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00006180| 5f 5f 5f 5f 5f 0d 4e 45 | 57 3a 20 49 6e 74 65 72 |_____.NE|W: Inter|
|00006190| 72 61 63 74 69 6f 6e 20 | 6f 66 20 45 6e 74 72 79 |raction |of Entry|
|000061a0| 43 68 61 6e 67 65 20 61 | 6e 64 20 4d 61 70 43 75 |Change a|nd MapCu|
|000061b0| 72 73 6f 72 20 28 36 2f | 39 2f 39 34 29 0d 09 59 |rsor (6/|9/94)..Y|
|000061c0| 6f 75 20 73 68 6f 75 6c | 64 20 61 76 6f 69 64 20 |ou shoul|d avoid |
|000061d0| 75 70 64 61 74 69 6e 67 | 20 61 20 73 6f 75 70 20 |updating| a soup |
|000061e0| 65 6e 74 72 79 20 77 69 | 74 68 20 45 6e 74 72 79 |entry wi|th Entry|
|000061f0| 43 68 61 6e 67 65 20 69 | 6e 73 69 64 65 20 61 20 |Change i|nside a |
|00006200| 4d 61 70 43 75 72 73 6f | 72 2e 20 55 6e 65 78 70 |MapCurso|r. Unexp|
|00006210| 65 63 74 65 64 20 72 65 | 73 75 6c 74 73 20 63 61 |ected re|sults ca|
|00006220| 6e 20 6f 63 63 75 72 20 | 69 66 20 79 6f 75 20 75 |n occur |if you u|
|00006230| 70 64 61 74 65 20 74 68 | 65 20 76 61 6c 75 65 20 |pdate th|e value |
|00006240| 6f 66 20 61 6e 20 69 6e | 64 65 78 65 64 20 73 6c |of an in|dexed sl|
|00006250| 6f 74 2e 20 54 68 65 20 | 45 6e 74 72 79 43 68 61 |ot. The |EntryCha|
|00006260| 6e 67 65 20 77 69 6c 6c | 20 63 61 75 73 65 20 74 |nge will| cause t|
|00006270| 68 65 20 63 75 72 73 6f | 72 20 74 6f 20 64 6f 20 |he curso|r to do |
|00006280| 61 20 47 6f 74 6f 28 45 | 6e 74 72 79 29 20 62 65 |a Goto(E|ntry) be|
|00006290| 66 6f 72 65 20 74 68 65 | 20 4d 61 70 43 75 72 73 |fore the| MapCurs|
|000062a0| 6f 72 20 65 78 65 63 75 | 74 65 73 20 74 68 65 20 |or execu|tes the |
|000062b0| 63 75 72 73 6f 72 3a 4e | 65 78 74 2e 20 54 68 69 |cursor:N|ext. Thi|
|000062c0| 73 20 63 61 6e 20 72 65 | 73 75 6c 74 20 69 6e 20 |s can re|sult in |
|000062d0| 73 6b 69 70 70 69 6e 67 | 20 63 75 72 73 6f 72 20 |skipping| cursor |
|000062e0| 65 6e 74 72 69 65 73 2e | 0d 09 57 65 20 72 65 63 |entries.|..We rec|
|000062f0| 6f 6d 6d 65 6e 64 20 74 | 68 61 74 20 79 6f 75 20 |ommend t|hat you |
|00006300| 61 76 6f 69 64 20 75 73 | 69 6e 67 20 45 6e 74 72 |avoid us|ing Entr|
|00006310| 79 43 68 61 6e 67 65 20 | 6f 72 20 6f 74 68 65 72 |yChange |or other|
|00006320| 77 69 73 65 20 6d 6f 64 | 69 66 79 69 6e 67 20 73 |wise mod|ifying s|
|00006330| 6f 75 70 20 65 6e 74 72 | 69 65 73 20 69 6e 73 69 |oup entr|ies insi|
|00006340| 64 65 20 6f 66 20 61 20 | 4d 61 70 43 75 72 73 6f |de of a |MapCurso|
|00006350| 72 2e 0d 09 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |r...____|________|
|00006360| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00006370| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00006380| 4e 45 57 3a 20 55 73 65 | 20 47 43 20 77 69 74 68 |NEW: Use| GC with|
|00006390| 20 52 65 6d 6f 76 65 49 | 6e 64 65 78 20 28 36 2f | RemoveI|ndex (6/|
|000063a0| 31 30 2f 39 34 29 0d 09 | 43 75 72 72 65 6e 74 6c |10/94)..|Currentl|
|000063b0| 79 20 74 68 65 20 73 79 | 73 74 65 6d 20 68 61 73 |y the sy|stem has|
|000063c0| 20 61 20 62 75 67 20 77 | 68 65 72 65 20 52 65 6d | a bug w|here Rem|
|000063d0| 6f 76 65 49 6e 64 65 78 | 20 64 6f 65 73 20 6e 6f |oveIndex| does no|
|000063e0| 74 20 73 75 63 63 65 65 | 64 20 69 6e 20 61 6c 6c |t succee|d in all|
|000063f0| 20 69 6e 73 74 61 6e 63 | 65 73 2c 20 66 6f 72 20 | instanc|es, for |
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.