Cleanup +utilities

diff -r 000000000000 -r 89d6a7a84779 Symbian3/SDK/Source/GUID-E455ABFF-3EFF-5396-A52A-A33CDB2EB41A.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-E455ABFF-3EFF-5396-A52A-A33CDB2EB41A.dita Thu Jan 21 18:18:20 2010 +0000 @@ -0,0 +1,43 @@ + + + + + +Cleanup +utilitiesThe Cleanup utility functions support four types of clean up operation. +

The cleanup utility functions offer easy ways of constructing a TCleanUpItem and +pushing it onto the cleanup stack. They support four types of clean up operation:

where the object is +deleted: template <class T> void CleanupDeletePushL(T*)
where the object's Close() member +function is called: template <class T> void CleanupClosePushL(T&)
where the object's Release() member +function is called: template <class T> void CleanupReleasePushL(T&)
where an array of objects +is deleted: template <class T> void CleanupArrayDeletePushL(T*)

The functions have the supporting templated classes:

CleanupDelete<class +T>
CleanupClose<class +T>
CleanupRelease<class +T>
CleanupArrayDelete<class +T>

The way in which these work is best illustrated graphically by taking CleanupClosePushL() as +an example. See the diagram below.

+ +Effect of CleanupClosePushL and subsequent pop and destroy + + + \ No newline at end of file