genericopenlibs/cppstdlib/inc/stdcpp_support.dosc
changeset 0 e4d67989cc36
equal deleted inserted replaced
-1:000000000000 0:e4d67989cc36
       
     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