Single Phase Constructor

Single phase constructor is to push a pointer to the clean-up stack, and then complete its construction. It uses the macro CONSTRUCTORS_MAY_LEAVE that is necessary to ensure whether the cleanup is correctly handled in the event that a constructor may leave beneath a call to new(ELeave).

Characteristics of single phase constructor

The following are the major characteristics of single phase constructor:

  • The implementation of NewL becomes much simpler

  • By using RAII classes in fields to manage owned resources, constructor exception-safety can be maintained

  • Cleanup stack technology


The following code snippet implies the usage of single phase constructor using CONSTRUCTORS_MAY_LEAVE macro.

        class CManagedUserSinglePhase : public CBase
            static CManagedUserSinglePhase* NewL(CTicker* aTicker)
                    return new(ELeave) CManagedUserSinglePhase(aTicker);

See Also

EUser High Level Library Overview

EUser High Level Library Tutorials