TidyHeap Release 2

These are actions you can use right out of the box.

1. TActionBreakOnDelete:
   This action is meant to be a TTidyHeapBlock's delete action. This basically calls DebugStr and logs the break to Logf. You can see when a specific block is being deleted this way.
2. TActionMakeNewFail:
   This action will cause new to fail when new is called x times. Send the count you want to fail into the constructor. This needs to be a global new action.
3. TActionIncrementalNewFailer:
   #include "UActionIncrementalNewFailer.h"

   This action causes new to fail incrementally.

   Each time a TActionIncrementalNewFailer is instantiated, it saves an incremented by one count out to a MPW text file. TidyHeap saves this number as text so that you can edit it with MPW and when TidyHeap loads it in the next time it converts the text to a number and then will new will fail at that number. This text file is called 'YourApplication.cnt' and is saved in the default location. This should be a global new action.

4. TActionDoubleDeleteWatcher
   This action causes all affected blocks to never be deleted so that we can safely look for doubly deleted blocks (Obviously, this is a debugging tool that shouldn't be run with all the time ;-). When the user calls delete TWhateverClass the block is checked for its delete flag, if it has already been deleted, and error will be logged. The block will still not be deleted.

   This can either be a global new or delete action, or it can be attached to a specific block as a delete action to test for double deletes on a specific block.

5. TActionVerifyAll
   This action causes *ALL* blocks to be verified when the action is told to perform. This can be any type of action.
6. TActionVerifyBlock
   This action verifies the current block being operated on. This can be any type of action.
7. TActionBreakOnNew
   This action will break into MacsBugs when the block with the specified ID is created. The ID is specified by a parameter in it's constructor.
8. TActionExemptBlocks
   This action exempts blocks from being reported as leaking. You can send in a ID value when creating this action which will specify the last block ID to ignore. The follow example will exempt blocks from the current ID, which is assumed to be less than 50, through block ID 50. Sending in zero (the default) exempts all blocks. Note that you can create the action and keep a pointer to the action around and when done exempting blocks, you can call "RemoveNewAction". This is an alternate method of exempting a 'range' of blocks.

   For Example:

   TTidyHeap::Instance()->AquireNewAction( new TActionExemptBlocks ( 50 ));

    

Example:
...
TTidyHeapState mySnapShot;
DoSomethingThatMayLeak();
long myNumLeakedBlocks = mySnapShot.Verify();

------------------
| 0xF1F1F1F1     | <-- Marker1
| 0xXXXXXXXX     | --> Pointer to block's TTidyHeapBlock
| 0xF2F2F2F2     | <-- Marker2
|----------------|
| Client Data    |
|                |
|----------------|
| 0xF3F3F3F3     | <-- Marker3
------------------

typedef struct BlockHeader
{
    TTidyHeapMarker fMarker1;
    TTidyHeapBlock* fBlockPtr;
    TTidyHeapMarker fMarker2;
};

typedef struct BlockTrailer
{
    TTidyHeapMarker fMarker3;
};