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

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