1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/ossrv/genericopenlibs/cppstdlib/inc/stdcpp_support.dosc	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,43 @@
     1.4 +/** @file stdcpp_support.h
     1.5 +@internalComponent 
     1.6 +*/
     1.7 +
     1.8 +
     1.9 +/** @fn TranslateSymErrorToCppException(TInt)
    1.10 +@publishedAll
    1.11 +@released
    1.12 +
    1.13 +A utility funtion that takes a SymbianC++ error number and throws a corresponding 
    1.14 +C++ exception. This mapping is done based on what is mentioned in Chapter 19.1 of 
    1.15 +the C++ specification and Symbian's e32err.h.
    1.16 +*/
    1.17 +
    1.18 +
    1.19 +/** @fn TranslateCppExceptionToSymError(const std::exception &)
    1.20 +@publishedAll
    1.21 +@released
    1.22 +
    1.23 +A utility function that takes an instance of std::exception and returns a
    1.24 +corresponding SymbianC++ error number. This mapping is done based on what is
    1.25 +mentioned in Chapter 19.1 of the C++ specification and Symbian's e32err.h.
    1.26 +*/
    1.27 +
    1.28 +/** @def TRANSLATE_SYM_CPP_LEAVES
    1.29 +@publishedAll
    1.30 +@released
    1.31 +
    1.32 +Executes the set of C++ statements _s under a trap harness and throws a suitable  
    1.33 +C++ exception that matches the Symbian error code.
    1.34 +
    1.35 +Use this macro as a C++ statement to translate a User::Leave
    1.36 +
    1.37 +_s can consist of multiple C++ statements; in theory, _s can consist
    1.38 +of any legal C++ code but in practice, such statements consist of Symbian C++
    1.39 +function calls that may leave, e.g. FooL() or an assignment of some value to 
    1.40 +the result of a function call, e.g. functionValue=GetFooL().
    1.41 +
    1.42 +@param C++ statements which will be executed under a trap harness
    1.43 +*/
    1.44 +
    1.45 +
    1.46 +