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

nl::Weave::التسجيل

تتضمن مساحة الاسم هذه جميع الواجهات ضمن Weave للحصول على دعم التسجيل المشترك.

الملخّص

وتتضمن الواجهات وحدات ماكرو وثوابت ودوال لواجهة واجهة تسجيل مستقلة عن حزمة Weave SDK.

يمكن لبرامج Weave SDK الاختيار في وقت التجميع بين عمليات تنفيذ نمط التسجيل Android أو C Standard I/O أو الخارجية (المحدّدة من خلال النظام الأساسي والمتكامل) التي سيتم استدعاؤها عند تأكيد أي من الرموز التالية لمعالج البيانات:

تعداد
`@406`	تعداد
`LogCategory`	تعداد تحدّد فئة تنتمي إليها رسالة خطأ معيّنة.
`LogModule`	تعداد يحدّد قسمًا منطقيًا للرمز وهو مصدر لرسائل السجلّ.

رفوف النوع
`LogMessageFunct)(uint8_t module, uint8_t category, const char *msg, va_list ap)`	typedef `void(*`

المتغيّرات
`ModuleNames[]`	`const char`
`gLogFilter = kLogCategory_Max`	`uint8_t`
`gLogFunct = DefaultLogMessage`	`LogMessageFunct`

الدوال
`GetCategoryName(char *buf, uint8_t bufSize, uint8_t category)`	`void`
`GetLogFilter()`	`NL_DLL_EXPORT uint8_t`
`GetMessageWithPrefix(char buf, uint8_t bufSize, uint8_t module, const char msg)`	`void`
`GetModuleName(char *buf, uint8_t module)`	`void`
`Log(uint8_t module, uint8_t category, const char *msg, ...)`	`NL_DLL_EXPORT __WEAVE_LOGGING_LINK_ATTRIBUTE void` السجلّ، من خلال الآلية التي تحدّدها المنصّة، رسالة السجلّ المحدّدة، message، للوحدة المحدّدة، module، في الفئة المحدّدة، category.
`PrintMessagePrefix(uint8_t module)`	`void`
`SetLogFilter(uint8_t category)`	`NL_DLL_EXPORT void`
`SetLogFunct(LogMessageFunct logFunct)`	`NL_DLL_EXPORT void`

تعداد

@406

 @406

فئة التسجيل

 LogCategory

تحدّد فئة تنتمي إليها رسالة خطأ معيّنة.

وحدة السجلّ

 LogModule

يحدّد قسمًا منطقيًا للرمز وهو مصدر لرسائل السجلّ.

رفوف النوع

LogMessageFunct

void(* LogMessageFunct)(uint8_t module, uint8_t category, const char *msg, va_list ap)

المتغيّرات

أسماء الوحدات

const char ModuleNames[]

فلترة gLog

uint8_t gLogFilter = kLogCategory_Max

سجلّ gLogFunct

LogMessageFunct gLogFunct = DefaultLogMessage

الدوال

اسم الفئة

void GetCategoryName(
  char *buf,
  uint8_t bufSize,
  uint8_t category
)

_GetGetFilter

NL_DLL_EXPORT uint8_t GetLogFilter()

GetMessageWithPrefix

void GetMessageWithPrefix(
  char *buf,
  uint8_t bufSize,
  uint8_t module,
  const char *msg
)

GetUnitName

void GetModuleName(
  char *buf,
  uint8_t module
)

سجل

NL_DLL_EXPORT __WEAVE_LOGGING_LINK_ATTRIBUTE void Log(
  uint8_t module,
  uint8_t category,
  const char *msg,
  ...
)

السجلّ، من خلال الآلية التي تحدّدها المنصّة، رسالة السجلّ المحدّدة، message، للوحدة المحدّدة، module، في الفئة المحدّدة، category.

التفاصيل

المعلَمات

`[in] module`	تعداد LogModule يشير إلى مصدر وحدة حزمة Weave التي أنشأت رسالة السجل. يجب ترجمة ذلك في الدالة إلى اسم وحدة لتضمينه في رسالة السجل.
`[in] category`	تعداد LogCategory يشير إلى فئة رسالة السجل. قد تتم تصفية الفئة أو خارجها إذا تم تأكيد WEAVE_LOG_FILTERING.
`[in] msg`	مؤشر إلى سلسلة C تم إنهاؤها بشكل خالٍ مع تحديدات التنسيق على شكل مكتبة C العادية التي تحتوي على رسالة السجل المطلوب تنسيقها وتسجيلها.
`[in] ...`	قائمة وسيطات متغيرة يجب أن تتوافق عناصرها مع محدّدات التنسيق في message.

بادئة الطباعة

void PrintMessagePrefix(
  uint8_t module
)

فلتر LogLog

NL_DLL_EXPORT void SetLogFilter(
  uint8_t category
)

ضبط السجلّ

NL_DLL_EXPORT void SetLogFunct(
  LogMessageFunct logFunct
)