الاسم¶

setjmp, sigsetjmp, longjmp, siglongjmp - تنفيذ قفزة غير محلية

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#include <setjmp.h>

int setjmp(jmp_buf env);
int sigsetjmp(sigjmp_buf env, int savesigs);

[[noreturn]] void longjmp(jmp_buf env, int val);
[[noreturn]] void siglongjmp(sigjmp_buf env, int val);

setjmp(): انظر التاريخ.

sigsetjmp():

    _POSIX_C_SOURCE

الوصف¶

تُستخدم الدوال الموصوفة في هذه الصفحة لتنفيذ "قفزات غير محلية": نقل التنفيذ من دالة إلى موقع محدد مسبقًا في دالة أخرى. تنشئ الدالة setjmp() ديناميكيًا الهدف الذي سيُنقل إليه التحكم لاحقًا، وتنفذ الدالة longjmp() نقل التنفيذ.

تحفظ الدالة setjmp() معلومات متنوعة عن بيئة الاستدعاء (عادةً، مؤشر المكدس، مؤشر التعليمات، وربما قيم سجلات أخرى وقناع الإشارة) في المخزن المؤقت env لاستخدامها لاحقًا بواسطة longjmp(). في هذه الحالة، تُرجع setjmp() 0.

تستخدم الدالة longjmp() المعلومات المحفوظة في env لإعادة التحكم إلى النقطة التي استُدعيت فيها setjmp() واستعادة ("إرجاع") المكدس إلى حالته وقت استدعاء setjmp(). بالإضافة إلى ذلك، واعتمادًا على التنفيذ (انظر الملاحظات والتاريخ)، قد تُستعاد قيم بعض السجلات الأخرى وقناع إشارة العملية إلى حالتها وقت استدعاء setjmp().

بعد longjmp() ناجحة، يستمر التنفيذ كما لو أن setjmp() قد عادت مرة ثانية. يمكن تمييز هذا الإرجاع "المزيف" عن استدعاء setjmp() حقيقي لأن الإرجاع "المزيف" يُرجع القيمة المقدمة في val. إذا مرر المبرمج القيمة 0 في val عن طريق الخطأ، فسيرجع الإرجاع "المزيف" 1 بدلاً من ذلك.

قيمة الإرجاع¶

تُرجع setjmp() و sigsetjmp() 0 عند استدعائهما مباشرة؛ عند الإرجاع "المزيف" الذي يحدث بعد longjmp() أو siglongjmp()، تُرجع القيمة غير الصفرية المحددة في val.

لا تُرجع الدالتان longjmp() أو siglongjmp() أي قيمة.

السمات¶

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

المعايير¶

setjmp()

longjmp()

C11, POSIX.1-2008.

sigsetjmp()

siglongjmp()

POSIX.1-2008.

التاريخ¶

setjmp()

longjmp()

POSIX.1-2001، C89.

sigsetjmp()

siglongjmp()

POSIX.1-2001.

لا يُحدد POSIX ما إذا كانت setjmp() ستحفظ قناع الإشارة (لاستعادته لاحقًا أثناء longjmp()). في System V لن تفعل. في 4.3BSD ستفعل، وهناك دالة _setjmp() لن تفعل. يعتمد السلوك تحت Linux على إصدار glibc وإعداد وحدات اختبار الميزات. قبل glibc 2.19، تتبع setjmp() سلوك System V مبدئيًا، ولكن يُوفر سلوك BSD إذا تم تعريف وحدة اختبار الميزات _BSD_SOURCE صراحةً ولم يتم تعريف أي من _POSIX_SOURCE أو _POSIX_C_SOURCE أو _XOPEN_SOURCE أو _GNU_SOURCE أو _SVID_SOURCE. منذ glibc 2.19، يُظهر <setjmp.h> فقط إصدار System V من setjmp(). يجب على البرامج التي تحتاج دلالات BSD استبدال استدعاءات setjmp() باستدعاءات sigsetjmp() مع معامل savesigs غير صفري.

ملاحظات¶

يمكن أن تكون setjmp() و longjmp() مفيدة للتعامل مع الأخطاء داخل استدعاءات دوال متداخلة بعمق أو للسماح لمعالج إشارة بتمرير التحكم إلى نقطة محددة في البرنامج، بدلاً من العودة إلى النقطة التي قاطع فيها المعالج البرنامج الرئيس. في الحالة الأخيرة، إذا أردت حفظ واستعادة أقنعة الإشارة بشكل محمول، استخدم sigsetjmp() و siglongjmp(). انظر أيضًا مناقشة قابلية قراءة البرنامج أدناه.

تحذيرات¶

قد يُحسّن المترجم المتغيرات إلى سجلات، وقد تستعيد longjmp() قيم سجلات أخرى بالإضافة إلى مؤشر المكدس وعداد البرنامج. وبالتالي، تكون قيم المتغيرات التلقائية غير محددة بعد استدعاء longjmp() إذا استوفت جميع المعايير التالية:

•

هي محلية للدالة التي أجرت استدعاء setjmp() المقابل؛

•

تتغير قيمها بين استدعاءات setjmp() و longjmp()؛ و

•

لم تُصرّح على أنها volatile.

تنطبق ملاحظات مماثلة على siglongjmp().

انظر أيضًا¶

signal(7), signal-safety(7)

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.