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.