透過集合功能整理內容 你可以依據偏好儲存及分類內容。

工具鏈

這個模組透過巨集定義工具鍊抽象層。

摘要

使用方式:

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 開始。

詳細說明
參數
[in] aFmtIndex
格式字串的引數索引。
[in] aStartIndex
第一個要檢查格式字串的引數索引。

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 取得。如需更多資訊,或想參閱我們的說明文件,請參閱資源