تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

nl::Weave::System::Timer

#include <src/system/SystemTimer.h>

هذه فئة داخلية لـ طبقة نظام Weave، وتُستخدم لتمثيل موقّت لقطة واحدة قيد التقدم.

ملخّص

لا توجد واجهة عامة حقيقية متاحة لطبقة التطبيق. تعتبر الطرق العامة الثابتة المستخدمة لاكتساب وقت النظام الحالي مخصّصة للاستخدام الداخلي.

الاكتساب

يكتسب من: nl::Weave::System::Object

الأنواع العلنية
`Epoch`	typedef `uint64_t` يمثّل هذا المقياس فترة في المقياس الزمني للنظام المحلي عادةً، المقياس الزمني POSIX.
`OnCompleteFunct)(Layer aLayer, void aAppState, Error aError)`	typedef `void(*`

السمات العامة
`OnComplete`	`OnCompleteFunct`

الدوال الثابتة العامة
`GetCurrentEpoch(void)`	`Epoch` تعرض هذه الطريقة الحقبة الحالية، بعد تصحيحها من خلال وضع سكون النظام باستخدام المقياس الزمني للنظام، بالمللي ثانية.
`GetStatistics(nl::Weave::System::Stats::count_t & aNumInUse, nl::Weave::System::Stats::count_t & aHighWatermark)`	`void`
`IsEarlierEpoch(const Epoch & first, const Epoch & second)`	`bool` للمقارنة بين قيمتي Timer::Epoch وعرض القيمة true إذا كانت القيمة الأولى أقدم من القيمة الثانية.

الدوال العامة
`Cancel(void)`	`Error` تؤدي هذه الطريقة إلى إلغاء تهيئة كائن الموقّت ومنع تنشيط هذا المؤقت إذا لم يحدث ذلك.
`Start(uint32_t aDelayMilliseconds, OnCompleteFunct aOnComplete, void *aAppState)`	`Error` تُستخدَم هذه الطريقة لتسجيل موقّت لمرة واحدة باستخدام آلية الموقّت الأساسية التي توفّرها المنصّة.

الأنواع العلنية

الحقبة

uint64_t Epoch

يمثّل هذا المقياس فترة في المقياس الزمني للنظام المحلي عادةً، المقياس الزمني POSIX.

وتعتمد الوحدات على السياق. إذا تم استخدامها مع القيم التي تم إرجاعها بواسطة GetCurrentEpoch، فإن الوحدات تكون بالملي ثانية.

OnCompleteFunct

void(* OnCompleteFunct)(Layer *aLayer, void *aAppState, Error aError)

السمات العامة

OnComplete

OnCompleteFunct OnComplete

الدوال الثابتة العامة

GetCurrentEpoch

Epoch GetCurrentEpoch(
  void
)

تعرض هذه الطريقة الحقبة الحالية، بعد تصحيحها من خلال وضع سكون النظام باستخدام المقياس الزمني للنظام، بالمللي ثانية.

مهمل يُرجى استخدام System::Layer::GetClock_MonotonicMS() بدلاً من ذلك.

التفاصيل
المرتجعات	الطابع الزمني بالمللي ثانية.

GetStatistics

void GetStatistics(
  nl::Weave::System::Stats::count_t & aNumInUse,
  nl::Weave::System::Stats::count_t & aHighWatermark
)

IsEarlierEpoch

bool IsEarlierEpoch(
  const Epoch & first,
  const Epoch & second
)

للمقارنة بين قيمتي Timer::Epoch وعرض القيمة true إذا كانت القيمة الأولى أقدم من القيمة الثانية.

يشير ذلك المصطلح إلى واجهة برمجة تطبيقات ثابتة يتم استدعاؤها لمقارنة قيمتَين وقتيتَين. وتحاول واجهة برمجة التطبيقات هذه مراعاة التفاف الموقت على افتراض أن الفرق بين قيمتي الإدخال سيكون أكثر من نصف نطاق Epoch الرقمي فقط إذا حدث التفاف الموقت بين العينة.

التفاصيل
المرتجعات	true إذا كانت المعلمة الأولى قبل الثانية، أو false في الحالات الأخرى.

الدوال العامة

إلغاء

Error Cancel(
  void
)

تؤدي هذه الطريقة إلى إلغاء تهيئة كائن الموقّت ومنع تنشيط هذا المؤقت إذا لم يحدث ذلك.

التفاصيل

قيم الإرجاع

WEAVE_SYSTEM_NO_ERROR

بدون شروط.

بدء

Error Start(
  uint32_t aDelayMilliseconds,
  OnCompleteFunct aOnComplete,
  void *aAppState
)

تُستخدَم هذه الطريقة لتسجيل موقّت لمرة واحدة باستخدام آلية الموقّت الأساسية التي توفّرها المنصّة.

التفاصيل

المَعلمات

`[in] aDelayMilliseconds`	عدد المللي ثانية قبل تنشيط هذا الموقّت
`[in] aOnComplete`	مؤشر يشير إلى وظيفة معاودة الاتصال عند تنشيط هذا الموقّت.
`[in] aAppState`	مؤشر عشوائي يتم تمريره إلى onComplete عند تنشيط هذا الموقّت

قيم الإرجاع

WEAVE_SYSTEM_NO_ERROR

بدون شروط.