Return to longjmp CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / ALL

Annotation of coherent/a/usr/man/ALL/longjmp, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: longjmp()                General Function               longjmp()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Return from a non-local goto
        !             9: 
        !            10: #include <setjmp.h>
        !            11: iinntt lloonnggjjmmpp(_e_n_v, _r_v_a_l) jjmmpp_bbuuff _e_n_v; iinntt _r_v_a_l;
        !            12: 
        !            13: The function call is the only mechanism that C provides to trans-
        !            14: fer control between  functions.  This mechanism is inadequate for
        !            15: some purposes,  such as handling unexpected  errors or interrupts
        !            16: at  lower levels  of  a program.   To answer  this need,  lloonnggjjmmpp
        !            17: provides a non-local _g_o_t_o.
        !            18: 
        !            19: lloonnggjjmmpp restores an environment that had been saved by a previous
        !            20: call to  the function sseettjjmmpp.   It returns the value  _r_v_a_l to the
        !            21: caller of  sseettjjmmpp, just as if the sseettjjmmpp  call had just returned.
        !            22: Note that  lloonnggjjmmpp must not restore the  environment of a routine
        !            23: that has  already returned.  The type  declaration for jjmmpp_bbuuff is
        !            24: in the header  file sseettjjmmpp.hh.  The environment saved includes the
        !            25: program counter, stack  pointer, and stack frame.  These routines
        !            26: do not restore register variables in the environment returned.
        !            27: 
        !            28: ***** Example *****
        !            29: 
        !            30: For an example of this function, see the entry for longjmp.
        !            31: 
        !            32: ***** See Also *****
        !            33: 
        !            34: general functions, setjmp()
        !            35: 
        !            36: ***** Notes *****
        !            37: 
        !            38: Programmers should  note that many user-level  routines cannot be
        !            39: interrupted and reentered  safely.  For that reason, improper use
        !            40: of longjmp  and setjmp can  result in the  creation of mysterious
        !            41: and irreproducible bugs.  Do not attempt to use longjmp within an
        !            42: exception handler.
        !            43: 
        !            44: 
        !            45: 
        !            46: 
        !            47: 
        !            48: 
        !            49: 
        !            50: 
        !            51: 
        !            52: 
        !            53: 
        !            54: 
        !            55: 
        !            56: 
        !            57: 
        !            58: 
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.