Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

offsetof — offset di un membro all’interno di un oggetto

La macro offsetof di <cstddef> determina l’offset in byte di un membro dall’inizio di un oggetto. Consente di verificare il layout della memoria, ma per un uso portabile è necessario un tipo standard-layout.

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

Sintassi

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

offsetof(type, member-designator) di <cstddef> produce un’espressione costante intera di tipo std::size_t: l’offset in byte del membro indicato dall’inizio di un oggetto. Gli argomenti sono un tipo e un designatore di membro, non un’istanza di oggetto. È una macro: scrivi offsetof, non std::offsetof.

Per un uso portabile, scegli un tipo standard-layout. Il supporto per altri tipi di classe è condizionale: un’implementazione non è tenuta a fornirlo. Applicarla a un membro dati statico o a una funzione membro comporta un comportamento indefinito. Non applicarla ai campi di bit. Un’invocazione valida non genera eccezioni.

L’allineamento può introdurre byte di padding tra i membri. Non presumere quindi che un offset sia uguale alla somma delle dimensioni dei membri precedenti, né che abbia lo stesso valore su tutte le piattaforme. offsetof da sola non fornisce un formato di serializzazione portabile.

L’esempio verifica std::is_standard_layout_v<Record> e calcola offset in fase di compilazione. Invece di stampare un numero dipendente dalla piattaforma, verifica una relazione garantita: value si trova dopo tag. L’output atteso è true seguito da un a capo.

Esempi

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

Risultato

true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti