Cadena de herramientas
En este módulo, se define una capa de abstracción de la cadena de herramientas a través de macros.
Resumen
Uso:
typedef OT_TOOL_PACKED_BEGIN struct { char mField1; union { char mField2; long mField3; } OT_TOOL_PACKED_FIELD; } OT_TOOL_PACKED_END packed_struct_t;
Macros
OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT
OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT __VA_ARGS__
OT_FALL_THROUGH
OT_FALL_THROUGH do \ { \ } while (false) /* fallthrough */
Elimina las advertencias de incumplimiento en un compilador específico.
OT_MUST_USE_RESULT
OT_MUST_USE_RESULT
Indicación específica del compilador de que se debe usar una clase o enum cuando es el valor que se muestra de una función.
OT_TOOL_PACKED_BEGIN
OT_TOOL_PACKED_BEGIN
Indicación específica del compilador de que una clase o struct debe estar empaquetado en bytes.
OT_TOOL_PACKED_FIELD
OT_TOOL_PACKED_FIELD
Indica al compilador que una struct o unión anidada debe empaquetarse dentro de una struct o clase empaquetada de bytes.
OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK
OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK
Especifica que una función o un método toma argumentos de estilo printf
y debe verificarse con respecto a una string de formato.
Debe agregarse después de la declaración de la función o el método. Por ejemplo:
void MyPrintf(void *aObject, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2, 3);
Los dos valores de índice de los argumentos indican la string de formato y el primer argumento para verificar con ella. Comienzan en el índice 1 para el primer parámetro de una función y en el índice 2 para el primer parámetro de un método.
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
OT_TOOL_WEAK
OT_TOOL_WEAK
Modificador de símbolo débil específico del compilador.
OT_UNREACHABLE_CODE
OT_UNREACHABLE_CODE CODE
Elimina la advertencia de código Inaccesible en cadenas de herramientas específicas.
OT_UNUSED_VARIABLE
OT_UNUSED_VARIABLE do \ { \ (void)(VARIABLE); \ } while (false)
Elimina la advertencia de variables sin usar en cadenas de herramientas específicas.
Recursos
Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir a nuestra documentación, consulta Recursos.