工具链

此模块通过宏定义工具链抽象层。

摘要

用法:

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_RESULT

 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 上提供的源代码。如需了解详情,或者为我们的文档做贡献,请参阅资源