Chuỗi công cụ

Mô-đun này xác định lớp trừu tượng của chuỗi công cụ thông qua các macro.

Tóm tắt

Cách sử dụng:

typedef
OT_TOOL_PACKED_BEGIN
struct
{
    char mField1;
    union
    {
        char mField2;
        long mField3;
    } OT_TOOL_PACKED_FIELD;
} OT_TOOL_PACKED_END packed_struct_t;

Macro

OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT

 OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT __VA_ARGS__

OT_FALL_THROUGH

 OT_FALL_THROUGH do                  \
    {                   \
    } while (false) /* fallthrough */

Loại bỏ tình trạng rơi qua cảnh báo trong trình biên dịch cụ thể.

OT_MUST_USE_RESULT

 OT_MUST_USE_RESULT

Chỉ báo dành riêng cho trình biên dịch cho biết phải sử dụng một lớp hoặc enum khi đó là giá trị trả về của một hàm.

OT_TOOL_PACKED_BEGIN

 OT_TOOL_PACKED_BEGIN

Chỉ báo dành riêng cho trình biên dịch cho biết một lớp hoặc cấu trúc phải được gói byte.

OT_TOOL_PACKED_FIELD

 OT_TOOL_PACKED_FIELD

Cho trình biên dịch biết một cấu trúc hoặc liên kết lồng nhau sẽ được đóng gói trong lớp hoặc cấu trúc được đóng gói byte.

OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK

 OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK

Chỉ định rằng một hàm hoặc phương thức nhận các đối số kiểu printf và phải được kiểm tra kiểu dựa trên chuỗi định dạng.

Phải được thêm vào sau phần khai báo hàm/phương thức. Ví dụ:

void MyPrintf(void *aObject, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2, 3);

Hai giá trị chỉ mục đối số cho biết chuỗi định dạng và đối số đầu tiên để kiểm tra đối số đó. Chúng bắt đầu từ chỉ mục 1 cho tham số đầu tiên trong hàm và từ chỉ mục 2 cho tham số đầu tiên trong phương thức.

Thông tin chi tiết
Các tham số
[in] aFmtIndex
Chỉ mục đối số của chuỗi định dạng.
[in] aStartIndex
Chỉ mục đối số của đối số đầu tiên để kiểm tra với chuỗi định dạng.

OT_TOOL_WEAK

 OT_TOOL_WEAK

Đối tượng sửa đổi biểu tượng yếu dành riêng cho trình biên dịch.

OT_UNREACHABLE_CODE

 OT_UNREACHABLE_CODE CODE

Loại bỏ cảnh báo mã Không thể truy cập trong các chuỗi công cụ cụ thể.

OT_UNUSED_VARIABLE

 OT_UNUSED_VARIABLE do                               \
    {                                \
        (void)(VARIABLE);            \
    } while (false)

Loại bỏ cảnh báo về biến không dùng đến trong các chuỗi công cụ cụ thể.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.