// Copyright (c) 1994-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "Eclipse Public License v1.0"

 // which accompanies this distribution, and is available

 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 // e32\euser\us_trp.cpp

 // 

 //

 #include "us_std.h"

 #include "us_data.h"

 EXPORT_C TTrapHandler::TTrapHandler()

 /**

 Default constructor.

 */

 	{}

 #ifndef __LEAVE_EQUALS_THROW__

 EXPORT_C void TTrap::UnTrap()

 //

 // Pop the current trap frame

 //

 	{

 	TTrapHandler *pH=Exec::PopTrapFrame()->iHandler;

 	if (pH!=NULL)

 		pH->UnTrap();

 	}

 #else //__LEAVE_EQUALS_THROW__

 EXPORT_C void User::Leave(TInt aReason)

 /**

 Leaves the currently executing function, unwinds the call stack, and returns

 from the most recently entered trap harness.

 @param aReason The value returned from the most recent call to TRAP or TRAPD.

                This is known as the reason code and, typically, it gives the

                reason for the environment or user error causing this leave

                to occur.

 @see TRAP

 @see TRAPD              

 */

 	{

 #ifdef __USERSIDE_THREAD_DATA__

 	Exec::LeaveStart();

 	TTrapHandler* pH = GetTrapHandler();

 #else

 	TTrapHandler* pH = Exec::LeaveStart();

 #endif

 	if (pH)

 		pH->Leave(aReason);	// causes things on the cleanup stack to be cleaned up

 	throw XLeaveException(aReason);

 	}

 #endif // !__LEAVE_EQUALS_THROW__

 // Private declaration to prevent def file branching

 #ifndef __SUPPORT_CPP_EXCEPTIONS__

 class XLeaveException

 	{

 public:

 	IMPORT_C TInt GetReason() const;

 	};

 #endif //__SUPPORT_CPP_EXCEPTIONS__

 #if !defined(__LEAVE_EQUALS_THROW__) || !defined(__WINS__)

 EXPORT_C TInt XLeaveException::GetReason() const

 	{

 #ifdef __SUPPORT_CPP_EXCEPTIONS__

 	Exec::LeaveEnd();

 	return iR;

 #else // !__SUPPORT_CPP_EXCEPTIONS__

 	return KErrNone;

 #endif //__SUPPORT_CPP_EXCEPTIONS__

 	}

 #elif defined(__LEAVE_EQUALS_THROW__) && defined(__SYMC__)

 EXPORT_C TInt XLeaveException::GetReason() const

 	{

 #ifdef __SUPPORT_CPP_EXCEPTIONS__

 	Exec::LeaveEnd();

 	return iR;

 #else // !__SUPPORT_CPP_EXCEPTIONS__

 	return KErrNone;

 #endif //__SUPPORT_CPP_EXCEPTIONS__

 	}

 #endif	// !defined(__LEAVE_EQUALS_THROW__) || !defined(__WINS__)

 EXPORT_C void User::LeaveNoMemory()

 /**

 Leaves with the specific reason code KErrNoMemory.

 @see KErrNoMemory

 */

 	{

 	User::Leave(KErrNoMemory);

 	}

 EXPORT_C TInt User::LeaveIfError(TInt aReason)

 /**

 Leaves or returns with a specified reason code.

 If the reason code is negative the function leaves, and the reason code is 

 returned through the trap harness.

 If the reason code is zero or positive, the function simply returns with the 

 reason value.

 @param aReason The reason code.

 @return If the function returns, the reason code which is either zero or positive.

 */

 	{

 	if (aReason<0)

 		User::Leave(aReason);

 	return(aReason);

 	}

 EXPORT_C TAny * User::LeaveIfNull(TAny *aPtr)

 /**

 Leaves with the reason code KErrNoMemory, if the specified pointer is NULL. 

 If the pointer is not NULL, the function simply returns with the value of 

 the pointer.

 @param aPtr The pointer to be tested.

 @return If the function returns, the value of aPtr.

 */

 	{

 	if (aPtr==NULL)

 		User::LeaveNoMemory();

 	return(aPtr);

 	}