Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

offsetof — pomak člana unutar objekta

Makron offsetof iz <cstddef> određuje pomak člana u bajtovima od početka objekta. Omogućuje provjeru rasporeda memorije, ali za prenosivu upotrebu potreban je tip standardnog rasporeda.

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

Sintaksa

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

offsetof(type, member-designator) iz <cstddef> daje cjelobrojni konstantni izraz tipa std::size_t: pomak navedenog člana u bajtovima od početka objekta. Argumenti su tip i oznaka člana, a ne instanca objekta. To je makron; pišite offsetof, a ne std::offsetof.

Za prenosivu upotrebu odaberite tip standardnog rasporeda. Podrška za druge vrste klasa uvjetna je: implementacija je ne mora pružati. Primjena na statični podatkovni član ili člansku funkciju ima nedefinirano ponašanje. Nemojte ga primjenjivati na bitna polja. Valjan poziv ne izbacuje iznimke.

Poravnanje može umetnuti bajtove za popunu između članova. Zato nemojte pretpostaviti da je pomak jednak zbroju veličina prethodnih članova ili da ima istu vrijednost na svim platformama. Sam offsetof ne daje prenosiv format serijalizacije.

Primjer provjerava std::is_standard_layout_v<Record> i izračunava offset tijekom kompilacije. Umjesto ispisa broja ovisnog o platformi, provjerava zajamčen odnos: value se nalazi iza tag. Očekivani izlaz je true nakon kojeg slijedi novi redak.

Primjeri

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

Rezultat

true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori