CKTIS / C++
offsetof — przesunięcie pola w obiekcie
Makro offsetof z <cstddef> wyznacza przesunięcie pola względem początku obiektu, w bajtach. Umożliwia kontrolę układu pamięci, ale przenośne użycie wymaga typu standard-layout.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cstddef>
offsetof(type, member-designator)offsetof(type, member-designator) z <cstddef> daje stałą całkowitą typu std::size_t: przesunięcie wskazanego pola od początku obiektu, w bajtach. Argumentami są typ i oznaczenie pola, nie instancja obiektu. Jest to makro; zapisuj offsetof, nie std::offsetof.
Do przenośnego użycia wybieraj typ standard-layout. Dla innych typów klas obsługa jest warunkowa: implementacja nie musi jej zapewniać. Użycie dla statycznej składowej danych lub funkcji składowej ma niezdefiniowane zachowanie. Nie stosuj go do pól bitowych. Poprawne wywołanie nie zgłasza wyjątków.
Wyrównanie może powodować dodanie bajtów dopełnienia między polami. Nie zakładaj więc, że przesunięcie jest sumą rozmiarów wcześniejszych pól ani że ma tę samą wartość na różnych platformach. Samo offsetof nie zapewnia przenośnego formatu serializacji.
Przykład sprawdza std::is_standard_layout_v<Record> i oblicza offset podczas kompilacji. Zamiast wypisywać zależną od platformy liczbę, sprawdza gwarantowaną relację: pole value znajduje się za tag. Oczekiwany wynik to true i znak nowego wiersza.
Przykłady
#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';
}
Wynik
true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.