Location:
e32base.h
Link against: euser.lib
class CCleanup : public CBase;
Implements the cleanup stack.
An object of this type is created and used by the cleanup stack interface, CTrapCleanup
.
CBase
- Base class for all classes to be instantiated on the heap
CCleanup
- Implements the cleanup stack
Defined in CCleanup
:
CCleanup()
, Check()
, DoPop()
, DoPopAll()
, New()
, NewL()
, NextLevel()
, Pop()
, Pop()
, PopAll()
, PopAndDestroy()
, PopAndDestroy()
, PopAndDestroyAll()
, PreviousLevel()
, PushL()
, PushL()
, PushL()
, iBase
, iNext
, iTop
, ~CCleanup()
Inherited from CBase
:
Delete()
,
Extension_()
,
operator new()
static IMPORT_C CCleanup *NewL();
Creates a new cleanup stack object, and leaves if there is insufficient memory to create it.
The cleanup stack itself is allocated with enough space initially to hold a number of stack items.
|
IMPORT_C ~CCleanup();
Destructor.
Pops and destroys all items from the cleanup stack and then destroys the cleanup stack itself.
static IMPORT_C CCleanup *New();
Creates a new cleanup stack object.
The cleanup stack itself is allocated with enough space initially to hold a number of stack items.
|
IMPORT_C void PreviousLevel();
Goes to the previous cleanup level.
|
IMPORT_C void PushL(TAny *aPtr);
Pushes a cleanup item onto the cleanup stack.
The cleanup item represents an operation that frees the specified heap cell.
|
IMPORT_C void PushL(CBase *anObject);
Pushes a cleanup item onto the cleanup stack.
The cleanup item represents an operation that deletes the specified CBase
derived object.
|
IMPORT_C void PushL(TCleanupItem anItem);
Pushes a cleanup item onto the cleanup stack.
The cleanup item represents a call back operation that performs the required cleanup.
|
IMPORT_C void Pop();
Pops a single cleanup item from the cleanup stack.
|
IMPORT_C void Pop(TInt aCount);
Pops the specified number of cleanup items from the cleanup stack.
|
|
IMPORT_C void PopAll();
Pops all cleanup items at the current level, and then decrements the level.
IMPORT_C void PopAndDestroy();
Pops a single cleanup item from the cleanup stack, and invokes its cleanup operation.
|
IMPORT_C void PopAndDestroy(TInt aCount);
Pops the specified number of cleanup items from the cleanup stack, and invokes their cleanup operations.
|
|
IMPORT_C void PopAndDestroyAll();
Pops all cleanup items at the current level, invokes their cleanup operations and then decrements the level.
IMPORT_C void Check(TAny *aExpectedItem);
Checks that the cleanup item at the top of the cleanup stack represents a cleanup operation for the specified object.
|
protected: IMPORT_C void DoPop(TInt aCount, TBool aDestroy);
Provides an implementation for Pop()
and PopAndDestroy()
.
|
protected: IMPORT_C void DoPopAll(TBool aDestroy);
Provides an implementation for PopAll()
and PopAndDestroyAll()
.
|
protected: TCleanupStackItem * iNext;
Pointer to the next availaible slot in the cleanup stack.