Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes