Portautensili

Questo modulo definisce un livello di astrazione della Toolchain tramite le macro.

Riepilogo

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;

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 */

Elimina avvisi di tipo "fall-through" in un compilatore specifico.

OT_MUST_USE_RESULT

 OT_MUST_USE_RESULT

Indicazione specifica del compilatore che deve essere utilizzata una classe o un'enumerazione quando è il valore restituito da una funzione.

Nota: questa opzione è attualmente disponibile solo con clang (C++17 lo implementa come attributo [[nodiscard]]).

Nota: per eliminare l'avviso/errore "unused-result", usa l'opzione del compilatore "-Wno-unused-result".

OT_TOOL_PACKED_BEGIN

 OT_TOOL_PACKED_BEGIN

Indicazione specifica del compilatore che una classe o uno struct deve essere pacchettizzato in byte.

OT_TOOL_PACKED_FIELD

 OT_TOOL_PACKED_FIELD

Indica al compilatore uno struct o un'unione nidificati da pacchettizzare all'interno di una classe o uno struct con pacchetti di byte.

OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK

 OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK

Specifica che una funzione o un metodo accetta argomenti di stile printf e deve essere controllato in base a una stringa di formato.

Deve essere aggiunto dopo la dichiarazione di funzione/metodo. Ad esempio:

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

I due valori di indice dell'argomento indicano la stringa di formato e il primo argomento da verificare. A partire dall'indice 1 per il primo parametro in una funzione e dall'indice 2 per il primo parametro in un metodo.

Dettagli
Parametri	[in] aFmtIndex L'indice dell'argomento della stringa di formato. [in] aStartIndex L'indice dell'argomento del primo argomento da verificare rispetto alla stringa di formato.

OT_TOOL_WEAK

 OT_TOOL_WEAK

Modificatore di simbolo debole specifico del compilatore.

OT_UNREACHABLE_CODE

 OT_UNREACHABLE_CODE CODE

Elimina l'avviso di codice non raggiungibile in Toolchain specifiche.

OT_UNUSED_VARIABLE

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

Elimina l'avviso sulle variabili inutilizzate in Toolchain specifiche.

Risorse

Gli argomenti di riferimento dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.