usleep(3)

الاسم
usleep - تعليق التنفيذ لفترات ميكروثانية

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

موجز
#include <unistd.h>

int usleep(useconds_t usec);

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

usleep():
    منذ glibc 2.12:
        (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200809L)
            || /* glibc >= 2.19: */ _DEFAULT_SOURCE
            || /* glibc <= 2.19: */ _BSD_SOURCE
    قبل glibc 2.12:
        _BSD_SOURCE || _XOPEN_SOURCE >= 500

الوصف
تعلق الدالة usleep() تنفيذ الخيط المستدعي لمدة (على الأقل) usec ميكروثانية. قد يُطال التعليق قليلاً بأي نشاط نظام أو بالوقت المستغرق في معالجة الاستدعاء أو بدقة مؤقتات النظام.

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

الأخطاء

EINTR
    قوطع بواسطة إشارة؛ انظر signal(7).

EINVAL
    usec أكبر من أو يساوي 1000000. (على الأنظمة حيث يُعتبر ذلك خطأ.)

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

المعايير
لا شيء.

التاريخ
4.3BSD, POSIX.1-2001. يُعلن POSIX.1-2001 أنها مهملة، مقترحاً nanosleep(2) بدلاً منها. أُزيلت في POSIX.1-2008.

في تطبيق BSD الأصلي، وقبل glibc 2.2.2، نوع إرجاع هذه الدالة هو void. ترجع نسخة POSIX int، وهذا هو النموذج المستخدم منذ glibc 2.2.2.

فقط إرجاع الخطأ EINVAL هو المُوثق بواسطة SUSv2 و POSIX.1-2001.

تحذيرات
تفاعل هذه الدالة مع إشارة SIGALRM، ومع دوال مؤقت أخرى مثل alarm(2), sleep(3), nanosleep(2), setitimer(2), timer_create(2), timer_delete(2), timer_getoverrun(2), timer_gettime(2), timer_settime(2), ualarm(3) غير محدد.

انظر أيضًا
alarm(2), getitimer(2), nanosleep(2), select(2), setitimer(2), sleep(3), ualarm(3), useconds_t(3type), time(7)

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

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

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