Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

offsetof — odmik člana znotraj objekta

Makro offsetof iz <cstddef> določi odmik člana v bajtih od začetka objekta. Omogoča preverjanje postavitve pomnilnika, vendar prenosna uporaba zahteva tip s standardno postavitvijo.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

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

offsetof(type, member-designator) iz <cstddef> ustvari celoštevilski konstantni izraz tipa std::size_t: odmik določenega člana v bajtih od začetka objekta. Argumenta sta tip in oznaka člana, ne primerek objekta. Gre za makro; zapišite offsetof, ne std::offsetof.

Za prenosno uporabo izberite tip s standardno postavitvijo. Podpora za druge razredne tipe je pogojna: implementacija je ni dolžna zagotoviti. Uporaba za statični podatkovni član ali člansko funkcijo povzroči nedefinirano vedenje. Ne uporabljajte ga za bitna polja. Veljaven klic ne sproži izjem.

Poravnava lahko med člane vstavi bajte za zapolnitev. Zato ne predpostavljajte, da je odmik enak vsoti velikosti predhodnih članov ali da ima enako vrednost na vseh platformah. Sam offsetof ne zagotavlja prenosnega formata serializacije.

Primer preveri std::is_standard_layout_v<Record> in izračuna offset med prevajanjem. Namesto izpisa števila, ki je odvisno od platforme, preveri zagotovljeno razmerje: value je za tag. Pričakovani izpis je true, ki mu sledi znak za novo vrstico.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri