Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

offsetof — offset in byte di un sottoggetto

La macro offsetof di <stddef.h> fornisce l’offset di un sottoggetto dall’inizio di un oggetto come espressione costante di tipo size_t.

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

Sintassi

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

offsetof(type, member-designator) di <stddef.h> è una macro, non una funzione. Produce un’espressione costante intera di tipo size_t: l’offset in byte del sottoggetto designato dall’inizio di un oggetto di tipo type.

Il layout di una struttura può includere byte di padding, quindi non sommare le dimensioni dei membri precedenti. Il primo membro di una struttura ha offset zero; gli altri offset possono dipendere dall’implementazione. Stampa il risultato con %zu.

Per un ipotetico static type t;, &(t.member-designator) deve essere una costante di indirizzo. Un campo di bit o la definizione di un nuovo tipo nell’argomento type causa comportamento indefinito. Dichiara prima il tipo.

Esempi

#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;
}

Risultato

tag offset: 0
value follows tag: 1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti