SETJMP(3C)

НАЗВАНИЕ
setjmp, longjmp - нелокальная передача управления

СИНТАКСИС

	#include <setjmp.h>

	int setjmp (env)
	jmp_buf env;

	void longjmp (env, val)
	jmp_buf env;
	int val;

ОПИСАНИЕ
Описываемые функции полезны при обработке ошибок и прерываний, случившихся на одном из нижних уровней программной системы.

Функция setjmp сохраняет текущее стековое окружение в массиве env (тип jmp_buf определен во включаемом файле <setjmp.h>) для последующего использования функцией longjmp. Результат функции setjmp равен 0.

Функция longjmp восстанавливает окружение, сохраненное при последнем вызове setjmp с соответствующим аргументом env. После завершения longjmp выполнение программы продолжается так, как будто соответствующий вызов setjmp только что вернул значение val. Отметим, что в промежутке между обращениями к setjmp и longjmp не должно быть возврата из функции, вызывавшей setjmp.

С помощью функции longjmp невозможно вернуть нулевое значение. Если при вызове longjmp аргумент val равен 0, setjmp все равно вернет 1. Тем самым всегда есть возможность отличить естественный возврат из функции setjmp от искусственного, ставшего результатом выполнения longjmp. Значения всех глобальных объектов в момент искусственного возврата из setjmp, естественно, те же, что и в момент вызова longjmp. Значения локальных объектов соответствуют экземпляру функции, вызвавшей setjmp.

ПРИМЕР

	#include <setjmp.h>

	jmp_buf env;
	int i=0;
	main ()
	{
	  void exit ();

	  if (setjmp (env) != 0) {
	    (void) printf (
	     "Значение i при 2-ом возврате из setjmp: %d\n",i);
	    exit (0);
	  }
	  (void) printf (
	   "Значение i при 1-ом возврате из setjmp: %d\n",i);
	  i = 1;
	  g();
	  /* Недостижимый фрагмент */
	}

	g()
	{
	  longjmp (env, 1);
	  /* Недостижимый фрагмент */
	}
Результаты выполнения этой программы после компиляции с языка C будут следующими:
     	Значение i при 1-ом возврате из setjmp: 0
     	Значение i при 2-ом возврате из setjmp: 1

СМ. ТАКЖЕ
signal(2).

ПРЕДОСТЕРЕЖЕНИЯ
Если при обращении к функции longjmp передается аргумент env, не заполненный setjmp, или последний вызов setjmp был в функции, из которой уже произошел возврат, то Вам гарантируется абсолютный хаос.