CKTIS / C++
offsetof — отместване на член в обект
Макросът offsetof от <cstddef> определя отместването на член в байтове спрямо началото на обект. Позволява проверки на разположението в паметта, но преносимата употреба изисква тип със стандартно разположение.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <cstddef>
offsetof(type, member-designator)offsetof(type, member-designator) от <cstddef> дава целочислен константен израз от тип std::size_t: отместването в байтове на посочения член спрямо началото на обект. Аргументите са тип и обозначение на член, а не екземпляр на обект. Това е макрос; пишете offsetof, а не std::offsetof.
За преносима употреба изберете тип със стандартно разположение. Поддръжката за други типове класове е условна: дадена реализация не е длъжна да я осигурява. Прилагането към статичен член на данните или член-функция води до неопределено поведение. Не го прилагайте към битови полета. Валидното извикване не хвърля изключения.
Подравняването може да добави байтове за запълване между членовете. Затова не приемайте, че отместването е равно на сумата от размерите на предходните членове или че има една и съща стойност на всички платформи. Сам по себе си offsetof не осигурява преносим формат за сериализация.
Примерът проверява std::is_standard_layout_v<Record> и изчислява offset по време на компилация. Вместо да отпечатва зависимо от платформата число, той проверява гарантирано отношение: value се намира след tag. Очакваният изход е true, последвано от нов ред.
Примери
#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';
}
Резултат
true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.