WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

offsetof — Byte-Offset eines Unterobjekts

Das Makro offsetof aus <stddef.h> liefert den Offset eines Unterobjekts vom Anfang eines Objekts als konstanten Ausdruck vom Typ size_t.

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

Syntax

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

offsetof(type, member-designator) aus <stddef.h> ist ein Makro, keine Funktion. Es liefert einen ganzzahligen konstanten Ausdruck vom Typ size_t: den Byte-Offset des bezeichneten Unterobjekts vom Anfang eines Objekts des Typs type.

Das Layout einer Struktur kann Auffüllbytes enthalten; addiere daher nicht die Größen vorhergehender Member. Das erste Strukturmember hat den Offset null; andere Offsets können von der Implementierung abhängen. Gib das Ergebnis mit %zu aus.

Für ein hypothetisches static type t; muss &(t.member-designator) eine Adresskonstante sein. Ein Bitfeld oder die Definition eines neuen Typs innerhalb des Arguments type führt zu undefiniertem Verhalten. Deklariere den Typ vorher.

Beispiele

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

Ergebnis

tag offset: 0
value follows tag: 1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen