Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

offsetof — posun člena vnútri objektu

Makro offsetof z <cstddef> určuje bajtový posun člena od začiatku objektu. Umožňuje kontrolovať rozloženie pamäte, ale prenositeľné použitie vyžaduje typ so štandardným rozložením.

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

Syntax

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

offsetof(type, member-designator) z <cstddef> vytvára celočíselný konštantný výraz typu std::size_t: bajtový posun určeného člena od začiatku objektu. Argumentmi sú typ a označenie člena, nie inštancia objektu. Je to makro; píšte offsetof, nie std::offsetof.

Na prenositeľné použitie vyberte typ so štandardným rozložením. Podpora iných typov tried je podmienená: implementácia ju nemusí poskytovať. Použitie na statický dátový člen alebo členskú funkciu má nedefinované správanie. Nepoužívajte ho na bitové polia. Platné volanie nevyvoláva výnimky.

Zarovnanie môže medzi členmi vytvoriť výplňové bajty. Nepredpokladajte preto, že posun sa rovná súčtu veľkostí predchádzajúcich členov alebo že má na všetkých platformách rovnakú hodnotu. Samotné offsetof neposkytuje prenositeľný serializačný formát.

Príklad overuje std::is_standard_layout_v<Record> a počíta offset pri preklade. Namiesto vypísania čísla závislého od platformy testuje zaručený vzťah: value sa nachádza za tag. Očakávaný výstup je true nasledované znakom nového riadka.

Príklady

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

Výsledok

true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje