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

CKTIS / C

offsetof — deslocamento em bytes de um subobjeto

A macro offsetof de <stddef.h> fornece o deslocamento de um subobjeto desde o início de um objeto como uma expressão constante do tipo size_t.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stddef.h>
offsetof(type, member-designator)

offsetof(type, member-designator) de <stddef.h> é uma macro, não uma função. Produz uma expressão constante inteira do tipo size_t: o deslocamento em bytes do subobjeto designado desde o início de um objeto do tipo type.

A disposição de uma estrutura pode incluir bytes de preenchimento, por isso não some os tamanhos dos membros anteriores. O primeiro membro de uma estrutura tem deslocamento zero; os outros deslocamentos podem depender da implementação. Imprima o resultado com %zu.

Para um hipotético static type t;, &(t.member-designator) tem de ser uma constante de endereço. Um campo de bits ou a definição de um novo tipo dentro do argumento type causa comportamento indefinido. Declare o tipo antecipadamente.

Exemplos

#include <stddef.h>
#include <stdio.h>

struct Record {
    char tag;
    int value;
};

static_assert(offsetof(struct Record, tag) == 0);

int main(void)
{
    printf("tag offset: %zu\n", offsetof(struct Record, tag));
    printf("value follows tag: %d\n",
           offsetof(struct Record, value) >= sizeof(char));
    return 0;
}

Resultado

tag offset: 0
value follows tag: 1

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