RTTR是一个C++库,使程序员能够在其应用程序中使用反射。RTTR是根据MIT许可证发布的。本文介绍如何集成rttr库到工程中,并演示一个基本示例。
系统环境:windows
下载RTTR源码后,首先需要使用CMake进行构建,如果没有安装CMake,可以先下载并安装。官方下载地址:https://cmake.org/download/,以windows64位msi安装包为例:
rttr还依赖Boost库和Doxygen,如果没有这两个可以先下载:
boost以windows平台为例,选一种压缩包下载:
https://www.boost.org/users/download/
下载好Boost以后解压并配置环境变量BOOST_ROOT,值为解压目录。
Doxygen以windows平台为例,这里我选择了64位zip包:
https://www.doxygen.nl/download.html
下载好Doxygen以后解压并在环境变量PATH中加入Doxygen的解压目录。
接下来下载rttr源码,官方下载地址:https://www.rttr.org/download,选择windows版,以rttr目前最新版0.9.6为例:
解压rttr源码压缩包,并在根目录中新建目录build(名称随意,cmake将目标平台的源码编译到此目录下):
打开cmake-gui,Browse Source选择rttr源码根目录,Browse Build选择刚才新建出来的构建目录,选择好以后点击Configure:
选择项目的编译器平台,以Visual Studio 2019为例,选好以后点击Finish:
等待CMake配置完成以后,再点击Generate:
进入构建目录下查看生成结果(本例中构建目录为 rttr-0.9.6-src\build),用vs打开rttr.sln:
编译rttr_core即可,本文以Release 64位为例进行编译,注意字符集和平台工具集等要和将来所集成的项目一致:
编译好以后,库文件分别位于构建目录下的:
lib/Release/rttr_core.lib
bin/Release/rttr_core.dll
接下来在命令行进入到构建目录下,执行cpack命令,将在同目录下生成最终的安装包:
安装包目录结构及内容如下:
在vs2019中新建测试项目,为了方便管理,我将刚才生成的安装包目录整体拷贝到测试项目中(doc目录不是必须)。
配置测试工程,以Release 64位为例,配置好附加包含目录、附加库目录、附加依赖项、字符集(之前编译rttr时使用的默认多字节,如使用Unicode则编译rttr时也改为Unicode):
运行需要动态链接库rttr_core.dll,在生成后事件中加入
xcopy .\rttr-0.9.6-win64-\bin*.dll $(OutDir) /Y /E /F
将dll拷贝到exe目录(也可以手动或者其他方式进行拷贝):
添加测试代码main.cpp,本示例中主要代码取自RTTR官方首页https://www.rttr.org/的入门示例:
#include <iostream>
#include <rttr/registration>
using namespace rttr;
struct MyStruct { MyStruct() { }; void func(double) { }; int data; };
//手动注册属性方法和构造函数
RTTR_REGISTRATION
{
registration::class_<MyStruct>("MyStruct")
.constructor<>()
.property("data", &MyStruct::data)
.method("func", &MyStruct::func);
}
int main() {
//遍历类的成员
type t = type::get<MyStruct>();
for (auto& prop : t.get_properties())
std::cout << "name: " << prop.get_name() << std::endl;
for (auto& meth : t.get_methods())
std::cout << "name: " << meth.get_name() << std::endl;
//创建类型的实例
type t2 = type::get_by_name("MyStruct");
variant var = t2.create(); // 方式1
constructor ctor = t2.get_constructor(); // 方式2
var = ctor.invoke();
std::cout << var.get_type().get_name() << std::endl; // 打印类型名称
//设置/获取属性
MyStruct obj;
property prop = type::get(obj).get_property("data");
prop.set_value(obj, 23);
variant var_prop = prop.get_value(obj);
std::cout << var_prop.to_int() << std::endl; // prints '23'
//调用方法
MyStruct obj2;
method meth = type::get(obj2).get_method("func");
meth.invoke(obj2, 42.0);
variant var2 = type::get(obj2).create();
meth.invoke(var2, 42.0);
return 0;
}
编译,运行结果: