CONTAINING_RECORD宏原理与使用详解

2024-06-18 05:32

本文主要是介绍CONTAINING_RECORD宏原理与使用详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

先不急着说CONTAINING_RECORD宏,我们从最浅显的代码开始讲解。

一、0指针的妙用

0指针,即nullptr、NULL,空指针,是不是很常见,一遇到它往往就是segment fault。代码,如下:

struct Test
{int a;float b;
};Test* pTest = nullptr;
int a_value = pTest->a; // segment fault
int b_value = pTest->b; // segment fault
pTest->a = 1;           // segment fault
pTest->b = 1.0;         // segment fault

上述想必没有疑问吧。空指针难道就没有用了?不,下面看一个巧妙的应用。

typedef unsigned long long quint64;
Test* pTest = nullptr;
quint64 offset_a = (quint64)(&(pTest->a));  // offset_a==0
quint64 offset_b = (quint64)(&(pTest->b));  // offset_b==4

offset_a为0,offset_b为4,如果你觉得很惊喜,请继续看。

之所以pTest->a,pTest->b没有报错,是因为前面添加了取地址符&,相当于我们告诉编译器,并不是真的要取a、b的值,我们只是取a、b的地址,然鹅Test对象的地址pTest为0,根据C++对象内存布局,如下图,可知当Test对象地址为0时,实际上取到的a、b地址,也就是a、b变量相对于整个对象首地址的偏移量。

在这里插入图片描述

小结:

利用某结构的空指针,对该结构成员取地址,可以得到该成员的偏移量。

换言之,我们很容易利用成员地址反推出整个对象的地址。

二、CONTAINING_RECORD宏

CONTAINING_RECORD宏定义位于winnt.h中,如下:

//
// Calculate the address of the base of the structure given its type, and an
// address of a field within the structure.
//#define CONTAINING_RECORD(address, type, field) ((type *)( \(PCHAR)(address) - \(ULONG_PTR)(&((type *)0)->field)))

该宏的功能,是根据某个结构体中成员变量的地址,计算出结构体地址。

  • address,成员变量地址
  • type,结构体类型
  • field,成员变量名

该宏定义的原理,就是上一章中介绍的使用0指针获取成员偏移,然后再使用成员变量地址-成员偏移,就得到了结构体地址。

该宏定义的使用,如下:

struct School
{int level;float cost;
};struct Student
{int age;School school;
};School sch;
sch.level = 1;
sch.cost = 5000;Student zhangsan;
zhangsan.age = 10;
zhangsan.school = sch;Student* pStu = CONTAINING_RECORD(&zhangsan.school, Student, school);
qDebug() << &zhangsan;
qDebug() << pStu;

运行结果:

在这里插入图片描述

pStu与&zhangsan值相等。

貌似看起来,好像这么操作一遍,没什么用处。但是实际上,在某些情况下,还是非常有用的一个宏。

三、使用C++封装使用CONTAINING_RECORD宏

代码如下:

#include <QCoreApplication>
#include <QDebug>//
// Calculate the address of the base of the structure given its type, and an
// address of a field within the structure.
//#define CONTAINING_RECORD(address, type, field) ((type *)( \(qint8*)(address) - \(quint64)(&((type *)0)->field)))
// 轮子
class Wheel
{
public:Wheel(int count, int color): count(count),color(color){}private:int count; // 数量int color; // 颜色
};// 汽车
class Car
{
public:Car(int seat, Wheel wheel): seat(seat),wheel(wheel){}Wheel* getWheel(){return &wheel;}// 将轮子转换为对应的汽车static Car *wheelToCar(Wheel *pWheel){return CONTAINING_RECORD(pWheel, Car, wheel);}private:int seat; // 座位数量Wheel wheel; // 轮子
};int main(int argc, char *argv[])
{QCoreApplication a(argc, argv);Wheel wheel(4, 1); // 4个轮子,1种颜色Car myCar(5, wheel); // 5个座位,1套轮子Car* pCar = Car::wheelToCar(myCar.getWheel());qDebug() << &myCar;qDebug() << pCar;return a.exec();
}

运行结果:

在这里插入图片描述

用途:

当我们需要将一个class中,某个成员对象(struct或class),取出来,传递给其他api,其他api将这个成员对象作为参数进行一些处理,处理完后,还会将该对象传递回给我们,这时候,我们希望能够通过此对象获取到所在的整个对象,那么我们使用这个C++封装的宏,实现起来会很方便。

例如:

win下的IOCP异步IO中,会把OVERLAPPED结构传给api,处理完,会传回OVERLAPPED结构体。

以及linux下libaio异步IO中,也会iocb结构传给api,处理完,会传回iocb结构体。



若对你有帮助,欢迎点赞、收藏、评论,你的支持就是我的最大动力!!!

同时,阿超为大家准备了丰富的学习资料,欢迎关注公众号“超哥学编程”,即可领取。

本文涉及工程代码,公众号回复:19ContainingRecord,即可下载。

在这里插入图片描述

这篇关于CONTAINING_RECORD宏原理与使用详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1071425

相关文章

C++ move 的作用详解及陷阱最佳实践

《C++move的作用详解及陷阱最佳实践》文章详细介绍了C++中的`std::move`函数的作用,包括为什么需要它、它的本质、典型使用场景、以及一些常见陷阱和最佳实践,感兴趣的朋友跟随小编一起看... 目录C++ move 的作用详解一、一句话总结二、为什么需要 move?C++98/03 的痛点⚡C++

MySQL中between and的基本用法、范围查询示例详解

《MySQL中betweenand的基本用法、范围查询示例详解》BETWEENAND操作符在MySQL中用于选择在两个值之间的数据,包括边界值,它支持数值和日期类型,示例展示了如何使用BETWEEN... 目录一、between and语法二、使用示例2.1、betwphpeen and数值查询2.2、be

python中的flask_sqlalchemy的使用及示例详解

《python中的flask_sqlalchemy的使用及示例详解》文章主要介绍了在使用SQLAlchemy创建模型实例时,通过元类动态创建实例的方式,并说明了如何在实例化时执行__init__方法,... 目录@orm.reconstructorSQLAlchemy的回滚关联其他模型数据库基本操作将数据添

Spring配置扩展之JavaConfig的使用小结

《Spring配置扩展之JavaConfig的使用小结》JavaConfig是Spring框架中基于纯Java代码的配置方式,用于替代传统的XML配置,通过注解(如@Bean)定义Spring容器的组... 目录JavaConfig 的概念什么是JavaConfig?为什么使用 JavaConfig?Jav

Java中ArrayList与顺序表示例详解

《Java中ArrayList与顺序表示例详解》顺序表是在计算机内存中以数组的形式保存的线性表,是指用一组地址连续的存储单元依次存储数据元素的线性结构,:本文主要介绍Java中ArrayList与... 目录前言一、Java集合框架核心接口与分类ArrayList二、顺序表数据结构中的顺序表三、常用代码手动

Spring Boot Interceptor的原理、配置、顺序控制及与Filter的关键区别对比分析

《SpringBootInterceptor的原理、配置、顺序控制及与Filter的关键区别对比分析》本文主要介绍了SpringBoot中的拦截器(Interceptor)及其与过滤器(Filt... 目录前言一、核心功能二、拦截器的实现2.1 定义自定义拦截器2.2 注册拦截器三、多拦截器的执行顺序四、过

JAVA线程的周期及调度机制详解

《JAVA线程的周期及调度机制详解》Java线程的生命周期包括NEW、RUNNABLE、BLOCKED、WAITING、TIMED_WAITING和TERMINATED,线程调度依赖操作系统,采用抢占... 目录Java线程的生命周期线程状态转换示例代码JAVA线程调度机制优先级设置示例注意事项JAVA线程

详解C++ 存储二进制数据容器的几种方法

《详解C++存储二进制数据容器的几种方法》本文主要介绍了详解C++存储二进制数据容器,包括std::vector、std::array、std::string、std::bitset和std::ve... 目录1.std::vector<uint8_t>(最常用)特点:适用场景:示例:2.std::arra

C++构造函数中explicit详解

《C++构造函数中explicit详解》explicit关键字用于修饰单参数构造函数或可以看作单参数的构造函数,阻止编译器进行隐式类型转换或拷贝初始化,本文就来介绍explicit的使用,感兴趣的可以... 目录1. 什么是explicit2. 隐式转换的问题3.explicit的使用示例基本用法多参数构造

Java使用Spire.Doc for Java实现Word自动化插入图片

《Java使用Spire.DocforJava实现Word自动化插入图片》在日常工作中,Word文档是不可或缺的工具,而图片作为信息传达的重要载体,其在文档中的插入与布局显得尤为关键,下面我们就来... 目录1. Spire.Doc for Java库介绍与安装2. 使用特定的环绕方式插入图片3. 在指定位