KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

offsetof — de offset van een member binnen een object

De macro offsetof uit <cstddef> bepaalt de byte-offset van een member vanaf het begin van een object. Hiermee kun je de geheugenindeling controleren, maar voor draagbaar gebruik is een standard-layout-type vereist.

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

Syntax

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

offsetof(type, member-designator) uit <cstddef> levert een integer-constante expressie van het type std::size_t op: de byte-offset van de aangewezen member vanaf het begin van een object. De argumenten zijn een type en een member-aanduiding, geen objectinstantie. Het is een macro; schrijf offsetof, niet std::offsetof.

Kies voor draagbaar gebruik een standard-layout-type. Ondersteuning voor andere klassentypen is voorwaardelijk: een implementatie hoeft die niet te bieden. Toepassing op een statisch gegevenslid of een memberfunctie leidt tot ongedefinieerd gedrag. Gebruik de macro niet voor bitvelden. Een geldige aanroep werpt geen uitzonderingen.

Uitlijning kan opvulbytes tussen members toevoegen. Ga er daarom niet van uit dat een offset gelijk is aan de som van de groottes van voorafgaande members of op elk platform dezelfde waarde heeft. offsetof alleen biedt geen draagbaar serialisatieformaat.

Het voorbeeld controleert std::is_standard_layout_v<Record> en berekent offset tijdens het compileren. In plaats van een platformafhankelijk getal af te drukken, test het een gegarandeerde relatie: value staat na tag. De verwachte uitvoer is true gevolgd door een regeleinde.

Voorbeelden

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

Resultaat

true

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.

Bronnen