Scroll to navigation

timeradd(3) Library Functions Manual timeradd(3)

الاسم

timeradd, timersub, timercmp, timerclear, timerisset - عمليات القيمة الزمنية

المكتبة

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

موجز

#include <sys/time.h>
void timeradd(struct timeval *a, struct timeval *b,
              struct timeval *res);
void timersub(struct timeval *a, struct timeval *b,
              struct timeval *res);
void timerclear(struct timeval *tvp);
int timerisset(struct timeval *tvp);
int timercmp(struct timeval *a, struct timeval *b, CMP);

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

كافة الدوال الموضحة أعلاه:


منذ glibc 2.19:
_DEFAULT_SOURCE
glibc 2.19 وما قبله:
_BSD_SOURCE

الوصف

تُوفَّر الكليّات للعمل على بنى timeval، المُعرَّفة في <sys/time.h> كالتالي:


struct timeval {

time_t tv_sec; /* ثوانٍ */
suseconds_t tv_usec; /* ميكرو ثانية */ };

timeradd() تجمع قيمتي الوقت في a و b، وتضع المجموع في timeval المُشار إليه بواسطة res. النتيجة طُبِّعت بحيث يكون res->tv_usec بقيمة في النطاق 0 إلى 999,999.

timersub() تطرح قيمة الوقت في b من قيمة الوقت في a، وتضع النتيجة في timeval المُشار إليه بواسطة res. النتيجة طُبِّعت بحيث يكون res->tv_usec بقيمة في النطاق 0 إلى 999,999.

timerclear() تُصفّر بنية timeval المُشار إليها بواسطة tvp، لتمثل الحقبة: 1970-01-01 00:00:00 +0000 (UTC).

timerisset() تُرجع صحيحًا (غير صفري) إذا كان أي حقل من بنية timeval المُشار إليها بواسطة tvp يحتوي على قيمة غير صفرية.

timercmp() تقارن قيم المؤقت في a و b باستخدام عامل المقارنة CMP، وتُرجع صحيحًا (غير صفري) أو خطأ (0) اعتمادًا على نتيجة المقارنة. بعض الأنظمة (ولكن ليس Linux/glibc)، لديها تطبيق timercmp() معطوب، حيث لا تعمل CMP من >=، <=، و ==؛ يمكن للتطبيقات المحمولة بدلاً من ذلك استخدام


!timercmp(..., <)
!timercmp(..., >)
!timercmp(..., !=)

قيمة الإرجاع

timerisset() و timercmp() تُرجعان صحيحًا (غير صفري) أو خطأ (0).

الأخطاء

لم تُعرّف أي أخطاء.

المعايير

لا شيء.

التاريخ

BSD.

انظر أيضًا

gettimeofday(2), time(7)

ترجمة

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

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

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

8 فبراير 2026 صفحات دليل لينكس (لم تصدر بعد)