Back Setjmp.h English Setjmp.h Spanish Setjmp.h Korean Setjmp.h Portuguese Setjmp.h Russian Setjmp.h Chinese
| Tipus | C header file (en)   |
|---|---|
| Part de | C standard library, Biblioteca C POSIX i Biblioteca estàndard de C++ |
| Característiques tècniques | |
| Plataforma | C standard library |
setjmp.h és una capçalera definida a la biblioteca estàndard C per proporcionar "salts no locals": flux de control que es desvia de la seqüència de trucada i retorn de subrutina habitual. Les funcions complementàries setjmp i longjmp proporcionen aquesta funcionalitat.[1]
Un ús típic de setjmp / longjmp és la implementació d'un mecanisme d'excepció que explota la capacitat de longjmp per restablir l'estat del programa o del fil, fins i tot a través de diversos nivells de trucades de funció. Un ús menys comú de setjmp és crear una sintaxi semblant a les corrutines.[2]
int
setjmp(jmp_buf env)
|
Configura el buffer local jmp_buf i l'inicia per al salt. Aquesta rutina desa l'entorn de crida del programa a la memòria intermèdia d'entorn especificada per l'argument env per al seu ús posterior per longjmp. Si el retorn prové d'una invocació directa, setjmp retorna 0. Si el retorn és d'una trucada a longjmp, setjmp retorna un valor diferent de zero.
|
void
longjmp(jmp_buf env, int value)
|
Restaura el context del buffer d'entorn env que es va desar mitjançant la invocació de la rutina setjmp en la mateixa invocació del programa. Invocar longjmp des d'un controlador de senyal imbricat no està definit. El valor especificat per value es passa de longjmp a setjmp. Un cop finalitzat longjmp, l'execució del programa continua com si la corresponent invocació de setjmp acabés de tornar. Si el value passat longjmp és 0, setjmp es comportarà com si hagués retornat 1; en cas contrari, es comportarà com si hagués retornat value.
|
setjmp desa l'entorn actual (l'estat del programa), en algun moment de l'execució del programa, en una estructura de dades específica de la plataforma (jmp_buf ) que es pot utilitzar en algun moment posterior de l'execució del programa per longjmp per restaurar l'estat del programa al desat per setjmp a jmp_buf. Es pot imaginar que aquest procés és un "salt" de tornada al punt d'execució del programa on setjmp va salvar l'entorn. El valor de retorn (aparent) de setjmp indica si el control ha arribat a aquest punt normalment (zero) o des d'una trucada a longjmp (no zero). Això condueix a un modisme comú: if( setjmp(x) ){/* handle longjmp(x) */}.[3]
POSIX.1 no especifica si setjmp i longjmp guarden i restauren el conjunt actual de senyals bloquejats; si un programa utilitza el maneig de senyal, hauria d'utilitzar sigsetjmp / siglongjmp de POSIX.[4]
- ↑ «setjmp - cppreference.com» (en anglès). [Consulta: 19 desembre 2023].
- ↑ «<csetjmp> (setjmp.h)» (en anglès). [Consulta: 19 desembre 2023].
- ↑ TylerMSFT. «setjmp» (en anglès americà), 02-12-2022. [Consulta: 19 desembre 2023].
- ↑ «setjmp(3) - Linux manual page» (en anglès). [Consulta: 19 desembre 2023].