.\" -*- coding: UTF-8 -*-
.\" Copyright 2007, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH timeradd 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
timeradd, timersub, timercmp, timerclear, timerisset \- عمليات القيمة الزمنية
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <sys/time.h>\fP
.P
\fBvoid timeradd(struct timeval *\fP\fIa\fP\fB, struct timeval *\fP\fIb\fP\fB,\fP
\fB              struct timeval *\fP\fIres\fP\fB);\fP
\fBvoid timersub(struct timeval *\fP\fIa\fP\fB, struct timeval *\fP\fIb\fP\fB,\fP
\fB              struct timeval *\fP\fIres\fP\fB);\fP
.P
\fBvoid timerclear(struct timeval *\fP\fItvp\fP\fB);\fP
\fBint timerisset(struct timeval *\fP\fItvp\fP\fB);\fP
.P
\fBint timercmp(struct timeval *\fP\fIa\fP\fB, struct timeval *\fP\fIb\fP\fB, \fP\fICMP\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
كافة الدوال الموضحة أعلاه:
.nf
    منذ glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 وما قبله:
        _BSD_SOURCE
.fi
.SH الوصف
تُوفَّر الكليّات للعمل على بنى \fItimeval\fP، المُعرَّفة في
\fI<sys/time.h>\fP كالتالي:
.P
.in +4n
.EX
struct timeval {
    time_t      tv_sec;     /* ثوانٍ */
    suseconds_t tv_usec;    /* ميكرو ثانية */
};
.EE
.in
.P
\fBtimeradd\fP()  تجمع قيمتي الوقت في \fIa\fP و \fIb\fP، وتضع المجموع في \fItimeval\fP
المُشار إليه بواسطة \fIres\fP.  النتيجة طُبِّعت بحيث يكون \fIres\->tv_usec\fP
بقيمة في النطاق 0 إلى 999,999.
.P
\fBtimersub\fP()  تطرح قيمة الوقت في \fIb\fP من قيمة الوقت في \fIa\fP، وتضع النتيجة
في \fItimeval\fP المُشار إليه بواسطة \fIres\fP.  النتيجة طُبِّعت بحيث يكون
\fIres\->tv_usec\fP بقيمة في النطاق 0 إلى 999,999.
.P
\fBtimerclear\fP()  تُصفّر بنية \fItimeval\fP المُشار إليها بواسطة \fItvp\fP، لتمثل
الحقبة: 1970\-01\-01 00:00:00 +0000 (UTC).
.P
\fBtimerisset\fP()  تُرجع صحيحًا (غير صفري) إذا كان أي حقل من بنية \fItimeval\fP
المُشار إليها بواسطة \fItvp\fP يحتوي على قيمة غير صفرية.
.P
.\" HP-UX, Tru64, Irix have a definition like:
.\"#define timercmp(tvp, uvp, cmp) \
.\"    ((tvp)->tv_sec cmp (uvp)->tv_sec || \
.\"    (tvp)->tv_sec == (uvp)->tv_sec && (tvp)->tv_usec cmp (uvp)->tv_usec)
\fBtimercmp\fP()  تقارن قيم المؤقت في \fIa\fP و \fIb\fP باستخدام عامل المقارنة
\fICMP\fP، وتُرجع صحيحًا (غير صفري) أو خطأ (0) اعتمادًا على نتيجة المقارنة.
بعض الأنظمة (ولكن ليس Linux/glibc)، لديها تطبيق \fBtimercmp\fP()  معطوب، حيث لا
تعمل \fICMP\fP من \fI>=\fP، \fI<=\fP، و \fI==\fP؛ يمكن للتطبيقات المحمولة بدلاً
من ذلك استخدام
.P
.in +4n
.EX
!timercmp(..., <)
!timercmp(..., >)
!timercmp(..., !=)
.EE
.in
.SH "قيمة الإرجاع"
\fBtimerisset\fP()  و \fBtimercmp\fP()  تُرجعان صحيحًا (غير صفري) أو خطأ (0).
.SH الأخطاء
لم تُعرّف أي أخطاء.
.SH المعايير
لا شيء.
.SH التاريخ
BSD.
.SH "انظر أيضًا"
\fBgettimeofday\fP(2), \fBtime\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .