offsetof

Das Makro offsetof expandiert zu einem Integer-Konstantenausdruck vom Typ size_t , dessen Wert das Offset in Bytes vom Anfang eines Objekts des angegebenen Typs zu seinem angegebenen Unterobjekt ist, einschließlich eventueller Auffüllbytes.

Gegeben ein Objekt o vom Typ type mit statischer Speicherdauer, & ( o. member ) muss ein Adresskonstantenausdruck sein und auf ein Unterobjekt von o zeigen. Andernfalls ist das Verhalten undefiniert.

Hinweise

Wenn offsetof auf ein Bitfeld-Member angewendet wird, ist das Verhalten undefiniert, da die Adresse eines Bitfelds nicht genommen werden kann.

member ist nicht auf ein direktes Mitglied beschränkt. Es kann ein Unterobjekt eines bestimmten Mitglieds bezeichnen, wie beispielsweise ein Element eines Array-Mitglieds.

Obwohl in C23 spezifiziert ist, dass die Angabe eines neuen Typs mit einem nicht eingeklammerten Komma in offsetof undefiniertes Verhalten darstellt, wird eine solche Verwendung generell selbst in früheren Modi nicht unterstützt: offsetof ( struct Foo { int a, b ; } , a ) führt generell zu einem Kompilierungsfehler.

Beispiel

#include <stdio.h>
#include <stddef.h>
struct S {
    char c;
    double d;
};
int main(void)
{
    printf("the first element is at offset %zu\n", offsetof(struct S, c));
    printf("the double is at offset %zu\n", offsetof(struct S, d));
}

the first element is at offset 0
the double is at offset 8

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C-Standards angewendet.

Siehe auch