compiler/posixc/siglongjmp.c

   1 /*
   2     Copyright © 2015, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: POSIX.1-2008 function siglongjmp()
   6     Lang: english
   7 */
   8
   9 /******************************************************************************
  10
  11     NAME
  12 #include <setjmp.h>
  13
  14         void siglongjmp (
  15
  16 /*  SYNOPSIS
  17         jmp_buf env,
  18         int val)
  19
  20     FUNCTION
  21         Save the current context so that you can return to it later.
  22
  23     INPUTS
  24         env - The context/environment to restore
  25         val - This value is returned by setjmp() when you return to the
  26                 saved context. You cannot return 0. If val is 0, then
  27                 setjmp() returns with 1.
  28
  29     RESULT
  30         This function doesn't return.
  31
  32     NOTES
  33
  34     EXAMPLE
  35         jmp_buf env;
  36
  37         ... some code ...
  38
  39         if (!setjmp (env))
  40         {
  41             ... this code is executed after setjmp() returns ...
  42
  43             // This is no good example on how to use this function
  44             // You should not do that
  45             if (error)
  46                 siglongjmp (env, 5);
  47
  48             ... some code ...
  49         }
  50         else
  51         {
  52             ... this code is executed if you call siglongjmp(env) ...
  53         }
  54
  55     BUGS
  56
  57     SEE ALSO
  58         stdc/setjmp()
  59
  60     INTERNALS
  61
  62 ******************************************************************************/
  63
  64 #error siglongjmp has to be implemented for each cpu