الاسم¶

strsignal, sigabbrev_np, sigdescr_np, sys_siglist - إرجاع سلسلة محارف تصف الإشارة

المكتبة¶

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

موجز¶

#include <string.h>

char *strsignal(int sig);
const char *sigdescr_np(int sig);
const char *sigabbrev_np(int sig);

[[deprecated]] extern const char *const sys_siglist[];

sigabbrev_np(), sigdescr_np():

    _GNU_SOURCE

strsignal():

    من glibc 2.10 إلى glibc 2.31:


        _POSIX_C_SOURCE >= 200809L


    قبل glibc 2.10:


        _GNU_SOURCE

sys_siglist:

    منذ glibc 2.19:


        _DEFAULT_SOURCE


    glibc 2.19 وما قبله:


        _BSD_SOURCE

الوصف¶

ترجع الدالة strsignal() سلسلة محارف تصف رقم الإشارة المُمرَّر في المعامل sig. يمكن استخدام السلسلة فقط حتى الاستدعاء التالي لـ strsignal(). السلسلة التي ترجعها strsignal() مُوضَّعة وفقًا لتصنيف LC_MESSAGES في الإعدادات المحلية الحالية.

ترجع الدالة sigdescr_np() سلسلة محارف تصف رقم الإشارة المُمرَّر في المعامل sig. على عكس strsignal()، هذه السلسلة لا تتأثر بالإعدادات المحلية الحالية.

ترجع الدالة sigabbrev_np() الاسم المختصر للإشارة sig. على سبيل المثال، عند إعطاء القيمة SIGINT، ترجع السلسلة "INT".

المصفوفة (المُهمَلة) sys_siglist تحتوي على سلاسل محارف وصف الإشارة مُفهرسة برقم الإشارة. ينبغي استخدام الدالة strsignal() أو sigdescr_np() بدلاً من هذه المصفوفة؛ انظر أيضًا VERSIONS.

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

ترجع الدالة strsignal() سلسلة الوصف المناسبة، أو رسالة إشارة غير معروفة إذا كان رقم الإشارة غير صالح. في بعض الأنظمة (ولكن ليس على Linux)، قد يُرجع NULL بدلاً من ذلك لرقم إشارة غير صالح.

ترجع الدالتان sigdescr_np() و sigabbrev_np() سلسلة الوصف المناسبة. السلسلة المُرجَعة مُخصَّصة بشكل ثابت وصالحة لعمر البرنامج. ترجع هاتان الدالتان NULL لرقم إشارة غير صالح.

السمات¶

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

المعايير¶

strsignal()

POSIX.1-2008.

sigdescr_np()

sigabbrev_np()

GNU.

sys_siglist

لا شيء.

التاريخ¶

strsignal()

POSIX.1-2008. سولاريس، بي إس دي.

sigdescr_np()

sigabbrev_np()

glibc 2.32.

sys_siglist

أُزيل في glibc 2.32.

ملاحظات¶

الدالتان sigdescr_np() و sigabbrev_np() آمنتان للخيوط وآمنتان للإشارات غير المتزامنة.

انظر أيضًا¶

psignal(3)، strerror(3)

ترجمة¶

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

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

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