offsetof

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

类型支持

size_t

ptrdiff_t

nullptr_t (C23)

NULL

max_align_t (C11)

offsetof

数值极限

定宽整型 (C99 起)

 

定义于头文件 <stddef.h>
#define offsetof(type, member) /*实现定义*/

宏 offsetof 扩展为一个 整数常量表达式，类型为 size_t，其值为指定类型对象到其指定子对象的字节偏移量，包括任何填充。

给定一个具有静态存储期、类型为 type 的对象 o，&(o.member) 应当是一个地址常量表达式并指向 o 的一个子对象。否则，行为是未定义的。

如果 type 中指定的类型名包含逗号，且该逗号不在匹配的括号之间，则行为是未定义的。

(自 C23 起)

注意

如果 offsetof 应用于位域成员，则行为是未定义的，因为不能获取位域的地址。

member 不限于直接成员。它可以表示给定成员的子对象，例如数组成员的元素。

尽管 C23 规定在 offsetof 中指定包含未加括号的逗号的新类型是未定义行为，但即使在早期模式下，这种用法通常也不受支持：offsetof(struct Foo { int a, b; }, a) 通常编译失败。

typeof 可用于避免新类型定义中逗号的不良影响，例如 offsetof(typeof(struct { int i, j; }), i) 是定义良好的。

(自 C23 起)

示例

运行此代码

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

可能的输出

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

缺陷报告

以下行为改变的缺陷报告被追溯地应用于以前发布的 C 标准。

缺陷报告	应用于	发布时的行为	正确的行为
DR 496	C89	只提及了结构和结构成员	联合体及其他子对象也受支持

另请参阅

size_t	由 sizeof 运算符返回的无符号整型 (typedef)
C++ 文档，关于 offsetof