sem_getvalue(3)

الاسم
sem_getvalue - الحصول على قيمة كمية الإشارة

المكتبة
مكتبة مسالك POSIX (libpthread، -lpthread)

موجز
#include <semaphore.h>

int sem_getvalue(sem_t *restrict sem, int *restrict sval);

الوصف
تضع sem_getvalue() القيمة الحالية لكمية الإشارة المشار إليها بواسطة sem في العدد الصحيح المشار إليه بواسطة sval.

إذا كانت عملية واحدة أو أكثر أو خيوط محظورة بانتظار قفل كمية الإشارة باستخدام sem_wait(3)، يسمح POSIX.1 بإمكانيتين للقيمة المُعادة في sval: إما إعادة 0؛ أو رقم سالب قيمته المطلقة هي عدد العمليات والخيوط المحظورة حالياً في sem_wait(3). يتبنى لينكس السلوك الأول.

قيمة الإرجاع
تُعيد sem_getvalue() 0 عند النجاح؛ عند الخطأ، تُعاد -1 ويُضبط errno للإشارة إلى الخطأ.

الأخطاء

EINVAL
    sem ليس كمية إشارة صالحة. (لا يتحقق تطبيق glibc حالياً مما إذا كان sem صالحاً.)

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

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

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

ملاحظات
قد تكون قيمة كمية الإشارة قد تغيرت بالفعل بحلول وقت إعادة sem_getvalue().

انظر أيضًا
sem_post(3), sem_wait(3), sem_overview(7)

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

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

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