strsignal(3)

الاسم
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[];

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

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() | سلامة الخيوط | MT-Unsafe race:strsignal locale
sigdescr_np(), sigabbrev_np() | سلامة الخيوط | MT-Safe

المعايير

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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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