Scroll to navigation

OFFSETOF(3) Руководство программиста Linux OFFSETOF(3)

ИМЯ

offsetof - смещение элемента структуры

ОБЗОР

#include <stddef.h>

size_t offsetof(type, member);

ОПИСАНИЕ

Макрокоманда offsetof() возвращает смещение поля member от начала структуры type.

Эта макрокоманда удобна, так как размеры полей, составляющих структуру, могут значительно изменяться в зависимости от реализаций, а компиляторы могут добавлять различное количество дополнительных байт между полями. Следовательно, смещение элемента не всегда является суммой размеров предыдущих элементов.

Если member не выровнен по границе байта (т.е., если это битовое поле), то компилятор вернёт ошибку.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

Функция offsetof() возвращает смещение в байтах указанного поля member внутри указанного type.

СООТВЕТСТВИЕ СТАНДАРТАМ

C89, C99, POSIX.1-2001.

ПРИМЕР

В системах Linux/i386 при использовании компилятора gcc(1) с параметрами по умолчанию нижеследующая программа дает следующий результат:

$ ./a.out
offsets: i=0; c=4; d=8 a=16
sizeof(struct s)=16

Исходный код программы

#include <stddef.h>
#include <stdio.h>
#include <stdlib.h>
int
main(void)
{

struct s {
int i;
char c;
double d;
char a[];
};
/* Вывод зависит от компилятора */
printf("offsets: i=%ld; c=%ld; d=%ld a=%ld\n",
(long) offsetof(struct s, i),
(long) offsetof(struct s, c),
(long) offsetof(struct s, d),
(long) offsetof(struct s, a));
printf("sizeof(struct s)=%ld\n", (long) sizeof(struct s));
exit(EXIT_SUCCESS); }
2008-07-12 GNU