ftime(3)

الاسم
ftime - إرجاع التاريخ والوقت

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

موجز
#include <sys/timeb.h>

[[مهمل]] int ftime(struct timeb *tp);

الوصف
ملاحظة: لم تعد هذه الدالة متوفرة في مكتبة C لجنو. استخدم clock_gettime(2) بدلاً منها.

تُرجع هذه الدالة الوقت الحالي كعدد الثواني والميلي ثانية منذ الحقبة، 1970-01-01 00:00:00 +0000 (UTC). يُرجع الوقت في tp، والذي يُصرّح به كالتالي:

    struct timeb {
        time_t         time;
        unsigned short millitm;
        short          timezone;
        short          dstflag;
    };

هنا time هو عدد الثواني منذ الحقبة، وmillitm هو عدد الميلي ثانية منذ time ثانية منذ الحقبة. حقل timezone هو المنطقة الزمنية المحلية مقاسة بدقائق غرب غرينتش (بقيمة سالبة تشير إلى دقائق شرق غرينتش). حقل dstflag هو علامة، إذا كانت غير صفرية، تشير إلى أن التوقيت الصيفي ساري محلياً خلال الجزء المناسب من السنة.

ينص POSIX.1-2001 على أن محتويات حقلي timezone وdstflag غير محددة؛ تجنب الاعتماد عليهما.

قيمة الإرجاع
تُرجع هذه الدالة دائماً 0. (يحدد POSIX.1-2001، وتوثقه بعض الأنظمة، إرجاع خطأ -1.)

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

المعايير
لا شيء.

التاريخ
4.2BSD. وُسمت كـ LEGACY في POSIX.1-2001؛ أُزيلت في POSIX.1-2008. أُزيلت في glibc 2.33.

هذه الدالة قديمة. لا تستخدمها. إذا كانت الثواني كافية، يمكن استخدام time(2)؛ يُعطي gettimeofday(2) الميكروثانية؛ يُعطي clock_gettime(2) النانوثانية لكنه ليس متاحاً على نطاق واسع.

العلل
glibc2 المبكرة معيبة وتُرجع 0 في حقل millitm؛ glibc 2.1.1 صحيح مرة أخرى.

انظر أيضًا
gettimeofday(2), time(2)

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

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

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