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

相关文章

一文详解SpringBoot中控制器的动态注册与卸载

《一文详解SpringBoot中控制器的动态注册与卸载》在项目开发中,通过动态注册和卸载控制器功能,可以根据业务场景和项目需要实现功能的动态增加、删除,提高系统的灵活性和可扩展性,下面我们就来看看Sp... 目录项目结构1. 创建 Spring Boot 启动类2. 创建一个测试控制器3. 创建动态控制器注

使用Docker构建Python Flask程序的详细教程

《使用Docker构建PythonFlask程序的详细教程》在当今的软件开发领域,容器化技术正变得越来越流行,而Docker无疑是其中的佼佼者,本文我们就来聊聊如何使用Docker构建一个简单的Py... 目录引言一、准备工作二、创建 Flask 应用程序三、创建 dockerfile四、构建 Docker

Python使用vllm处理多模态数据的预处理技巧

《Python使用vllm处理多模态数据的预处理技巧》本文深入探讨了在Python环境下使用vLLM处理多模态数据的预处理技巧,我们将从基础概念出发,详细讲解文本、图像、音频等多模态数据的预处理方法,... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

C#读写文本文件的多种方式详解

《C#读写文本文件的多种方式详解》这篇文章主要为大家详细介绍了C#中各种常用的文件读写方式,包括文本文件,二进制文件、CSV文件、JSON文件等,有需要的小伙伴可以参考一下... 目录一、文本文件读写1. 使用 File 类的静态方法2. 使用 StreamReader 和 StreamWriter二、二进

Python使用pip工具实现包自动更新的多种方法

《Python使用pip工具实现包自动更新的多种方法》本文深入探讨了使用Python的pip工具实现包自动更新的各种方法和技术,我们将从基础概念开始,逐步介绍手动更新方法、自动化脚本编写、结合CI/C... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Conda与Python venv虚拟环境的区别与使用方法详解

《Conda与Pythonvenv虚拟环境的区别与使用方法详解》随着Python社区的成长,虚拟环境的概念和技术也在不断发展,:本文主要介绍Conda与Pythonvenv虚拟环境的区别与使用... 目录前言一、Conda 与 python venv 的核心区别1. Conda 的特点2. Python v

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP

C#中Guid类使用小结

《C#中Guid类使用小结》本文主要介绍了C#中Guid类用于生成和操作128位的唯一标识符,用于数据库主键及分布式系统,支持通过NewGuid、Parse等方法生成,感兴趣的可以了解一下... 目录前言一、什么是 Guid二、生成 Guid1. 使用 Guid.NewGuid() 方法2. 从字符串创建

Python使用python-can实现合并BLF文件

《Python使用python-can实现合并BLF文件》python-can库是Python生态中专注于CAN总线通信与数据处理的强大工具,本文将使用python-can为BLF文件合并提供高效灵活... 目录一、python-can 库:CAN 数据处理的利器二、BLF 文件合并核心代码解析1. 基础合

java中反射Reflection的4个作用详解

《java中反射Reflection的4个作用详解》反射Reflection是Java等编程语言中的一个重要特性,它允许程序在运行时进行自我检查和对内部成员(如字段、方法、类等)的操作,本文将详细介绍... 目录作用1、在运行时判断任意一个对象所属的类作用2、在运行时构造任意一个类的对象作用3、在运行时判断