详解Cocos2d-X中宏CC_DLL(转)

2023-11-03

在cocos2d-x的源码中,经常可以看到宏CC_DLL的使用,比如在类CCScene的定义中:

class CC_DLL CCScene : public CCNode
{
public:
        CCScene();
        virtual ~CCScene();
        bool init();
        static CCScene *create(void);
};



在cocos2d-x中,根据不同的平台,宏CC_DLL的定义是不同的,在iOS/Android/Blackberry/Mac平台上,CC_DLL代表“空”:

#define CC_DLL

在win32平台上,CC_DLL的定义为:


#if defined(_USRDLL)
    #define CC_DLL     __declspec(dllexport)
#else         /* use a DLL library */
    #define CC_DLL     __declspec(dllimport)
#endif

在linux平台上,CC_DLL的定义为:


#if defined(_USRDLL)
#define CC_DLL __attribute__ ((visibility ("default")))
#else         /* use a DLL library */
#define CC_DLL __attribute__ ((visibility ("default")))
#endif

对于win32,需要明白__declspec(dllexport)和__declspec(dllimport)的功能。

__declspec(dllexport)

声明一个导出函数,是说这个函数要从本DLL导出。我要给别人用。一般用于dll中省掉在DEF文件中手工定义导出哪些函数的一个方法。当然,如果你的DLL里全是C++的类的话,你无法在DEF里指定导出的函数,只能用__declspec(dllexport)导出类。

//SimpleDLLClass.h


#ifdef SIMPLEDLL_EXPORT
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT
#endif
class DLL_EXPORT SimpleDLLClass
{
public: 
    SimpleDLLClass(); 
    virtual ~SimpleDLLClass(); 
    virtual getValue() { return m_nValue;};
private: 
    int m_nValue;
};

 

//SimpleDLLClass.cpp


#include "SimpleDLLClass.h"
SimpleDLLClass::SimpleDLLClass()
{ 
    m_nValue=0;
}
SimpleDLLClass::~SimpleDLLClass()
{
}


对于上述代码,如果定义了SIMPLEDLL_EXPORT,那上述代码会被编译生成dll文件,此dll文件会向其他程序模块提供类SimpleDLLClass的函数和变量调用。

__declspec(dllimport)


声明一个导入函数,是说这个函数是从别的DLL导入。我要用。一般用于使用某个dll的exe中 。


不使用 __declspec(dllimport) 也能正确编译代码,但使用 __declspec(dllimport) 使编译器可以生成更好的代码。编译器之所以能够生成更好的代码,是因为它可以确定函数是否存在于 DLL 中,这使得编译器可以生成跳过间接寻址级别的代码,而这些代码通常会出现在跨 DLL 边界的函数调用中。但是,必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量。


在Windows DLL编程时,可使用__declspec(dllimport)关键字导入函数或者变量。


函数的导入

    当你需要使用DLL中的函数时,往往不需要显示地导入函数,编译器可自动完成。但如果你显示地导入函数,编译器会产生质量更好的代码。由于编译器确切地知道了一个函数是否在一个DLL中,它就可以产生更好的代码,不再需要间接的调用转接。

 

    Win32的PE格式(Portable Executable Format)把所有导入地址放在一个导入地址表中。下面用一个具体实例说明使用__declspec(dllimport)导入函数和不使用的区别:

 

    假设func是一个DLL中的函数,现在在要生成的.exe的main函数中调用func函数,并且不显示地导入func函数(即没有:__declspec(dllimport)),代码示例如下:

int main()

{

    func();

}

编译器将产生类似这样的调用代码:


call func

然后,链接器把该调用翻译为类似这样的代码:


call 0x40000001; //0x40000001是func的地址

并且,链接器将产生一个Thunk,形如:


0x40000001: jmp DWORD PTR __imp_func

这里的imp_func是func函数在.exe的导入地址表中的函数槽的地址。然后,加载器只需要在加载时更新.exe的导入地址表即可。

 

    而如果使用了__declspec(dllimport)显示地导入函数,那么链接器就不会产生Thunk(如果不被要求的话),而直接产生一个间接调用。因此,下面的代码:


__declspec(dllimport) void func1(void);
void main(void) 
{
    func1();
}



将调用如下调用指令:


call DWORD PTR __imp_func1

因此,显示地导入函数能有效减少目标代码(因为不产生Thunk)。另外,在DLL中使用DLL外的函数也可以这样做,从而提高空间和时间效率。


变量的导入

    与函数不同的是,在使用DLL中的变量时,需要显示地导入变量。使用__declspec(dllimport)关键字导入变量。若在DLL中使用.def导出变量,则应使用DATA修饰变量,而不是使用已经被遗弃的CONSTANT。因为CONSTANT可能需要使用指针间接访问变量,不确定什么时候会出问题。

 我相信写WIN32程序的人,做过DLL,都会很清楚__declspec(dllexport)的作用,它就是为了省掉在DEF文件中手工定义导出哪些 函数的一个方法。当然,如果你的DLL里全是C++的类的话,你无法在DEF里指定导出的函数,只能用__declspec(dllexport)导出 类。但是,MSDN文档里面,对于__declspec(dllimport)的说明让人感觉有点奇怪,先来看看MSDN里面是怎么说的: 


不使用 __declspec(dllimport) 也能正确编译代码,但使用 __declspec(dllimport) 使编译器可以生成更好的代码。编译器之所以能够生成更好的代码,是因为它可以确定函数是否存在于 DLL 中,这使得编译器可以生成跳过间接寻址级别的代码,而这些代码通常会出现在跨 DLL 边界的函数调用中。但是,必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量。


初看起来,这段话前面的意思是,不用它也可以正常使用DLL的导出库,但最后一句话又说,必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量这个是什么意思??


那我就来试验一下,假定,你在DLL里只导出一个简单的类,我们在下面的代码中导入使用这个DLL中的类,注意,我假定你已经在项目属性中定义了 SIMPLEDLL_EXPORT。

//SimpleDLLClass.h


#ifdef SIMPLEDLL_EXPORT
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT
#endif
class DLL_EXPORT SimpleDLLClass
{
public: 
    SimpleDLLClass(); 
    virtual ~SimpleDLLClass(); 
    virtual getValue() { return m_nValue;};
private: 
    int m_nValue;
};

 

//SimpleDLLClass.cpp


#include "SimpleDLLClass.h"
SimpleDLLClass::SimpleDLLClass()
{ 
    m_nValue=0;
}
SimpleDLLClass::~SimpleDLLClass()
{
}


然后你再使用这个DLL类,在你的APP中include SimpleDLLClass.h时,你的APP的项目不用定义 SIMPLEDLL_EXPORT 所以,DLL_EXPORT 就不会存在了,这个时候,你在APP中,不会遇到问题。这正好对应MSDN上说的__declspec(dllimport)定义与否都可以正常使用。但我们也没有遇到变量不能正常使用呀。 那好,我们改一下SimpleDLLClass,把它的m_nValue改成static,然后在cpp文件中加一行int SimpleDLLClass::m_nValue=0;如果你不知道为什么要加这一行,那就回去看看C++的基础。


改完之后,再去LINK一下,你的APP,看结果如何, 结果是LINK告诉你找不到这个m_nValue。明明已经定义了,为什么又没有了?? 肯定是因为我把m_nValue定义为static的原因。但如果我一定要使用Singleton的Design Pattern的话,那这个类肯定是要有一个静态成员,每次LINK都没有,那不是完了? 如果你有Platform SDK,用里面的Depend程序看一下,DLL中又的确是有这个m_nValue导出的呀。


再回去看看我引用MSDN的那段话的最后一句。 那我们再改一下SimpleDLLClass.h,把那段改成下面的样子:


#ifdef SIMPLEDLL_EXPORT
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT __declspec(dllimport)
#endif

再LINK,一切正常。原来dllimport是为了更好的处理类中的静态成员变量的,如果没有静态成员变量,那么这个__declspec(dllimport)无所谓。


FROM: http://www.ziliao1.com/Article/Show/716662CB4AD94EB2D020C3E74EA62A4C.html


本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

详解Cocos2d-X中宏CC_DLL(转) 的相关文章

  • VS在编译后.obj文件出现错误 error LNK2019: 无法解析的外部符号 的一种可能

    若有包含其他库 且规模较大 在写自己的代码时尽量避免把代码放在如小写 common 这种常见名字的文件夹内 否则容易出现编译成功 但 obj文件找不到某个函数导致错误LNK2019
  • GBase 8a视频配套联系

    1 以下关于粗粒度智能牵引描述正确的是 A 免维护 自动建立 B 每一列数据都会生成一个粗粒度智能牵引 C 牵引的建立和维护对资源的消耗可以忽略不计 D 记录DC内的最大值 最小值 空值 求和值等 答案ACD 2 GBase 8a集群数据库
  • UART和SPI简介

    UART 即通用异步收发器 是一种通用的串行 异步通信总线 该总线有两种数据线 可以实现数据的发送和接收 在嵌入式系统中常用于主机与辅助设备之间的通信 通信基础 并行和串行 并行通信 串行通信 单工通信 双工通信 半双工 发送和接收不可以同
  • c++观察者模式

    观察者模式 1 观察者模式简介 观察者模式也叫发布 订阅模式 模型 视图模式 源 监听器模式以及从属者模式 观察者模式定义了对象之间的一对多依赖关系 使得每当一个对象状态发生改变时 其相关依赖对象皆得到通知并被自动更新 2 实例讲解 假如张

随机推荐

  • wsl linux 安装

    1 首先确保windwos的操作系统 win 10 我的系统版本Microsoft Windows 版本 10 0 17134 285 2 开启 适用于linux的windows子系统 在 控制面板 程序 程序和功能 中 3 下载linux
  • 刚刚微软的3月安全更新中,这几个安全漏洞值得注意

    近日 安全专家建议IT团队应优先修补两个零日漏洞 一个是微软Outlook的认证机制 另一个是web标记的绕过 这两个漏洞是微软在其3月补丁星期二安全更新中披露的74个安全漏洞的一部分 在一篇博文中 Automox的研究人员建议企业在24小
  • 获取map的长度、map与list的区别

    获取map的长度 map与list的区别 1 首先看一下map和list有何区别 List 是存储单列数据的集合 存储的数据是有序并且是可以重复的 Map 存储双列数据的集合 通过键值对存储数据 存储 的数据是无序的 Key值不能重复 va
  • TCP协议三次握手,四次挥手

    TCP建立连接的过程叫做握手 握手需要在客户端和服务器端之间交换三个TCP报文段 称之为三次握手 TCP断开连接的过程叫做挥手 即在客户端和服务器端之间交换四个TCP报文段 称之为四次挥手 下面是一次完整的TCP连接过程 上图中对于发送SY
  • echart 点击事件

    以柱状图为例 点击单个柱形上 myChart off click 在渲染点击事件之前先清除点击事件 一定要加上否则会重复加载先前的点击事件 myChart on click function params console log 获取点击的
  • 内核dma_cache_maint介绍

    搞idm internal DMA 模块时 看到数据从主芯片传输到WiFi芯片之前 会有一个idm invalid cache的动作 该函数里封装着dma cache maint 这也就是我们平时经常说的刷cache 那这个内核函数作用是怎
  • Python随机生成企业及统一社会信用代码

    import random import string 随机生成企业名称 def generate company name prefix ABC XYZ ACME BEST TOP suffix Corp Inc Ltd LLC retu
  • 免费AI视频换脸工具-roop安装教程

    工具介绍 roop是一款使用python开发的深度AI视频换脸工具 不过目前工具没有开箱即用 需要一点点的python开发命令知识 不过官方也提供文档步骤 建议使用python 3 10 安装完必须的包即可 安装步骤 1 必备的工具环境 自
  • 【深度学习】手写数字识别及神经网络基本模型

    2021 10 7 学习日记 手写数字识别及神经网络基本模型 1 概述 张量 tensor 是数字的容器 是矩阵向任意维度的推广 其维度称为轴 axis 深度学习的本质是对张量做各种运算处理 其分层几乎总是通过神经网络 neural net
  • 【k8s】Kubernetes存储之 StatefulSet 控制器通过 Headless Service 管理Pod

    一 StatefulSet 控制器简介 官方网址 StatefulSet 是用来管理有状态应用的工作负载 API 对象 StatefulSet 用来管理 Deployment 和扩展一组 Pod 并且能为这些 Pod 提供序号和唯一性保证
  • uni-app自定义底部tabbar

    1 新建custom tab bar目录 并分别创建 js json wxml wxss index json component true index wxml
  • 一阶同余算法,模拟随机变量,筛选法,合成法,方差减少技术,蒙特卡洛积分,控制变量法,统计实验

    第一章 0 1 上均匀随机数的产生 一阶线性同余算法 思想 Wn a W0 c m 其中a称为乘数 W0为初始值 c为增量 m称为模数 当a 0时为和同余法 当c 0时为乘同余法 c 0时为混合同余法 乘数 增量和模数的选取可以多种多样 只
  • PCI配置空间简介

    转自 作为自己学习笔记PCI配置空间简介 腾讯云开发者社区 腾讯云 tencent com https cloud tencent com developer article 1199972 from 15425 一 PCI配置空间简介 P
  • Android : 读取assets目录下的json文件

    public class AssetsFileUtil 读取assets目录下的json文件 param context 上下文 param fileName 文件名称 return public static String getJson
  • 公司挖来一个阿里Java大神,生产环境故障调优很溜

    目录 线上系统是如何运行的 CPU 是如何并发运行多个线程的 线程太多会导致什么样的后果 经常听说的 CPU 使用率和负载到底是什么 如何通过 top 命令来查看 CPU 使用率和负载 今天给大家分享一个知识点 就是平时我们线上服务器部署的
  • HTTP请求中的传参方式form data、 request payload、query string parameters三者对比

    目录 一 GET请求 Query String Parameters 二 POST请求 2 1 FormData 2 2 Request Payload 补充 Post请求总结 HTTP请求中不同的请求方式和设置不同的Content Typ
  • Qt for Android:自定义安卓Application和Activity

    Demo 链接 https github com gongjianbo HelloQtAndroid git 1 前言 安卓的 Application 类相当于 Qt QApplication 维护应用程序全局状态 Application文
  • 马原刷题工具

    选择题库文件word后 就能开始刷题了 导入题库时会自动生成一个docx文件和json文件 想要重新导入就删除json文件 题库下载 点我下载 要安装的库 pywin32 python docx author Bre Athy contac
  • 代码随想录算法训练营第四十一天| 343. 整数拆分 96.不同的二叉搜索树

    今天两题都挺有难度 建议大家思考一下没思路 直接看题解 第一次做 硬想很难想出来 343 整数拆分 代码随想录 视频讲解 动态规划 本题关键在于理解递推公式 LeetCode 343 整数拆分 哔哩哔哩 bilibili public in
  • 详解Cocos2d-X中宏CC_DLL(转)

    在cocos2d x的源码中 经常可以看到宏CC DLL的使用 比如在类CCScene的定义中 class CC DLL CCScene public CCNode public CCScene virtual CCScene bool i