Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

offsetof — posun členu uvnitř objektu

Makro offsetof z <cstddef> určuje bajtový posun členu od začátku objektu. Umožňuje kontrolovat rozložení paměti, ale přenositelné použití vyžaduje typ se standardním rozložením.

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

Syntaxe

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

offsetof(type, member-designator) z <cstddef> vytváří celočíselný konstantní výraz typu std::size_t: bajtový posun určeného členu od začátku objektu. Argumenty jsou typ a označení členu, nikoli instance objektu. Jde o makro; pište offsetof, nikoli std::offsetof.

Pro přenositelné použití zvolte typ se standardním rozložením. Podpora jiných typů tříd je podmíněná: implementace ji nemusí poskytovat. Použití na statický datový člen nebo členskou funkci má nedefinované chování. Nepoužívejte ho na bitová pole. Platné volání nevyvolává výjimky.

Zarovnání může mezi členy vložit výplňové bajty. Nepředpokládejte proto, že posun odpovídá součtu velikostí předchozích členů nebo že má na všech platformách stejnou hodnotu. Samotné offsetof neposkytuje přenositelný serializační formát.

Příklad ověřuje std::is_standard_layout_v<Record> a vypočítává offset při překladu. Místo výpisu čísla závislého na platformě testuje zaručený vztah: value se nachází za tag. Očekávaný výstup je true následované znakem nového řádku.

Pří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ýsledek

true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje