# offsetof

> C++ Atlas: `cppatlas.com/w/c/types/offsetof` | Source: https://en.cppreference.com/w/c/types/offsetof | Domain: Type support | Standards: C23

The macro offsetof expands to an integer constant expression of type size_t, the value of which is the offset, in bytes, from the beginning of an object of specified type to its specified subobject, including padding if any.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <stddef.h>
#define offsetof(type, member) /*implementation-defined*/
```

The macro `offsetof` expands to an integer constant expression of type `size_t`, the value of which is the offset, in bytes, from the beginning of an object of specified type to its specified subobject, including padding if any.

Given an object `o` of type `type` with static storage duration, `&(o.member)` shall be an address constant expression and point to a subobject of `o`. Otherwise, the behavior is undefined.

If the type name specified in `type` contains a comma not between matching parentheses, the behavior is undefined. (since C23)

### Notes

If `offsetof` is applied to a bit-field member, the behavior is undefined, because the address of a bit-field cannot be taken.

`member` is not restricted to a direct member. It can denote a subobject of a given member, such as an element of an array member.

Even though it is specified in C23 that specifying a new type containing an unparenthesized comma in `offsetof` is undefined behavior, such usage is generally not supported even in earlier modes: `offsetof(struct Foo { int a, b; }, a)` generally fails to compile.

`typeof` can be used to avoid the bad effect of commas in the definition of a new type, e.g. `offsetof(typeof(struct { int i, j; }), i)` is well-defined. (since C23)

### Example

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

struct S {
    char c;
    double d;
};

int main(void)
{
    printf("the first element is at offset %zu\n", offsetof(struct S, c));
    printf("the double is at offset %zu\n", offsetof(struct S, d));
}
```

Possible output:

```text
the first element is at offset 0
the double is at offset 8
```

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| DR 496 | C89 | only structs and struct members were mentioned | unions and other subobjects are also supported |

### See also

- [`size_t`](https://en.cppreference.com/w/c/types/size_t): unsigned integer type returned by the `sizeof` operator (typedef)
- [C++ documentation for `offsetof`](https://en.cppreference.com/w/cpp/types/offsetof)

---
Attribution: content from https://en.cppreference.com/w/c/types/offsetof (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.