os/ossrv/genericopenlibs/cppstdlib/inc/stdcpp_support.dosc
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
     1 /** @file stdcpp_support.h
     2 @internalComponent 
     3 */
     4 
     5 
     6 /** @fn TranslateSymErrorToCppException(TInt)
     7 @publishedAll
     8 @released
     9 
    10 A utility funtion that takes a SymbianC++ error number and throws a corresponding 
    11 C++ exception. This mapping is done based on what is mentioned in Chapter 19.1 of 
    12 the C++ specification and Symbian's e32err.h.
    13 */
    14 
    15 
    16 /** @fn TranslateCppExceptionToSymError(const std::exception &)
    17 @publishedAll
    18 @released
    19 
    20 A utility function that takes an instance of std::exception and returns a
    21 corresponding SymbianC++ error number. This mapping is done based on what is
    22 mentioned in Chapter 19.1 of the C++ specification and Symbian's e32err.h.
    23 */
    24 
    25 /** @def TRANSLATE_SYM_CPP_LEAVES
    26 @publishedAll
    27 @released
    28 
    29 Executes the set of C++ statements _s under a trap harness and throws a suitable  
    30 C++ exception that matches the Symbian error code.
    31 
    32 Use this macro as a C++ statement to translate a User::Leave
    33 
    34 _s can consist of multiple C++ statements; in theory, _s can consist
    35 of any legal C++ code but in practice, such statements consist of Symbian C++
    36 function calls that may leave, e.g. FooL() or an assignment of some value to 
    37 the result of a function call, e.g. functionValue=GetFooL().
    38 
    39 @param C++ statements which will be executed under a trap harness
    40 */
    41 
    42 
    43