CKTIS / C++
offsetof — deslocamento de um membro num objeto
A macro offsetof de <cstddef> determina o deslocamento em bytes de um membro a partir do início de um objeto. Permite verificar a disposição da memória, mas a utilização portável requer um tipo de disposição standard.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <cstddef>
offsetof(type, member-designator)offsetof(type, member-designator) de <cstddef> produz uma expressão constante inteira do tipo std::size_t: o deslocamento em bytes do membro indicado a partir do início de um objeto. Os argumentos são um tipo e um designador de membro, não uma instância de objeto. É uma macro; escreve offsetof, não std::offsetof.
Para uma utilização portável, escolhe um tipo de disposição standard. O suporte para outros tipos de classe é condicional: uma implementação não é obrigada a disponibilizá-lo. Aplicá-la a um membro de dados estático ou a uma função membro resulta em comportamento indefinido. Não a apliques a campos de bits. Uma invocação válida não lança exceções.
O alinhamento pode introduzir bytes de preenchimento entre os membros. Por isso, não assumas que um deslocamento é igual à soma dos tamanhos dos membros anteriores, nem que tem o mesmo valor em todas as plataformas. offsetof, por si só, não fornece um formato de serialização portável.
O exemplo verifica std::is_standard_layout_v<Record> e calcula offset em tempo de compilação. Em vez de imprimir um número dependente da plataforma, testa uma relação garantida: value está depois de tag. O resultado esperado é true seguido de uma mudança de linha.
Exemplos
#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';
}
Resultado
true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.