CKTIS / C
offsetof — byte-offset van een subobject
De macro offsetof uit <stddef.h> geeft de offset van een subobject vanaf het begin van een object als een constante expressie van het type size_t.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stddef.h>
offsetof(type, member-designator)offsetof(type, member-designator) uit <stddef.h> is een macro, geen functie. De macro levert een integerconstante expressie van het type size_t: de byte-offset van het aangewezen subobject vanaf het begin van een object van het type type.
De indeling van een structuur kan opvulbytes bevatten, dus tel de groottes van voorafgaande members niet bij elkaar op. Het eerste member van een structuur heeft offset nul; andere offsets kunnen afhangen van de implementatie. Print het resultaat met %zu.
Voor een hypothetische static type t; moet &(t.member-designator) een adresconstante zijn. Een bitveld of het definiëren van een nieuw type binnen het argument type leidt tot ongedefinieerd gedrag. Declareer het type vooraf.
Voorbeelden
#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;
}
Resultaat
tag offset: 0 value follows tag: 1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.