Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     The setjmp function saves a stack environment that can be
     subsequently restored using longjmp. Used together, setjmp and
     longjmp provide a way to execute a nonlocal goto. They are
     typically used to pass execution control to error-handling or
     recovery code in a previously called routine, without using the
     normal calling or return conventions.
 
     A call to setjmp causes the current stack environment to be saved
     in <env>. A subsequent call to longjmp restores the saved
     environment and returns control to the point just after the
     corresponding setjmp call. All variables (except register
     variables) accessible to the routine receiving control contain the
     values they had when setjmp was called. The values of register
     variables are unpredictable.
 
     Return Value
 
     The setjmp function returns 0 after saving the stack environment.
     If setjmp returns as a result of a longjmp call, it returns the
     value argument of longjmp. If the value argument of longjmp is 0,
     it returns 1. There is no error return.
                                    -♦-