on_exit(3)

الاسم
on_exit - تسجيل دالة لاستدعائها عند إنهاء العملية بشكل طبيعي

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

موجز
#include <stdlib.h>

int on_exit(typeof(void (int, void *)) *function, void *arg);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

on_exit():
    منذ glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 وما قبله:
        _BSD_SOURCE || _SVID_SOURCE

الوصف
تسجل الدالة on_exit() الدالة function المُعطاة لاستدعائها عند إنهاء العملية بشكل طبيعي، سواء عبر exit(3) أو عبر العودة من main() الرئيس للبرنامج. تُمرر إلى الدالة function وسيط الحالة المُعطى لآخر استدعاء لـ exit(3) ووسيط arg من on_exit().

قد تُسجل نفس الدالة عدة مرات: وتُستدعى مرة واحدة لكل تسجيل.

عند إنشاء عملية ابنة عبر fork(2)، فإنها ترث نسخًا من تسجيلات والديها. عند إجراء نداء ناجح لإحدى وظائف exec(3)، تُزال كافة التسجيلات.

قيمة الإرجاع
تُرجع الدالة on_exit() القيمة 0 إذا نجحت؛ وإلا، تُرجع قيمة غير صفرية.

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

المعايير
لا يوجد.

التاريخ
SunOS 4، glibc. أُزيلت في Solaris (SunOS 5). استخدم المعيار atexit(3) بدلاً من ذلك.

تحذيرات
بحلول وقت تنفيذ function، قد تكون متغيرات المكدس (auto) قد خرجت بالفعل عن النطاق. لذلك، لا ينبغي أن يكون arg مؤشرًا لمتغير مكدس؛ لكنه قد يكون مؤشرًا لمتغير كومة أو متغير عام.

انظر أيضًا
_exit(2), atexit(3), exit(3)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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