.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, Thomas Koenig <ig25@rz.uni-karlsruhe.de>
.\" 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 clock 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
clock \- تحديد زمن المعالج
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <time.h>\fP
.P
\fBclock_t clock(void);\fP
.fi
.SH الوصف
الدالة \fBclock\fP()  ترجع تقريبًا لزمن المعالج المستخدم بواسطة البرنامج.
.SH "قيمة الإرجاع"
القيمة المرجعة هي زمن وحدة المعالجة المركزية المستخدم حتى الآن كـ
\fIclock_t\fP; للحصول على عدد الثواني المستخدمة، اقسم على \fBCLOCKS_PER_SEC\fP.
إذا كان زمن المعالج المستخدم غير متاح أو لا يمكن تمثيل قيمته، ترجع الدالة
القيمة \fI(clock_t)\ \-1\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBclock\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH الإصدارات
تتطلب XSI أن يساوي \fBCLOCKS_PER_SEC\fP 1000000 بغض النظر عن الدقة الفعلية.
.P
.\" I have seen this behavior on Irix 6.3, and the OSF/1, HP/UX, and
.\" Solaris manual pages say that clock() also does this on those systems.
.\" POSIX.1-2001 doesn't explicitly allow this, nor is there an
.\" explicit prohibition.  -- MTK
في عدة تطبيقات أخرى، القيمة المرجعة بواسطة \fBclock\fP()  تتضمن أيضًا أزمنة أي
عمليات فرعية جُمعت حالتها عبر \fBwait\fP(2)  (أو استدعاء آخر من نوع الانتظار).
لا يتضمن Linux أزمنة العمليات الفرعية المنتظرة في القيمة المرجعة بواسطة
\fBclock\fP().  الدالة \fBtimes\fP(2)  التي ترجع صراحة معلومات (منفصلة) عن
المستدعي وعملياته الفرعية، قد تكون مفضلة.
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، C89.
.P
في glibc 2.17 وما قبله، نُفذت \fBclock\fP()  فوق \fBtimes\fP(2).  لتحسين الدقة،
منذ glibc 2.18، نُفذت فوق \fBclock_gettime\fP(2)  (باستخدام ساعة
\fBCLOCK_PROCESS_CPUTIME_ID\fP).
.SH ملاحظات
يسمح معيار C بقيم عشوائية في بداية البرنامج; اطرح القيمة المرجعة من استدعاء
\fBclock\fP()  في بداية البرنامج للحصول على أقصى قابلية للنقل.
.P
لاحظ أن الزمن يمكن أن يلتف.  على نظام 32 بت حيث يساوي \fBCLOCKS_PER_SEC\fP
1000000، سترجع هذه الدالة نفس القيمة تقريبًا كل 72 دقيقة.
.SH "انظر أيضًا"
\fBclock_gettime\fP(2), \fBgetrusage\fP(2), \fBtimes\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 .