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