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 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__
Thêm giờ chơi
OT_FALL_THROUGH do \ { \ } while (false) /* fallthrough */
Ngăn chặn tình trạng rơi qua cảnh báo trong một trình biên dịch cụ thể.
HP_MUST_USE_RESULT
OT_MUST_USE_RESULT
Chỉ báo dành riêng cho trình biên dịch rằng một lớp hoặc enum phải được sử dụng khi đó là giá trị trả về của một hàm.
Hàm OT_TOOL_PACKED_BEGIN
OT_TOOL_PACKED_BEGIN
Chỉ báo dành riêng cho trình biên dịch rằng một lớp hoặc cấu trúc phải được đóng gói byte.
Hàm 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 hợp lồng nhau cần được đóng gói trong lớp hoặc cấu trú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 sẽ nhận các đối số kiểu printf
và cần được đánh dấu loại đối với 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 cần kiểm tra. Chúng bắt đầu ở chỉ mục 1 cho tham số đầu tiên trong một hàm và ở chỉ mục 2 cho tham số đầu tiên trong một phương thức.
Thông tin chi tiết | |||||
---|---|---|---|---|---|
Các tham số |
|
Hàm OT_TOOL_WEAK
OT_TOOL_WEAK
Công cụ sửa đổi biểu tượng yếu cụ thể của trình biên dịch.
Hàm OT_UNREACHABLE_CODE
OT_UNREACHABLE_CODE CODE
Ngăn cảnh báo Không thể truy cập mã trong các chuỗi công cụ cụ thể.
Hàm OT_UNUSED_VARIABLE
OT_UNUSED_VARIABLE do \ { \ (void)(VARIABLE); \ } while (false)
Chặn cảnh báo về biến không sử dụng trong chuỗi công cụ cụ thể.
Tài nguyên
Các chủ đề Tham chiếu API OpenThread bắt nguồn từ mã nguồn, có sẵn 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 phần Tài nguyên.