clock(3)

الاسم
clock - تحديد زمن المعالج

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

موجز
#include <time.h>

clock_t clock(void);

الوصف
الدالة clock() ترجع تقريبًا لزمن المعالج المستخدم بواسطة البرنامج.

قيمة الإرجاع
القيمة المرجعة هي زمن وحدة المعالجة المركزية المستخدم حتى الآن كـ clock_t; للحصول على عدد الثواني المستخدمة، اقسم على CLOCKS_PER_SEC. إذا كان زمن المعالج المستخدم غير متاح أو لا يمكن تمثيل قيمته، ترجع الدالة القيمة (clock_t) -1.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
clock() | سلامة الخيوط | MT-Safe

الإصدارات
تتطلب XSI أن يساوي CLOCKS_PER_SEC 1000000 بغض النظر عن الدقة الفعلية.

في عدة تطبيقات أخرى، القيمة المرجعة بواسطة clock() تتضمن أيضًا أزمنة أي عمليات فرعية جُمعت حالتها عبر wait(2) (أو استدعاء آخر من نوع الانتظار). لا يتضمن Linux أزمنة العمليات الفرعية المنتظرة في القيمة المرجعة بواسطة clock(). الدالة times(2) التي ترجع صراحة معلومات (منفصلة) عن المستدعي وعملياته الفرعية، قد تكون مفضلة.

المعايير
C11, POSIX.1-2008.

التاريخ
POSIX.1-2001، C89.

في glibc 2.17 وما قبله، نُفذت clock() فوق times(2). لتحسين الدقة، منذ glibc 2.18، نُفذت فوق clock_gettime(2) (باستخدام ساعة CLOCK_PROCESS_CPUTIME_ID).

ملاحظات
يسمح معيار C بقيم عشوائية في بداية البرنامج; اطرح القيمة المرجعة من استدعاء clock() في بداية البرنامج للحصول على أقصى قابلية للنقل.

لاحظ أن الزمن يمكن أن يلتف. على نظام 32 بت حيث يساوي CLOCKS_PER_SEC 1000000، سترجع هذه الدالة نفس القيمة تقريبًا كل 72 دقيقة.

انظر أيضًا
clock_gettime(2), getrusage(2), times(2)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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