Chaîne d'outils

Ce module définit une couche d'abstraction de la chaîne d'outils via des macros.

Résumé

Utilisation :

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

Supprimez l'avertissement dans un compilateur spécifique.

OT_MUST_USE_RESULT

 OT_MUST_USE_RESULT

Indication spécifique au compilateur qu'une classe ou une énumération doit être utilisée lorsqu'il s'agit de la valeur de retour d'une fonction.

OT_TOOL_PACKED_BEGIN

 OT_TOOL_PACKED_BEGIN

Indication spécifique au compilateur qu'une classe ou un struct doit être compressée en octets.

OT_TOOL_PACKED_FIELD

 OT_TOOL_PACKED_FIELD

Indique au compilateur une structure ou une union imbriquée à empaqueter dans une classe ou un struct compacté.

OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK

 OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK

Indique qu'une fonction ou méthode accepte des arguments de style printf et doit être vérifiée au type par rapport à une chaîne de format.

Doit être ajouté après la déclaration de la fonction/méthode. Exemple :

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

Les deux valeurs d'index d'arguments indiquent la chaîne de format et le premier argument à comparer. Ils commencent à l'index 1 pour le premier paramètre d'une fonction et à l'index 2 pour le premier paramètre d'une méthode.

Détails
Paramètres
[in] aFmtIndex
Index d'argument de la chaîne de format.
[in] aStartIndex
Index d'argument du premier argument à comparer à la chaîne de format.

OT_TOOL_WEAK

 OT_TOOL_WEAK

Modificateur de symboles faibles spécifique au compilateur.

OT_UNREACHABLE_CODE

 OT_UNREACHABLE_CODE CODE

Supprimez l'avertissement "Code inaccessible" dans des chaînes d'outils spécifiques.

OT_UNUSED_VARIABLE

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

Supprimez l'avertissement concernant les variables inutilisées dans des chaînes d'outils spécifiques.

Ressources

Les sujets de référence de l'API OpenThread proviennent du code source, disponible sur GitHub. Pour en savoir plus ou pour contribuer à notre documentation, consultez la section Ressources.