WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

offsetof — Offset eines Members innerhalb eines Objekts

Das Makro offsetof aus <cstddef> ermittelt den Byte-Offset eines Members vom Anfang eines Objekts. Es ermöglicht Prüfungen des Speicherlayouts, doch für portable Verwendung ist ein Standard-Layout-Typ erforderlich.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <cstddef>
offsetof(type, member-designator)

offsetof(type, member-designator) aus <cstddef> ergibt einen ganzzahligen konstanten Ausdruck vom Typ std::size_t: den Byte-Offset des angegebenen Members vom Anfang eines Objekts. Die Argumente sind ein Typ und eine Member-Bezeichnung, keine Objektinstanz. Es handelt sich um ein Makro; schreibe offsetof, nicht std::offsetof.

Für portable Verwendung solltest du einen Standard-Layout-Typ wählen. Die Unterstützung für andere Klassentypen ist bedingt: Eine Implementierung muss sie nicht bereitstellen. Die Anwendung auf ein statisches Datenelement oder eine Memberfunktion führt zu undefiniertem Verhalten. Verwende es nicht für Bitfelder. Ein gültiger Aufruf löst keine Ausnahmen aus.

Die Ausrichtung kann zu Füllbytes zwischen den Membern führen. Gehe daher weder davon aus, dass ein Offset der Summe der Größen vorhergehender Member entspricht, noch dass er auf allen Plattformen gleich ist. offsetof allein bietet kein portables Serialisierungsformat.

Das Beispiel prüft std::is_standard_layout_v<Record> und berechnet offset zur Compilezeit. Statt eine plattformabhängige Zahl auszugeben, prüft es eine garantierte Beziehung: value befindet sich hinter tag. Die erwartete Ausgabe ist true gefolgt von einem Zeilenumbruch.

Beispiele

#include <cstddef>
#include <iostream>
#include <type_traits>

struct Record {
    char tag;
    int value;
};

static_assert(std::is_standard_layout_v<Record>);
constexpr std::size_t offset = offsetof(Record, value);
static_assert(offset >= sizeof(char));
static_assert(noexcept(offsetof(Record, value)));

int main() {
    std::cout << std::boolalpha
              << (offset >= sizeof(char)) << '\n';
}

Ergebnis

true

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