nl::Weave::Logging

この名前空間には、共有ロギングをサポートする Weave 内のすべてのインターフェースが含まれます。

概要

このインターフェースには、Weave SDK のプラットフォームに依存しないロギング インターフェース用のマクロ、定数、関数が含まれています。

Weave SDK クライアントは、コンパイル時に、Android、C 標準 I/O、または外部(プラットフォームおよびインテグレータ定義)のロギング スタイル実装の中から、次のプリプロセッサ シンボルのいずれかがアサートされたときに呼び出される外部ロギング スタイル実装から選択できます。

列挙型

@406 enum
LogCategory enum
特定のエラー メッセージが属するカテゴリを指定します。
LogModule enum
ログメッセージのソースとなるコードの論理セクションを識別します。

Typedef

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
プラットフォーム指定のメカニズムに対して、指定されたカテゴリ category にある指定されたモジュール module の指定されたログ メッセージ msg をログに記録します。
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

ログメッセージのソースとなるコードの論理セクションを識別します。

Typedef

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

プラットフォーム指定のメカニズムに対して、指定されたカテゴリ category にある指定されたモジュール module の指定されたログ メッセージ msg をログに記録します。

詳細
パラメータ
[in] module
ログ メッセージを生成した Weave パッケージ モジュールのソースを示す LogModule 列挙型。ログメッセージに含めるには、関数内でモジュール名に変換する必要があります。
[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
)