/** @file  ../include/setjmp.h

@internalComponent

*/

/** @fn  longjmp(jmp_buf __jmpb, int __retval)

@param __jmpb

@param __retval

Refer to  setjmp() for the documentation

@publishedAll

@externallyDefinedApi

*/

/** @fn  setjmp(jmp_buf __jmpb)

@param __jmpb

Note: This description also covers the following functions -

 longjmp()  _setjmp()  _longjmp() 

@return   If the return is from a direct invocation, the setjmp function returns 0. If the return is from a call to longjmp(),

setjmp() returns a non-zero value.

After the longjmp is completed, program execution continues as if

the corresponding invocation of setjmp() had just returned the

value specified by __retval. If __retval is 0, setjmp() returns 1.

  The setjmp, and _setjmp functions save their calling environment in __jmpb. Each of these functions returns 0.

 The corresponding longjmp functions restore the environment saved by their most recent respective

invocations

of the setjmp function.

They then return so that program execution continues as if the corresponding

invocation of the setjmp call had just returned the value specified by __retval, instead of 0.

 The longjmp routines may not be called after the routine which called the setjmp routines returns.

 All accessible objects have values as of the time longjmp routine was called, except that the values of objects of automatic storage

invocation duration that do not have the volatile

type and have been changed between the setjmp invocation and longjmp call are indeterminate.

 The setjmp / longjmp pairs save and restore the signal mask while _setjmp / _longjmp pairs save and restore only the register set and the stack.

Examples:

@code

#include <setjmp.h>

#include <stdio.h>

#include <stdlib.h>

static void f1( int, int, int );

static void f2( void );

static jmp_buf jmpbuffer;

int main()

{

        int count;

        register int val;

        volatile int sum;

        count = 2; val = 3; sum = 4;

        if ( setjmp( jmpbuffer ) != 0 )

        {

    printf("in main: count = %d, val = %d, sum = %d

", count, val, sum );

    exit(0);

  }

        f1(97, 98, 99 );

        return 0;

}

static void f1 (int i, int j, int k )

{

          printf("in f1: count = %d, val = %d, sum = %d

", i, j , k );

    f2();

}

static void f2( void )

{

    longjmp( jmpbuffer, 1 );

}

@endcode

 Output

@code

in f1: count = 97, val = 98, sum = 99

in main: count = 2, val = 3, sum = 4

@endcode

Limitations: 

The signal related functionalities aren't applicable to the Symbian 

OS implementation as there is no support for signals. This means that the setjmp and _setjmp routines have the same functionality and so do longjmp and _longjmp . 

@publishedAll

@externallyDefinedApi

*/

/** @def	_setjmp

The _longjmp() and _setjmp() functions shall be equivalent to longjmp() and setjmp(), respectively, with the additional restriction that _longjmp() and _setjmp() shall not manipulate the signal mask.

@publishedAll

@externallyDefinedApi

*/

/** @def	_longjmp

The _longjmp() and _setjmp() functions shall be equivalent to longjmp() and setjmp(), respectively, with the additional restriction that _longjmp() and _setjmp() shall not manipulate the signal mask.

@publishedAll

@externallyDefinedApi

*/