本頁面由 Cloud Translation API 翻譯而成。

nl::Weave::Logging

此命名空間包含 Weave 中的所有介面，用於共用記錄支援。

摘要

這個介麵包括平台獨立於 Weave SDK 記錄介面的巨集、常數和函式。

Weave SDK 用戶端可在編譯期間選擇 Android、C 標準 I/O，或外部 (平台和整合商定義) 記錄樣式實作，而呼叫以下任一預先處理工具符號時就會叫用：

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

Variables
`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` 記錄至平台指定的機制，也就是提供的類別 category 中針對指定模組 module 的指定記錄訊息 msg。
`PrintMessagePrefix(uint8_t module)`	`void`
`SetLogFilter(uint8_t category)`	`NL_DLL_EXPORT void`
`SetLogFunct(LogMessageFunct logFunct)`	`NL_DLL_EXPORT void`

 @406

 LogCategory

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

 LogModule

識別程式碼的邏輯部分，做為記錄訊息的來源。

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

const char ModuleNames[]

uint8_t gLogFilter = kLogCategory_Max

LogMessageFunct gLogFunct = DefaultLogMessage

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

NL_DLL_EXPORT uint8_t GetLogFilter()

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

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

記錄至平台指定的機制，也就是提供的類別 category 中針對指定模組 module 的指定記錄訊息 msg。

詳細說明

參數

`[in] module`	LogModule 列舉，指出產生記錄訊息的 Weave 套件模組來源。必須在函式中轉譯為模組名稱，才能加入記錄訊息中。
`[in] category`	LogCategory 列舉，指出記錄訊息的類別。如果聲明「WEAVE_LOG_FILTERING」標示，系統可能會篩除類別或排除該類別。
`[in] msg`	指向以 NULL 結束的 C 字串的指標，該字串採用 C 標準程式庫樣式格式指定碼，其中包含要格式化和記錄的記錄訊息。
`[in] ...`	變異引數清單，其中的元素應對應至 msg 中的格式指定碼。

void PrintMessagePrefix(
  uint8_t module
)

NL_DLL_EXPORT void SetLogFilter(
  uint8_t category
)

NL_DLL_EXPORT void SetLogFunct(
  LogMessageFunct logFunct
)