Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

offsetof — przesunięcie podobiektu w bajtach

Makro offsetof z <stddef.h> wyznacza przesunięcie podobiektu względem początku obiektu jako stałe wyrażenie typu size_t.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

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

offsetof(type, member-designator) z <stddef.h> jest makrem, nie funkcją. Zwraca całkowite wyrażenie stałe typu size_t: przesunięcie wskazanego podobiektu w bajtach od początku obiektu typu type.

Układ struktury może zawierać bajty dopełnienia, więc nie sumuj rozmiarów poprzednich pól. Przesunięcie pierwszego pola struktury wynosi zero; pozostałe mogą zależeć od implementacji. Do wypisywania wyniku używaj %zu.

Dla hipotetycznego static type t; wyrażenie &(t.member-designator) musi być stałą adresową. Pole bitowe lub zdefiniowanie nowego typu wewnątrz argumentu type powoduje niezdefiniowane zachowanie. Zadeklaruj typ wcześniej.

Przykłady

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

Wynik

tag offset: 0
value follows tag: 1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła