nl::Weave::Logging

這個命名空間包含 Weave 中的所有介面,提供共用記錄支援。

摘要

介麵包含 Weave SDK 與平台無關記錄介面的巨集、常數和函式。

Weave SDK 用戶端可以選擇在編譯期間選擇 Android、C 標準 I/O,或外部 (平台和整合商定義) 記錄樣式實作項目。宣告下列任一預先處理器符號後,就會叫用這些實作項目:

列舉

@406 列舉
LogCategory 列舉
識別特定錯誤訊息所屬的類別。
LogModule 列舉
識別做為記錄訊息來源的邏輯區段程式碼。

Typedefs

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
記錄在平台指定的機制、指定記錄訊息 訊息,指定模組為模組模組類別
PrintMessagePrefix(uint8_t module)
void
SetLogFilter(uint8_t category)
NL_DLL_EXPORT void
SetLogFunct(LogMessageFunct logFunct)
NL_DLL_EXPORT void

列舉

@406

 @406

LogCategory

 LogCategory

識別特定錯誤訊息所屬的類別。

LogModule

 LogModule

識別做為記錄訊息來源的邏輯區段程式碼。

Typedefs

LogMessageFunct

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

變數

ModuleNames

const char ModuleNames[]

gLogFilter

uint8_t gLogFilter = kLogCategory_Max

gLogFunct

LogMessageFunct gLogFunct = DefaultLogMessage

函式

GetCategoryName

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

GetLogFilter

NL_DLL_EXPORT uint8_t GetLogFilter()

GetMessageWithPrefix

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

GetModuleName

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,
  ...
)

記錄在平台指定的機制、指定記錄訊息 訊息,指定模組為模組模組類別

詳細資料
參數
[in] module
一個 LogModule 列舉,指出產生記錄訊息的 Weave 套件模組來源。這必須在函式中轉譯為模組名稱,才能納入記錄訊息。
[in] category
LogCategory 列舉,指出記錄訊息的類別。如果 WEAVE_LOG_FILTERING 已聲明著作權,可能會篩選出該類別。
[in] msg
以 C 標準程式庫樣式格式指定碼 (包含要格式化和記錄的記錄訊息) 的 NULL 結尾 C 字串指標。
[in] ...
變數引數清單的元素應對應至 msg 中的格式指定碼。

PrintMessagePrefix

void PrintMessagePrefix(
  uint8_t module
)

SetLogFilter

NL_DLL_EXPORT void SetLogFilter(
  uint8_t category
)

SetLogFunct

NL_DLL_EXPORT void SetLogFunct(
  LogMessageFunct logFunct
)