/ APDL Public Domain 1 / APDL_PD1A.iso / program / thheap

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 41 72 63 68 69 76 65 00 | 90 00 00 00 54 03 00 00 |Archive.|....T...|
|00000010| 28 00 00 00 64 00 00 00 | 00 00 00 00 00 00 00 00 |(...d...|........|
|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 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000050| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000060| 82 21 48 65 6c 70 00 41 | 00 00 00 00 7d 0d 00 00 |.!Help.A|....}...|
|00000070| 46 ff ff ff ce 47 51 9b | 03 00 e4 12 7d 0d 00 00 |F....GQ.|....}...|
|00000080| 88 04 00 00 82 54 48 48 | 65 61 70 41 00 00 00 00 |.....THH|eapA....|
|00000090| 3c 01 00 00 46 fa ff ff | 10 ed 8c 93 03 00 d4 8f |<...F...|........|
|000000a0| 3c 01 00 00 24 00 00 00 | 82 54 48 48 65 61 70 52 |<...$...|.THHeapR|
|000000b0| 00 00 00 00 e0 02 00 00 | 46 fa ff ff 72 ed 8c 93 |........|F...r...|
|000000c0| 03 00 5b dc e0 02 00 00 | 84 01 00 00 00 00 00 00 |..[.....|........|
|000000d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000000e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000000f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000100| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000110| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000120| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000130| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000140| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000150| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000160| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000170| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000180| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000190| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000001a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000001b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000001c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000001d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000001e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000001f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000200| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000210| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000220| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000230| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000240| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000250| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000260| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000270| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000280| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000290| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000002a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000002b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000002c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000002d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000002e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000002f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000300| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000310| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000320| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000330| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000340| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000350| 00 00 00 00 46 69 6c 65 | 44 61 74 61 82 54 48 48 |....File|Data.THH|
|00000360| 65 61 70 41 00 00 00 00 | 3c 01 00 00 46 fa ff ff |eapA....|<...F...|
|00000370| 10 ed 8c 93 03 00 d4 8f | 00 00 00 00 00 00 00 00 |........|........|
|00000380| 00 00 00 00 00 00 00 00 | 2c 00 00 00 4c 00 00 00 |........|,...L...|
|00000390| 00 00 00 00 80 c6 04 00 | a0 00 00 00 68 00 00 00 |........|....h...|
|000003a0| 00 00 00 00 54 48 48 65 | 61 70 00 a9 20 54 6f 6e |....THHe|ap.. Ton|
|000003b0| 79 20 48 6f 75 67 68 74 | 6f 6e 2c 20 31 39 39 36 |y Hought|on, 1996|
|000003c0| 00 a8 5b e9 54 48 48 65 | 61 70 09 09 31 2e 30 30 |..[.THHe|ap..1.00|
|000003d0| 20 28 32 31 20 4a 61 6e | 20 31 39 39 36 29 00 e1 | (21 Jan| 1996)..|
|000003e0| 54 48 48 65 61 70 00 43 | 72 65 61 74 65 48 65 61 |THHeap.C|reateHea|
|000003f0| 70 00 52 65 6d 6f 76 65 | 48 65 61 70 00 43 6c 61 |p.Remove|Heap.Cla|
|00000400| 69 6d 00 46 72 65 65 00 | 53 69 7a 65 00 45 78 74 |im.Free.|Size.Ext|
|00000410| 65 6e 64 00 00 00 a0 e3 | 02 00 5b e3 14 00 00 0a |end.....|..[.....|
|00000420| 03 00 5b e3 17 00 00 0a | 04 00 5b e3 19 00 00 0a |..[.....|..[.....|
|00000430| 05 00 5b e3 19 00 00 0a | 01 00 5b e3 0b 00 00 0a |..[.....|..[.....|
|00000440| 00 00 5b e3 00 00 00 ca | 0e f0 a0 e1 10 00 8f e2 |..[.....|........|
|00000450| 00 10 a0 e3 00 20 a0 e3 | bc 40 4f e2 06 15 06 ef |..... ..|.@O.....|
|00000460| 01 f2 9e e3 e6 01 00 00 | 42 61 64 53 57 49 00 13 |........|BadSWI..|
|00000470| 0e f0 a0 e1 08 40 2d e9 | 01 30 a0 e1 06 00 a0 e3 |.....@-.|.0......|
|00000480| 1e 00 02 ef 08 80 bd e8 | 00 40 2d e9 07 00 a0 e3 |........|.@-.....|
|00000490| 1e 00 02 ef 00 80 bd e8 | 04 00 12 e5 0e f0 a0 e1 |........|........|
|000004a0| 00 40 2d e9 0d 00 a0 e3 | 01 30 a0 e1 1e 00 02 ef |.@-.....|.0......|
|000004b0| 00 80 bd e8 46 69 6c 65 | 44 61 74 61 82 54 48 48 |....File|Data.THH|
|000004c0| 65 61 70 52 00 00 00 00 | e0 02 00 00 46 fa ff ff |eapR....|....F...|
|000004d0| 72 ed 8c 93 03 00 5b dc | 00 00 00 00 00 00 00 00 |r.....[.|........|
|000004e0| 00 00 00 00 00 00 00 00 | 2c 00 00 00 4c 00 00 00 |........|,...L...|
|000004f0| 00 00 00 00 80 c6 04 00 | a0 00 00 00 68 00 00 00 |........|....h...|
|00000500| 00 00 00 00 54 48 48 65 | 61 70 00 a9 20 54 6f 6e |....THHe|ap.. Ton|
|00000510| 79 20 48 6f 75 67 68 74 | 6f 6e 2c 20 31 39 39 36 |y Hought|on, 1996|
|00000520| 00 00 00 00 54 48 48 65 | 61 70 09 09 31 2e 30 30 |....THHe|ap..1.00|
|00000530| 20 28 32 31 20 4a 61 6e | 20 31 39 39 36 29 00 00 | (21 Jan| 1996)..|
|00000540| 54 48 48 65 61 70 00 43 | 72 65 61 74 65 48 65 61 |THHeap.C|reateHea|
|00000550| 70 00 52 65 6d 6f 76 65 | 48 65 61 70 00 43 6c 61 |p.Remove|Heap.Cla|
|00000560| 69 6d 00 46 72 65 65 00 | 53 69 7a 65 00 45 78 74 |im.Free.|Size.Ext|
|00000570| 65 6e 64 00 00 20 20 20 | 02 00 5b e3 2d 00 00 0a |end..   |..[.-...|
|00000580| 03 00 5b e3 37 00 00 0a | 04 00 5b e3 3c 00 00 0a |..[.7...|..[.<...|
|00000590| 05 00 5b e3 40 00 00 0a | 01 00 5b e3 1e 00 00 0a |..[.@...|..[.....|
|000005a0| 00 00 5b e3 13 00 00 ca | fe 41 2d e9 00 80 a0 e1 |..[.....|.A-.....|
|000005b0| 00 00 a0 e3 00 10 e0 e3 | 28 20 a0 e3 01 30 a0 e1 |........|( ...0..|
|000005c0| 80 40 a0 e3 01 50 a0 e1 | 00 60 a0 e3 00 70 a0 e3 |.@...P..|.`...p..|
|000005d0| 66 00 02 ef fe 81 bd 68 | 00 10 83 e5 08 10 83 e2 |f......h|........|
|000005e0| 00 00 a0 e3 20 30 a0 e3 | 04 30 01 e5 1d 00 02 ef |.... 0..|.0......|
|000005f0| 01 00 a0 71 fe 81 bd e8 | 10 00 8f e2 00 10 a0 e3 |...q....|........|
|00000600| 00 20 a0 e3 42 4f 4f e2 | 06 15 06 ef 01 f2 9e e3 |. ..BOO.|........|
|00000610| e6 01 00 00 42 61 64 53 | 57 49 00 00 06 40 2d e9 |....BadS|WI...@-.|
|00000620| 00 20 a0 e1 08 10 10 e5 | 01 00 a0 e3 66 00 02 ef |. ......|....f...|
|00000630| 02 00 a0 71 06 80 bd e8 | 78 40 2d e9 00 40 a0 e1 |...q....|x@-..@..|
|00000640| 01 50 a0 e1 10 60 85 e2 | 23 00 00 eb 78 80 bd 68 |.P...`..|#...x..h|
|00000650| 02 00 a0 e3 04 10 a0 e1 | 05 30 a0 e1 1d 00 02 ef |........|.0......|
|00000660| 37 00 00 7b 78 80 bd e8 | 10 40 2d e9 00 40 a0 e1 |7..{x...|.@-..@..|
|00000670| 03 00 a0 e3 04 10 a0 e1 | 1d 00 02 ef 30 00 00 7b |........|....0..{|
|00000680| 10 80 bd e8 0a 40 2d e9 | 00 10 a0 e1 06 00 a0 e3 |.....@-.|........|
|00000690| 1d 00 02 ef 03 00 a0 71 | 0a 80 bd e8 f8 40 2d e9 |.......q|.....@-.|
|000006a0| 00 40 a0 e1 02 50 a0 e1 | 01 70 a0 e1 f4 ff ff eb |.@...P..|.p......|
|000006b0| 07 60 80 e0 10 60 86 e2 | 07 00 00 eb f8 80 bd 68 |.`...`..|.......h|
|000006c0| 04 00 a0 e3 04 10 a0 e1 | 05 20 a0 e1 07 30 a0 e1 |........|. ...0..|
|000006d0| 1d 00 02 ef 1a 00 00 7b | f8 80 bd e8 0e 40 2d e9 |.......{|.....@-.|
|000006e0| 01 00 a0 e3 04 10 a0 e1 | 1d 00 02 ef 0e 80 bd 68 |........|.......h|
|000006f0| 06 00 52 e1 0e 80 bd a8 | 04 20 14 e5 06 20 82 e0 |..R.....|. ... ..|
|00000700| 08 00 14 e5 25 00 00 eb | 0e 80 bd 68 02 00 50 e1 |....%...|...h..P.|
|00000710| 03 00 00 aa 00 10 42 e0 | 08 00 14 e5 2a 00 02 ef |......B.|....*...|
|00000720| 0e 40 bd 68 05 00 a0 e3 | 04 10 a0 e1 06 30 a0 e1 |.@.h....|.....0..|
|00000730| 1d 00 02 ef 04 20 11 75 | 03 20 82 70 04 20 01 75 |..... .u|. .p. .u|
|00000740| 0e 80 bd e8 0e 40 2d e9 | 01 00 a0 e3 04 10 a0 e1 |.....@-.|........|
|00000750| 1d 00 02 ef 0e 80 bd 68 | 00 30 72 e2 0e 80 bd 08 |.......h|.0r.....|
|00000760| 05 00 a0 e3 1d 00 02 ef | 00 00 53 e3 0e 80 bd 08 |........|..S.....|
|00000770| 04 20 14 e5 03 20 82 e0 | 04 20 04 e5 08 00 14 e5 |. ... ..|. ......|
|00000780| 06 00 00 eb 0e 80 bd 68 | 08 20 82 e2 00 10 52 e0 |.......h|. ....R.|
|00000790| 0e 80 bd a8 08 00 14 e5 | 2a 00 02 ef 0e 80 bd e8 |........|*.......|
|000007a0| fe 41 2d e9 00 10 a0 e1 | 02 00 a0 e3 66 00 02 ef |.A-.....|....f...|
|000007b0| 02 00 a0 71 fe 81 bd e8 | 46 69 6c 65 44 61 74 61 |...q....|FileData|
|000007c0| 82 21 48 65 6c 70 00 41 | 00 00 00 00 7d 0d 00 00 |.!Help.A|....}...|
|000007d0| 46 ff ff ff ce 47 51 9b | 03 00 e4 12 54 48 48 65 |F....GQ.|....THHe|
|000007e0| 61 70 0a 3d 3d 3d 3d 3d | 3d 0a 62 79 3a 0a 0a 54 |ap.=====|=.by:..T|
|000007f0| 6f 6e 79 20 48 6f 75 67 | 68 74 6f 6e 0a 32 37 31 |ony Houg|hton.271|
|00000800| 20 55 70 70 65 72 20 57 | 65 73 74 6f 6e 20 4c 61 | Upper W|eston La|
|00000810| 6e 65 0a 53 6f 75 74 68 | 61 6d 70 74 6f 6e 0a 53 |ne.South|ampton.S|
|00000820| 4f 31 39 20 39 48 59 0a | 0a 45 6d 61 69 6c 3a 20 |O19 9HY.|.Email: |
|00000830| 74 6f 6e 79 68 40 74 63 | 70 2e 63 6f 2e 75 6b 0a |tonyh@tc|p.co.uk.|
|00000840| 57 57 57 3a 20 20 20 68 | 74 74 70 3a 2f 2f 77 77 |WWW:   h|ttp://ww|
|00000850| 77 2e 74 63 70 2e 63 6f | 2e 75 6b 2f 7e 74 6f 6e |w.tcp.co|.uk/~ton|
|00000860| 79 68 2f 0a 0a 44 65 73 | 63 72 69 70 74 69 6f 6e |yh/..Des|cription|
|00000870| 0a 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 0a 54 48 48 |.-------|----.THH|
|00000880| 65 61 70 20 69 73 20 61 | 20 70 61 69 72 20 6f 66 |eap is a| pair of|
|00000890| 20 6d 6f 64 75 6c 65 73 | 20 74 6f 20 70 72 6f 76 | modules| to prov|
|000008a0| 69 64 65 20 6d 65 6d 6f | 72 79 20 6d 61 6e 61 67 |ide memo|ry manag|
|000008b0| 65 6d 65 6e 74 20 77 69 | 74 68 20 61 20 70 72 6f |ement wi|th a pro|
|000008c0| 67 72 61 6d 6d 65 72 73 | 27 0a 69 6e 74 65 72 66 |grammers|'.interf|
|000008d0| 61 63 65 20 63 6f 6e 73 | 69 73 74 65 6e 74 20 61 |ace cons|istent a|
|000008e0| 63 72 6f 73 73 20 52 49 | 53 43 20 4f 53 20 33 2e |cross RI|SC OS 3.|
|000008f0| 31 20 61 6e 64 20 6c 61 | 74 65 72 20 76 65 72 73 |1 and la|ter vers|
|00000900| 69 6f 6e 73 2e 20 54 48 | 48 65 61 70 41 20 77 69 |ions. TH|HeapA wi|
|00000910| 6c 6c 0a 77 6f 72 6b 20 | 6f 6e 20 61 6c 6c 20 76 |ll.work |on all v|
|00000920| 65 72 73 69 6f 6e 73 20 | 6f 66 20 52 49 53 43 20 |ersions |of RISC |
|00000930| 4f 53 20 b9 20 61 6e 64 | 20 54 48 48 65 61 70 52 |OS . and| THHeapR|
|00000940| 20 69 73 20 6f 6e 6c 79 | 20 66 6f 72 20 75 73 65 | is only| for use|
|00000950| 20 77 69 74 68 20 52 49 | 53 43 20 4f 53 0a 33 2e | with RI|SC OS.3.|
|00000960| 35 20 6f 72 20 6c 61 74 | 65 72 2e 0a 0a 4d 65 6d |5 or lat|er...Mem|
|00000970| 6f 72 79 20 6d 61 6e 61 | 67 65 6d 65 6e 74 20 69 |ory mana|gement i|
|00000980| 73 20 69 6d 70 6c 65 6d | 65 6e 74 65 64 20 62 79 |s implem|ented by|
|00000990| 20 4f 53 5f 48 65 61 70 | 20 77 69 74 68 20 74 68 | OS_Heap| with th|
|000009a0| 65 20 54 48 48 65 61 70 | 20 6d 6f 64 75 6c 65 20 |e THHeap| module |
|000009b0| 68 61 6e 64 6c 69 6e 67 | 0a 70 6c 61 63 65 6d 65 |handling|.placeme|
|000009c0| 6e 74 20 61 6e 64 20 6f | 76 65 72 61 6c 6c 20 73 |nt and o|verall s|
|000009d0| 69 7a 65 20 6f 66 20 74 | 68 65 20 68 65 61 70 2e |ize of t|he heap.|
|000009e0| 20 54 48 48 65 61 70 41 | 20 61 63 68 69 65 76 65 | THHeapA| achieve|
|000009f0| 73 20 74 68 69 73 20 62 | 79 20 70 61 73 73 69 6e |s this b|y passin|
|00000a00| 67 0a 63 61 6c 6c 73 20 | 6f 6e 20 74 6f 20 4f 53 |g.calls |on to OS|
|00000a10| 5f 4d 6f 64 75 6c 65 20 | 77 68 69 6c 65 20 54 48 |_Module |while TH|
|00000a20| 48 65 61 70 52 20 75 73 | 65 73 20 64 79 6e 61 6d |HeapR us|es dynam|
|00000a30| 69 63 20 61 72 65 61 73 | 2e 20 45 61 63 68 20 53 |ic areas|. Each S|
|00000a40| 57 49 20 68 61 73 20 61 | 0a 70 61 72 61 6d 65 74 |WI has a|.paramet|
|00000a50| 65 72 20 66 6f 72 20 75 | 73 65 20 62 79 20 74 68 |er for u|se by th|
|00000a60| 65 20 64 79 6e 61 6d 69 | 63 20 61 72 65 61 20 73 |e dynami|c area s|
|00000a70| 79 73 74 65 6d 3b 20 54 | 48 48 65 61 70 41 20 69 |ystem; T|HHeapA i|
|00000a80| 67 6e 6f 72 65 73 20 74 | 68 65 73 65 2c 20 73 6f |gnores t|hese, so|
|00000a90| 20 69 66 0a 79 6f 75 20 | 61 72 65 20 75 6e 61 62 | if.you |are unab|
|00000aa0| 6c 65 20 74 6f 20 74 65 | 73 74 20 79 6f 75 72 20 |le to te|st your |
|00000ab0| 70 72 6f 67 72 61 6d 73 | 20 77 69 74 68 20 54 48 |programs| with TH|
|00000ac0| 48 65 61 70 52 20 74 61 | 6b 65 20 63 61 72 65 20 |HeapR ta|ke care |
|00000ad0| 74 68 61 74 20 79 6f 75 | 20 61 72 65 0a 75 73 69 |that you| are.usi|
|00000ae0| 6e 67 20 74 68 65 73 65 | 20 70 61 72 61 6d 65 74 |ng these| paramet|
|00000af0| 65 72 73 20 63 6f 72 72 | 65 63 74 6c 79 2e 0a 0a |ers corr|ectly...|
|00000b00| 54 48 48 65 61 70 41 20 | 64 6f 65 73 20 6e 6f 74 |THHeapA |does not|
|00000b10| 20 64 69 73 74 69 6e 67 | 75 69 73 68 20 62 65 74 | disting|uish bet|
|00000b20| 77 65 65 6e 20 64 69 66 | 66 65 72 65 6e 74 20 68 |ween dif|ferent h|
|00000b30| 65 61 70 73 20 79 6f 75 | 20 74 65 6c 6c 20 69 74 |eaps you| tell it|
|00000b40| 20 61 62 6f 75 74 2c 20 | 61 6c 6c 0a 62 6c 6f 63 | about, |all.bloc|
|00000b50| 6b 73 20 61 72 65 20 70 | 6c 61 63 65 64 20 69 6e |ks are p|laced in|
|00000b60| 20 74 68 65 20 52 4d 41 | 2c 20 6d 69 78 65 64 20 | the RMA|, mixed |
|00000b70| 77 69 74 68 20 62 6c 6f | 63 6b 73 20 75 73 65 64 |with blo|cks used|
|00000b80| 20 62 79 20 6f 74 68 65 | 72 20 70 72 6f 67 72 61 | by othe|r progra|
|00000b90| 6d 73 2e 0a 54 68 65 72 | 65 66 6f 72 65 20 61 6c |ms..Ther|efore al|
|00000ba0| 77 61 79 73 20 66 72 65 | 65 20 65 61 63 68 20 62 |ways fre|e each b|
|00000bb0| 6c 6f 63 6b 20 79 6f 75 | 20 75 73 65 20 69 6e 64 |lock you| use ind|
|00000bc0| 69 76 69 64 75 61 6c 6c | 79 20 75 6e 6c 65 73 73 |ividuall|y unless|
|00000bd0| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 69 73 | your pr|ogram is|
|00000be0| 0a 67 75 61 72 61 6e 74 | 65 65 64 20 6f 6e 6c 79 |.guarant|eed only|
|00000bf0| 20 74 6f 20 75 73 65 20 | 54 48 48 65 61 70 52 2e | to use |THHeapR.|
|00000c00| 20 54 48 48 65 61 70 52 | 20 63 61 6e 20 63 72 65 | THHeapR| can cre|
|00000c10| 61 74 65 20 61 73 20 6d | 61 6e 79 20 64 69 66 66 |ate as m|any diff|
|00000c20| 65 72 65 6e 74 20 68 65 | 61 70 73 0a 61 73 20 79 |erent he|aps.as y|
|00000c30| 6f 75 20 6c 69 6b 65 2c | 20 77 69 74 68 69 6e 20 |ou like,| within |
|00000c40| 61 6e 79 20 6c 69 6d 69 | 74 73 20 69 6d 70 6f 73 |any limi|ts impos|
|00000c50| 65 64 20 62 79 20 66 72 | 65 65 20 6d 65 6d 6f 72 |ed by fr|ee memor|
|00000c60| 79 20 61 6e 64 20 6e 75 | 6d 62 65 72 20 6f 66 20 |y and nu|mber of |
|00000c70| 61 72 65 61 73 0a 74 68 | 65 20 4f 53 20 77 69 6c |areas.th|e OS wil|
|00000c80| 6c 20 70 65 72 6d 69 74 | 2e 20 52 65 6d 6f 76 69 |l permit|. Removi|
|00000c90| 6e 67 20 61 20 68 65 61 | 70 20 77 69 6c 6c 20 69 |ng a hea|p will i|
|00000ca0| 6d 70 6c 69 63 69 74 6c | 79 20 66 72 65 65 20 61 |mplicitl|y free a|
|00000cb0| 6c 6c 20 74 68 65 20 62 | 6c 6f 63 6b 73 20 69 6e |ll the b|locks in|
|00000cc0| 0a 69 74 2c 20 62 75 74 | 20 64 6f 20 6e 6f 74 20 |.it, but| do not |
|00000cd0| 72 65 6c 79 20 6f 6e 20 | 74 68 69 73 20 69 6e 20 |rely on |this in |
|00000ce0| 63 61 73 65 20 79 6f 75 | 20 61 72 65 20 75 73 69 |case you| are usi|
|00000cf0| 6e 67 20 54 48 48 65 61 | 70 41 2e 0a 0a 43 6f 6e |ng THHea|pA...Con|
|00000d00| 64 69 74 69 6f 6e 73 20 | 6f 66 20 75 73 65 0a 2d |ditions |of use.-|
|00000d10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000d20| 0a 54 48 48 65 61 70 20 | 6d 61 79 20 62 65 20 66 |.THHeap |may be f|
|00000d30| 72 65 65 6c 79 20 64 69 | 73 74 72 69 62 75 74 65 |reely di|stribute|
|00000d40| 64 2e 20 49 74 20 6d 61 | 79 20 62 65 20 75 73 65 |d. It ma|y be use|
|00000d50| 64 20 69 6e 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |d in app|lication|
|00000d60| 73 20 70 72 6f 76 69 64 | 65 64 20 69 74 0a 69 73 |s provid|ed it.is|
|00000d70| 20 75 6e 61 6c 74 65 72 | 65 64 20 61 6e 64 20 79 | unalter|ed and y|
|00000d80| 6f 75 20 63 72 65 64 69 | 74 20 6d 65 2c 20 74 68 |ou credi|t me, th|
|00000d90| 65 20 61 75 74 68 6f 72 | 2e 20 49 66 20 70 6f 73 |e author|. If pos|
|00000da0| 73 69 62 6c 65 2c 20 70 | 6c 65 61 73 65 20 69 6e |sible, p|lease in|
|00000db0| 63 6c 75 64 65 20 74 68 | 69 73 0a 66 69 6c 65 20 |clude th|is.file |
|00000dc0| 77 69 74 68 20 69 74 20 | 28 49 20 6b 6e 6f 77 20 |with it |(I know |
|00000dd0| 74 68 61 74 20 77 6f 6e | 27 74 20 61 6c 77 61 79 |that won|'t alway|
|00000de0| 73 20 62 65 20 70 6f 73 | 73 69 62 6c 65 29 2c 20 |s be pos|sible), |
|00000df0| 6f 72 20 61 74 20 6c 65 | 61 73 74 20 69 6e 64 69 |or at le|ast indi|
|00000e00| 63 61 74 65 0a 74 68 61 | 74 20 69 74 20 69 73 20 |cate.tha|t it is |
|00000e10| 61 76 61 69 6c 61 62 6c | 65 20 77 69 74 68 20 69 |availabl|e with i|
|00000e20| 6e 73 74 72 75 63 74 69 | 6f 6e 73 20 66 72 6f 6d |nstructi|ons from|
|00000e30| 20 50 44 20 6c 69 62 72 | 61 72 69 65 73 2e 20 41 | PD libr|aries. A|
|00000e40| 73 20 61 20 63 6f 75 72 | 74 65 73 79 20 69 74 0a |s a cour|tesy it.|
|00000e50| 77 6f 75 6c 64 20 62 65 | 20 76 65 72 79 20 6e 69 |would be| very ni|
|00000e60| 63 65 20 69 66 20 79 6f | 75 20 73 65 6e 64 20 6d |ce if yo|u send m|
|00000e70| 65 20 63 6f 70 69 65 73 | 20 6f 66 20 61 6e 79 20 |e copies| of any |
|00000e80| 70 72 6f 67 72 61 6d 73 | 20 79 6f 75 20 77 72 69 |programs| you wri|
|00000e90| 74 65 20 77 68 69 63 68 | 20 75 73 65 0a 69 74 2e |te which| use.it.|
|00000ea0| 0a 0a b9 20 54 68 65 20 | 6d 6f 64 75 6c 65 73 20 |... The |modules |
|00000eb0| 68 61 76 65 20 6f 6e 6c | 79 20 62 65 65 6e 20 74 |have onl|y been t|
|00000ec0| 65 73 74 65 64 20 6f 6e | 20 52 49 53 43 20 4f 53 |ested on| RISC OS|
|00000ed0| 20 33 2e 31 20 61 6e 64 | 20 52 49 53 43 20 4f 53 | 3.1 and| RISC OS|
|00000ee0| 20 33 2e 36 20 62 75 74 | 20 74 68 65 72 65 0a 20 | 3.6 but| there. |
|00000ef0| 20 69 73 20 6e 6f 20 72 | 65 61 73 6f 6e 20 77 68 | is no r|eason wh|
|00000f00| 79 20 74 68 65 79 20 73 | 68 6f 75 6c 64 20 6e 6f |y they s|hould no|
|00000f10| 74 20 77 6f 72 6b 20 6f | 6e 20 6f 74 68 65 72 20 |t work o|n other |
|00000f20| 76 65 72 73 69 6f 6e 73 | 2e 0a 20 20 0a 4c 6f 61 |versions|..  .Loa|
|00000f30| 64 69 6e 67 20 74 68 65 | 20 6d 6f 64 75 6c 65 73 |ding the| modules|
|00000f40| 0a 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |.-------|--------|
|00000f50| 2d 2d 2d 2d 0a 49 74 20 | 69 73 20 72 65 63 6f 6d |----.It |is recom|
|00000f60| 6d 65 6e 64 65 64 20 74 | 68 61 74 20 74 68 65 20 |mended t|hat the |
|00000f70| 4f 62 65 79 20 66 69 6c | 65 20 73 65 71 75 65 6e |Obey fil|e sequen|
|00000f80| 63 65 20 74 6f 20 6c 6f | 61 64 20 54 48 48 65 61 |ce to lo|ad THHea|
|00000f90| 70 20 69 73 20 62 61 73 | 65 64 20 6f 6e 20 74 68 |p is bas|ed on th|
|00000fa0| 65 0a 66 6f 6c 6c 6f 77 | 69 6e 67 3a 0a 0a 53 65 |e.follow|ing:..Se|
|00000fb0| 74 20 41 70 70 4e 61 6d | 65 24 54 48 48 65 61 70 |t AppNam|e$THHeap|
|00000fc0| 20 3c 41 70 70 24 44 69 | 72 3e 2e 54 48 48 65 61 | <App$Di|r>.THHea|
|00000fd0| 70 52 0a 52 4d 45 6e 73 | 75 72 65 20 55 74 69 6c |pR.RMEns|ure Util|
|00000fe0| 69 74 79 4d 6f 64 75 6c | 65 20 33 2e 35 30 20 53 |ityModul|e 3.50 S|
|00000ff0| 65 74 20 41 70 70 4e 61 | 6d 65 24 54 48 48 65 61 |et AppNa|me$THHea|
|00001000| 70 20 3c 41 70 70 24 44 | 69 72 3e 2e 54 48 48 65 |p <App$D|ir>.THHe|
|00001010| 61 70 41 0a 52 4d 45 6e | 73 75 72 65 20 54 48 48 |apA.RMEn|sure THH|
|00001020| 65 61 70 20 31 2e 30 30 | 20 52 4d 4c 6f 61 64 20 |eap 1.00| RMLoad |
|00001030| 3c 41 70 70 6e 61 6d 65 | 24 54 48 65 61 70 3e 0a |<Appname|$THeap>.|
|00001040| 55 6e 73 65 74 20 41 70 | 70 4e 61 6d 65 24 54 48 |Unset Ap|pName$TH|
|00001050| 48 65 61 70 0a 0a 54 65 | 63 68 6e 69 63 61 6c 20 |Heap..Te|chnical |
|00001060| 64 65 74 61 69 6c 73 0a | 3d 3d 3d 3d 3d 3d 3d 3d |details.|========|
|00001070| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 0a 54 48 48 65 61 70 |========|=.THHeap|
|00001080| 27 73 20 53 57 49 20 63 | 68 75 6e 6b 20 69 73 20 |'s SWI c|hunk is |
|00001090| 26 34 43 36 38 30 20 28 | 6f 66 66 69 63 69 61 6c |&4C680 (|official|
|000010a0| 6c 79 20 61 6c 6c 6f 63 | 61 74 65 64 20 62 79 20 |ly alloc|ated by |
|000010b0| 50 69 6e 65 61 70 70 6c | 65 29 2e 0a 0a 53 57 49 |Pineappl|e)...SWI|
|000010c0| 27 73 0a 2d 2d 2d 2d 2d | 0a 54 48 48 65 61 70 5f |'s.-----|.THHeap_|
|000010d0| 43 72 65 61 74 65 48 65 | 61 70 09 09 26 34 63 36 |CreateHe|ap..&4c6|
|000010e0| 38 30 0a 09 45 6e 74 72 | 79 3a 09 52 30 20 3d 3e |80..Entr|y:.R0 =>|
|000010f0| 09 4e 61 6d 65 20 74 6f | 20 67 69 76 65 20 64 79 |.Name to| give dy|
|00001100| 6e 61 6d 69 63 20 61 72 | 65 61 0a 09 45 78 69 74 |namic ar|ea..Exit|
|00001110| 3a 09 52 30 20 3d 20 09 | 48 65 61 70 20 72 65 66 |:.R0 = .|Heap ref|
|00001120| 65 72 65 6e 63 65 20 28 | 27 68 61 6e 64 6c 65 27 |erence (|'handle'|
|00001130| 29 0a 0a 52 65 73 74 72 | 69 63 74 20 74 68 65 20 |)..Restr|ict the |
|00001140| 64 79 6e 61 6d 69 63 20 | 61 72 65 61 20 6e 61 6d |dynamic |area nam|
|00001150| 65 20 74 6f 20 61 20 6c | 65 6e 67 74 68 20 73 75 |e to a l|ength su|
|00001160| 69 74 61 62 6c 65 20 66 | 6f 72 20 74 68 65 20 54 |itable f|or the T|
|00001170| 61 73 6b 20 4d 61 6e 61 | 67 65 72 0a 77 69 6e 64 |ask Mana|ger.wind|
|00001180| 6f 77 2e 20 55 73 65 20 | 74 68 65 20 72 65 74 75 |ow. Use |the retu|
|00001190| 72 6e 65 64 20 68 61 6e | 64 6c 65 20 69 6e 20 61 |rned han|dle in a|
|000011a0| 6c 6c 20 73 75 62 73 65 | 71 75 65 6e 74 20 63 61 |ll subse|quent ca|
|000011b0| 6c 6c 73 20 75 73 69 6e | 67 20 74 68 69 73 20 68 |lls usin|g this h|
|000011c0| 65 61 70 2e 0a 0a 54 48 | 48 65 61 70 5f 52 65 6d |eap...TH|Heap_Rem|
|000011d0| 6f 76 65 48 65 61 70 0a | 09 45 6e 74 72 79 3a 20 |oveHeap.|.Entry: |
|000011e0| 20 52 30 20 3d 09 48 65 | 61 70 20 72 65 66 65 72 | R0 =.He|ap refer|
|000011f0| 65 6e 63 65 0a 09 45 78 | 69 74 3a 20 20 20 52 30 |ence..Ex|it:   R0|
|00001200| 09 50 72 65 73 65 72 76 | 65 64 0a 0a 52 65 6d 6f |.Preserv|ed..Remo|
|00001210| 76 65 73 20 61 20 70 72 | 65 76 69 6f 75 73 6c 79 |ves a pr|eviously|
|00001220| 20 63 72 65 61 74 65 64 | 20 68 65 61 70 2e 0a 0a | created| heap...|
|00001230| 54 48 48 65 61 70 5f 43 | 6c 61 69 6d 0a 09 45 6e |THHeap_C|laim..En|
|00001240| 74 72 79 3a 20 20 52 30 | 20 3d 09 48 65 61 70 20 |try:  R0| =.Heap |
|00001250| 72 65 66 65 72 65 6e 63 | 65 0a 09 09 52 31 20 3d |referenc|e...R1 =|
|00001260| 09 52 65 71 75 69 72 65 | 64 20 73 69 7a 65 0a 09 |.Require|d size..|
|00001270| 45 78 69 74 3a 09 52 30 | 2d 52 31 09 43 6f 72 72 |Exit:.R0|-R1.Corr|
|00001280| 75 70 74 65 64 0a 09 09 | 52 32 20 3d 3e 09 4e 65 |upted...|R2 =>.Ne|
|00001290| 77 20 62 6c 6f 63 6b 0a | 0a 43 6c 61 69 6d 73 20 |w block.|.Claims |
|000012a0| 61 20 62 6c 6f 63 6b 20 | 69 6e 20 61 20 68 65 61 |a block |in a hea|
|000012b0| 70 2e 0a 0a 54 48 48 65 | 61 70 5f 46 72 65 65 0a |p...THHe|ap_Free.|
|000012c0| 09 45 6e 74 72 79 3a 09 | 52 30 20 3d 09 48 65 61 |.Entry:.|R0 =.Hea|
|000012d0| 70 20 72 65 66 65 72 65 | 6e 63 65 0a 09 09 52 32 |p refere|nce...R2|
|000012e0| 20 3d 3e 09 42 6c 6f 63 | 6b 0a 09 45 78 69 74 3a | =>.Bloc|k..Exit:|
|000012f0| 09 52 30 2d 52 32 09 43 | 6f 72 72 75 70 74 65 64 |.R0-R2.C|orrupted|
|00001300| 0a 0a 46 72 65 65 73 20 | 61 20 70 72 65 76 69 6f |..Frees |a previo|
|00001310| 75 73 6c 79 20 63 6c 61 | 69 6d 65 64 20 68 65 61 |usly cla|imed hea|
|00001320| 70 2e 0a 0a 54 48 48 65 | 61 70 5f 53 69 7a 65 0a |p...THHe|ap_Size.|
|00001330| 09 45 6e 74 72 79 3a 09 | 52 30 20 3d 09 48 65 61 |.Entry:.|R0 =.Hea|
|00001340| 70 20 72 65 66 65 72 65 | 6e 63 65 0a 09 09 52 32 |p refere|nce...R2|
|00001350| 20 3d 3e 09 42 6c 6f 63 | 6b 0a 09 45 78 69 74 3a | =>.Bloc|k..Exit:|
|00001360| 09 52 30 20 3d 09 53 69 | 7a 65 0a 09 09 52 31 2d |.R0 =.Si|ze...R1-|
|00001370| 52 32 20 50 72 65 73 65 | 72 76 65 64 0a 0a 52 65 |R2 Prese|rved..Re|
|00001380| 74 75 72 6e 73 20 74 68 | 65 20 73 69 7a 65 20 6f |turns th|e size o|
|00001390| 66 20 61 20 62 6c 6f 63 | 6b 2e 20 54 68 69 73 20 |f a bloc|k. This |
|000013a0| 69 73 20 6e 6f 74 20 67 | 75 61 72 61 6e 74 65 65 |is not g|uarantee|
|000013b0| 64 20 74 6f 20 77 6f 72 | 6b 20 66 6f 72 20 54 48 |d to wor|k for TH|
|000013c0| 48 65 61 70 41 20 6f 6e | 0a 66 75 74 75 72 65 20 |HeapA on|.future |
|000013d0| 76 65 72 73 69 6f 6e 73 | 20 6f 66 20 74 68 65 20 |versions| of the |
|000013e0| 4f 53 3b 20 61 6c 77 61 | 79 73 20 75 73 65 20 54 |OS; alwa|ys use T|
|000013f0| 48 48 65 61 70 52 20 69 | 66 20 64 79 6e 61 6d 69 |HHeapR i|f dynami|
|00001400| 63 20 61 72 65 61 73 20 | 61 72 65 0a 73 75 70 70 |c areas |are.supp|
|00001410| 6f 72 74 65 64 2e 0a 0a | 54 48 48 65 61 70 5f 45 |orted...|THHeap_E|
|00001420| 78 74 65 6e 64 0a 09 45 | 6e 74 72 79 3a 09 52 30 |xtend..E|ntry:.R0|
|00001430| 20 3d 09 48 65 61 70 20 | 72 65 66 65 72 65 6e 63 | =.Heap |referenc|
|00001440| 65 0a 09 09 52 31 20 3d | 09 52 65 71 75 69 72 65 |e...R1 =|.Require|
|00001450| 64 20 63 68 61 6e 67 65 | 20 69 6e 20 73 69 7a 65 |d change| in size|
|00001460| 0a 09 09 52 32 20 3d 3e | 09 42 6c 6f 63 6b 0a 09 |...R2 =>|.Block..|
|00001470| 45 78 69 74 3a 09 52 30 | 2d 52 31 09 43 6f 72 72 |Exit:.R0|-R1.Corr|
|00001480| 75 70 74 65 64 0a 09 09 | 52 32 20 3d 3e 09 4e 65 |upted...|R2 =>.Ne|
|00001490| 77 20 62 6c 6f 63 6b 0a | 0a 45 78 74 65 6e 64 73 |w block.|.Extends|
|000014a0| 20 61 20 70 72 65 76 69 | 75 73 6c 79 20 63 6c 61 | a previ|usly cla|
|000014b0| 69 6d 65 64 20 62 6c 6f | 63 6b 2e 20 54 68 69 73 |imed blo|ck. This|
|000014c0| 20 6d 61 79 20 63 61 75 | 73 65 20 74 68 65 20 62 | may cau|se the b|
|000014d0| 6c 6f 63 6b 20 74 6f 20 | 6d 6f 76 65 2c 20 73 6f |lock to |move, so|
|000014e0| 20 69 74 73 0a 6e 65 77 | 20 61 64 64 72 65 73 73 | its.new| address|
|000014f0| 20 69 73 20 72 65 74 75 | 72 6e 65 64 2e 20 49 66 | is retu|rned. If|
|00001500| 20 69 74 20 6d 6f 76 65 | 73 20 69 74 73 20 64 61 | it move|s its da|
|00001510| 74 61 20 77 69 6c 6c 20 | 62 65 20 63 6f 70 69 65 |ta will |be copie|
|00001520| 64 20 74 6f 20 74 68 65 | 20 6e 65 77 0a 61 64 64 |d to the| new.add|
|00001530| 72 65 73 73 20 66 6f 72 | 20 79 6f 75 20 62 79 20 |ress for| you by |
|00001540| 74 68 65 20 4f 53 20 62 | 65 66 6f 72 65 20 72 65 |the OS b|efore re|
|00001550| 74 75 72 6e 69 6e 67 2e | 0a                      |turning.|.       |
+--------+-------------------------+-------------------------+--------+--------+