Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

offsetof — décalage en octets d’un sous-objet

La macro offsetof de <stddef.h> donne le décalage d’un sous-objet depuis le début d’un objet sous la forme d’une expression constante de type size_t.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stddef.h>
offsetof(type, member-designator)

offsetof(type, member-designator) de <stddef.h> est une macro, pas une fonction. Elle produit une expression constante entière de type size_t : le décalage en octets du sous-objet désigné depuis le début d’un objet de type type.

La disposition d’une structure peut inclure des octets de remplissage ; ne faites donc pas la somme des tailles des membres précédents. Le premier membre d’une structure a un décalage nul ; les autres décalages peuvent dépendre de l’implémentation. Affichez le résultat avec %zu.

Pour un hypothétique static type t;, &(t.member-designator) doit être une constante d’adresse. Un champ de bits ou la définition d’un nouveau type dans l’argument type entraîne un comportement indéfini. Déclarez le type au préalable.

Exemples

#include <stddef.h>
#include <stdio.h>

struct Record {
    char tag;
    int value;
};

static_assert(offsetof(struct Record, tag) == 0);

int main(void)
{
    printf("tag offset: %zu\n", offsetof(struct Record, tag));
    printf("value follows tag: %d\n",
           offsetof(struct Record, value) >= sizeof(char));
    return 0;
}

Résultat

tag offset: 0
value follows tag: 1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources