/*

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

 * All rights reserved.

 * This component and the accompanying materials are made available

 * under the terms of "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:

 * Name        : stdcpp_support.h

 * Part of     : standard c++ library.

 * 

 *

 */

 #ifndef _STDCPP_SUPPORT_H_

 #define _STDCPP_SUPPORT_H_

 #include <exception>

 //This is required for the TRAP macro

 #include <e32cmn.h>

 // This is required for the Symbian error numbers

 #include <e32err.h>

 /* A utility funtion that takes a SymbianC++ error number and throws a corresponding 

 C++ exception. This mapping is done based on what is mentioned in Chapter 19.1 of 

 the C++ specification and Symbian's e32err.h.

 */

 IMPORT_C void TranslateSymErrorToCppException(TInt);

 /* A utility function that takes an instance of std::exception and returns a

 corresponding SymbianC++ error number. This mapping is done based on what is

 mentioned in Chapter 19.1 of the C++ specification and Symbian's e32err.h.

 */

 IMPORT_C TInt TranslateCppExceptionToSymError(const std::exception&);

 /* Executes the set of C++ statements _s under a trap harness and throws a suitable  

 C++ exception that matches the Symbian error code.

 Use this macro as a C++ statement to translate a User::Leave

 _s can consist of multiple C++ statements; in theory, _s can consist

 of any legal C++ code but in practice, such statements consist of Symbian C++

 function calls that may leave, e.g. FooL() or an assignment of some value to 

 the result of a function call, e.g. functionValue=GetFooL().

 */

 #define TRANSLATE_SYM_CPP_LEAVES(_s)			\

 	{											\

 		TInt err;								\

 		TRAP(err, _s);							\

 		if(err) TranslateSymErrorToCppException(err);	\

 	}

 class Symbian_error : public std::exception

 {

 public:

 	/* A Symbian specific error can be encapsulated within this object*/

 	Symbian_error(TInt e):error_code(e) {}

 	inline TInt error() { return error_code; }

 private:

 	TInt error_code;

 };

 #endif //STDCPP_SUPPORT_H