SIGSETOPS(3)

الاسم
sigemptyset, sigfillset, sigaddset, sigdelset, sigismember - عمليات مجموعة إشارات POSIX

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

موجز
#include <signal.h>

int sigemptyset(sigset_t *set);
int sigfillset(sigset_t *set);

int sigaddset(sigset_t *set, int signum);
int sigdelset(sigset_t *set, int signum);

int sigismember(const sigset_t *set, int signum);

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

sigemptyset(), sigfillset(), sigaddset(), sigdelset(), sigismember():
    _POSIX_C_SOURCE

الوصف
تسمح هذه الدوال بمعالجة مجموعات الإشارات POSIX.

sigemptyset() تهيئ مجموعة الإشارات المعطاة بواسطة set إلى فارغة، مع استبعاد جميع الإشارات من المجموعة.

sigfillset() تهيئ set إلى كاملة، متضمنة جميع الإشارات.

sigaddset() و sigdelset() تضيف وتحذف على التوالي الإشارة signum من set.

sigismember() تختبر ما إذا كانت signum عضواً في set.

يجب تهيئة كائنات من النوع sigset_t باستدعاء إما sigemptyset() أو sigfillset() قبل تمريرها إلى الدوال sigaddset()، sigdelset()، و sigismember() أو دوال glibc الإضافية الموصوفة أدناه (sigisemptyset()، sigandset()، و sigorset()). تكون النتائج غير معرفة إذا لم يُفعل ذلك.

قيمة الإرجاع
sigemptyset()، sigfillset()، sigaddset()، و sigdelset() تُرجع 0 عند النجاح و -1 عند الخطأ.

sigismember() تُرجع 1 إذا كانت signum عضواً في set، و 0 إذا لم تكن signum عضواً، و -1 عند الخطأ.

عند الخطأ، تضبط هذه الدوال errno للإشارة إلى الخطأ.

الأخطاء

EINVAL
    signum ليست إشارة صالحة.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
sigemptyset()، sigfillset()، sigaddset()، sigdelset()، sigismember()، sigisemptyset()، sigorset()، sigandset() | سلامة الخيوط | MT-Safe

الإصدارات

  GNU
إذا عُرّف ماكرو اختبار الميزة _GNU_SOURCE، فإن <signal.h> يكشف عن ثلاث دوال أخرى لمعالجة مجموعات الإشارات:

int sigisemptyset(const sigset_t *set);
int sigorset(sigset_t *dest, const sigset_t *left,
              const sigset_t *right);
int sigandset(sigset_t *dest, const sigset_t *left,
              const sigset_t *right);

sigisemptyset() تُرجع 1 إذا لم تحتوِ set على أي إشارات، و 0 بخلاف ذلك.

تضع الدالة sigorset() اتحاد المجموعتين left و right في dest. وتضع الدالة sigandset() تقاطع المجموعتين left و right في dest. تُرجع كلتا الدالتين 0 عند النجاح، و -1 عند الفشل.

هذه الدوال غير قياسية (توفر بعض الأنظمة الأخرى دوالًا مشابهة) ويجب تجنب استخدامها في التطبيقات المحمولة.

المعايير
POSIX.1-2008.

التاريخ
POSIX.1-2001.

ملاحظات
عند إنشاء مجموعة إشارات ممتلئة، لا تتضمن دالة glibc sigfillset() إشارتي الوقت الفعلي المستخدمتين داخليًا بواسطة تنفيذ الخيوط NPTL. انظر nptl(7) للتفاصيل.

انظر أيضًا
sigaction(2)، sigpending(2)، sigprocmask(2)، sigsuspend(2)

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

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

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