.\" -*- coding: UTF-8 -*-
'\" t
.\" SPDX-License-Identifier: 0BSD
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH timespec_get 3 "11 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
timespec_get, timespec_getres \- واجهة ISO C لدوال الساعة والوقت
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <time.h>\fP
.P
\fBint timespec_get(struct timespec *\fP\fIres\fP\fB, int \fP\fIbase\fP\fB);\fP
\fBint timespec_getres(struct timespec *\fP\fItp\fP\fB, int \fP\fIbase\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBtimespec_get\fP()، \fBTIME_UTC\fP:
.nf
    _ISOC11_SOURCE
.fi
.P
\fBtimespec_getres\fP()، \fBTIME_MONOTONIC\fP، \fBTIME_ACTIVE\fP،
\fBTIME_THREAD_ACTIVE\fP:
.nf
    _ISOC23_SOURCE
.fi
.SH الوصف
تخزّن الدالة \fBtimespec_get\fP() الوقت الحالي، بناءً على قاعدة الوقت المحددة،
في بنية \fBtimespec\fP(3type) المشار إليها بواسطة \fIres\fP.
.P
تخزّن الدالة \fBtimespec_getres\fP() دقة الأوقات المسترجعة بواسطة
\fBtimespec_get\fP() مع قاعدة الوقت المحددة في بنية \fBtimespec\fP(3type) المشار
إليها بواسطة \fItp\fP، إذا كان \fItp\fP غير NULL. لقاعدة وقت معينة، تكون الدقة
ثابتة طوال عمر العملية المستدعية.
.P
قاعدة الوقت \fIbase\fP هي إحدى التاليات:
.TP 
\fBTIME_UTC\fP
قاعدة وقت على مستوى النظام تقيس الوقت الحقيقي (أي وقت الساعة
الحائطية). الوقت والدقة في قاعدة الوقت هذه هما نفس تلك المسترجعة بواسطة
\fIclock_gettime(CLOCK_REALTIME,\ res)\fP و \fIclock_getres(CLOCK_REALTIME,\ tp)\fP، على التوالي.
.TP 
\fBTIME_MONOTONIC\fP
قاعدة وقت تقيس الوقت منذ نقطة غير محددة في الماضي، حيث لن ينقص الوقت داخل
العملية حتى لو ضُبطت أو عُدّلت ساعة الوقت الحقيقي للنظام. الوقت والدقة في
قاعدة الوقت هذه هما نفس تلك المسترجعة بواسطة
\fIclock_gettime(CLOCK_MONOTONIC,\ res)\fP و \fIclock_getres(CLOCK_MONOTONIC,\ tp)\fP، على التوالي.
.TP 
\fBTIME_ACTIVE\fP
قاعدة وقت خاصة بالعملية تقيس وقت وحدة المعالجة المركزية المستهلك بواسطة
العملية المستدعية. الوقت والدقة في قاعدة الوقت هذه هما نفس تلك المسترجعة
بواسطة \fIclock_gettime(CLOCK_PROCESS_CPUTIME_ID,\ res)\fP و
\fIclock_getres(CLOCK_PROCESS_CPUTIME_ID,\ tp)\fP، على التوالي.
.TP 
\fBTIME_THREAD_ACTIVE\fP
قاعدة وقت خاصة بالخيط تقيس وقت وحدة المعالجة المركزية المستهلك بواسطة الخيط
المستدعي. الوقت والدقة في قاعدة الوقت هذه هما نفس تلك المسترجعة بواسطة
\fIclock_gettime(CLOCK_THREAD_CPUTIME_ID,\ res)\fP و
\fIclock_getres(CLOCK_THREAD_CPUTIME_ID,\ tp)\fP، على التوالي.
.SH "قيمة الإرجاع"
تُرجع \fBtimespec_get\fP() \fIbase\fP غير الصفري إذا كانت قاعدة وقت مدعومة وتم
استرجاع الوقت الحالي بنجاح، أو 0 بخلاف ذلك.
.P
تُرجع \fBtimespec_getres\fP() \fIbase\fP غير الصفري إذا كانت قاعدة وقت مدعومة، أو
0 بخلاف ذلك.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBtimespec_get\fP()،
\fBtimespec_getres\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
.TP 
\fBtimespec_get\fP()
C23، ‏POSIX.1\-2024.
.TQ
\fBTIME_UTC\fP
C23 (رغم أن ISO C لا يُحدد حقبة الزمن)، POSIX.1\-2024.
.TP 
\fBtimespec_getres\fP()
.TQ
\fBTIME_MONOTONIC\fP
.TQ
\fBTIME_ACTIVE\fP
.TQ
\fBTIME_THREAD_ACTIVE\fP
C23.
.SH التاريخ
.TP 
\fBtimespec_get\fP()
.TQ
\fBTIME_UTC\fP
C11، POSIX.1\-2024، glibc 2.16، musl 1.1.10.
.TP 
\fBtimespec_getres\fP()
C23، glibc 2.34.
.TP 
\fBTIME_MONOTONIC\fP
.TQ
\fBTIME_ACTIVE\fP
.TQ
\fBTIME_THREAD_ACTIVE\fP
C23، glibc 2.43.
.SH "انظر أيضًا"
\fBclock_gettime\fP(2)، \fBclock_getres\fP(2)
.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 .