工具鏈
這個模組透過巨集定義工具鍊抽象層。
摘要
使用方式：
typedef
OT_TOOL_PACKED_BEGIN
struct
{
char mField1;
union
{
char mField2;
long mField3;
} OT_TOOL_PACKED_FIELD;
} OT_TOOL_PACKED_END packed_struct_t;
巨集
OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT
OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT __VA_ARGS__
OT_FALL_THROUGH
OT_FALL_THROUGH do \
{ \
} while (false) /* fallthrough */
在特定編譯器中隱藏略過警告。
OT_MUST_USE_RESULTS
OT_MUST_USE_RESULT
編譯類別專屬指示，指出類別或列舉必須是函式的傳回值。
OT_TOOL_PACKED_BEGIN
OT_TOOL_PACKED_BEGIN
編譯器專用類別，指出類別或結構必須含有位元組封包。
OT_TOOL_PACKED_FIELD
OT_TOOL_PACKED_FIELD
向編譯器指出要封裝在位元組封裝類別或結構中的巢狀結構或結構。
OT_TOOL_PRINTF_style_FORMAT_ARG_Check
OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK
這個巨集指定函式或方法使用 printf 樣式引數，且應根據格式字串進行型式檢查。
您必須在函式/方法宣告後方加上這個巨集。例如：
void MyPrintf(void *aObject, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2, 3);
兩個引數索引值會指出格式字串和第一個要檢查的引數。每個函式中的第一個參數在索引 1 開始，在方法中的第一個參數則是從索引 2 開始。
| 詳細說明 | |||||
|---|---|---|---|---|---|
| 參數 |
|
||||
OT_TOOL_WEAK
OT_TOOL_WEAK
編譯器專屬的弱符號修飾符。
OT_UNREACHABLE_CODE
OT_UNREACHABLE_CODE CODE
隱藏特定工具鍊中的無法連上程式碼警告。
OT_UNused_VARIABLE
OT_UNUSED_VARIABLE do \
{ \
(void)(VARIABLE); \
} while (false)
隱藏特定工具鍊中未使用的變數警告。
資源
OpenThread API 參考資料主題出自原始碼，可於 GitHub 取得。如需更多資訊，或想參閱我們的說明文件，請參閱資源。