Keil Logo

Technical Support

On-Line Manuals

Cx51 User's Guide

Cx51 Introduction Compiling Programs Language Extensions Preprocessor Advanced Programming 8051 Derivatives Error Messages Library Reference Library Files Source Code Standard Types jmp_buf size_t va_list wchar_t Macros CBYTE CWORD DBYTE DWORD FARRAY FCARRAY FCVAR FVAR PBYTE PWORD XBYTE XWORD Routines By Category Buffer Manipulation Routines Character Routines Data Conversion Routines Intrinsic Routines Math Routines Memory Allocation Routines Stream I/O Routines String Routines Variable Length Argument Routines Miscellaneous Routines Include Files SFR Definitions 80c517.h absacc.h assert.h ctype.h float.h intrins.h limits.h math.h rtx51tny.h setjmp.h stdarg.h stddef.h stdio.h stdlib.h string.h Reference _chkfloat_ _crol_ _cror_ _getkey _irol_ _iror_ _lrol_ _lror_ _nop_ _pop_ _push_ _testbit_ _tolower _toupper abs acos acos517 asin asin517 assert atan atan2 atan517 atof atof517 atoi atol cabs calloc ceil cos cos517 cosh exp exp517 fabs floor fmod free getchar gets init_mempool isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit labs log log10 log10517 log517 longjmp malloc memccpy memchr memcmp memcpy memmove memset modf offsetof pow printf printf517 putchar puts rand realloc scanf scanf517 setjmp sin sin517 sinh sprintf sprintf517 sqrt sqrt517 srand sscanf sscanf517 strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strpos strrchr strrpbrk strrpos strspn strstr strtod strtod517 strtok strtol strtoul switchbank tan tan517 tanh toascii toint tolower toupper ungetchar va_arg va_end va_start vprintf vsprintf Appendix

setjmp

Summary
#include <setjmp.h>

int setjmp (
  jmp_buf env);      /* current environment */
Description

The setjmp function saves the current state of the CPU in env. The state may be restored by a subsequent call to the longjmp function. When used together, the setjmp and longjmp functions provide you with a way to execute a non-local goto.

A call to the setjmp function saves the current instruction address as well as other CPU registers. A subsequent call to the longjmp function restores the instruction pointer and registers, and execution resumes at the point just after the setjmp call.

Local variables and function arguments are restored only if declared with the volatile attribute.

Return Value

The setjmp function returns a value of 0 when the current state of the CPU has been copied to env. A non-zero value indicates that the longjmp function was executed to return to the setjmp function call. In such a case, the return value is the value passed to the longjmp function.

See Also

longjmp

Example
#include <setjmp.h>
#include <stdio.h> /* for printf */

jmp_buf env; /* jump environment (must be global) */
bit error_flag;

void trigger (void) {
  .
  .
  .
  /* processing code here */
  .
  .
  .
  if (error_flag != 0) {
    longjmp (env, 1);   /* return 1 to setjmp */
  }
  .
  .
  .
}


void recover (void) {
  /* recovery code here */
}


void tst_longjmp (void) {
  .
  .
  .
  if (setjmp (env) != 0) {     /* setjmp returns a 0 */
    printf ("LONGJMP called\n");
    recover ();
  }

  else {
    printf ("SETJMP called\n");

    error_flag = 1;            /* force an error */

    trigger ();
  }
}
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.