5分钟上手C反射meta库header-only快速开始完整指南无需一个宏【免费下载链接】metaHeader-only, non-intrusive and macro-free runtime reflection system in C项目地址: https://gitcode.com/gh_mirrors/meta/metameta 是一个 C 反射库采用 header-only 设计、无侵入、全程零宏定义让 C 运行时反射在几分钟内即可跑起来。本文带你从安装配置到第一行 reflect 代码完整走通 C 反射的快速开始流程。为什么需要 C 运行时反射传统 C 反射方案大多靠宏魔法扫描类型带来编译缓慢、侵入性强、类型定义被绑架等问题。而 meta 库的卖点是header-only只包含两个头文件即可使用无需编译任何源码零宏类型定义完全干净反射注册与业务代码解耦运行时反射支持按名称在运行时查找类型、读取成员、调用函数⚡高性能内置 SBO小对象优化的meta::any常规场景零内存分配获取与配置header-only 库的零负担安装meta 对编译器的唯一要求是支持 C17 标准。获取源码只需一条命令git clone https://gitcode.com/gh_mirrors/meta/meta使用时只需把src目录加入编译器头文件搜索路径-I参数然后包含两个核心头文件#include meta/factory.hpp #include meta/meta.hpp就这两行整个库已经引入完毕。库的三大核心文件一目了然文件作用src/meta/factory.hpp反射注册工厂定义类型的入口src/meta/meta.hpp反射系统主体提供resolve、any等运行时 APIsrc/meta/policy.hpp编译期策略标记as-is / as-void / as-alias若要在 CMake 工程中编译测试根目录的CMakeLists.txt已配置好一切cmake .. make make test即可。快速开始reflect 函数一行上手C 反射总是从真实类型出发。meta 提供reflect函数完成类型注册它接收一个模板参数要反射的类型和一个可选标识符通常用std::hashstd::string_view生成返回一个工厂对象std::hashstd::string_view hash{}; auto factory meta::reflectmy_type(hash(reflected_type));返回的工厂对象所有成员函数都返回自身支持链式调用可继续为类型装修ctorint, char()—— 注册构造函数也可用自由工厂函数dtordestroy()—— 注册析构函数datamy_type::member(hash(member))—— 注册数据成员funcmy_type::func(hash(func))—— 注册成员/静态/自由函数basebase_type()—— 声明基类支持运行时隐式转换convint()—— 声明类型转换函数一条完整的注册链长这样meta::reflectderived_type(hash(derived)) .ctorint, char() .dataderived_type::i(hash(i)) .funcderived_type::f(hash(f)) .basebase_type();注意标识符本质上是任意数字字符串哈希只是惯例写法。也可以直接传42这样的数字只是可读性差一些。运行时按名查找resolve 函数注册完成后反射网络就建好了。运行时通过resolve函数按类型或按名称查找// 按类型查找 meta::type by_type meta::resolvemy_type(); // 按名称查找字符串哈希作为标识符 meta::type by_name meta::resolve(hash(reflected_type));拿到meta::type后就能继续挖掘// 按参数类型找构造函数 meta::ctor ctor meta::resolvemy_type().ctorint, char(); // 按名称找数据成员 / 成员函数 meta::data data meta::resolvemy_type().data(hash(i)); meta::func func meta::resolvemy_type().func(hash(f));所有返回对象ctor、dtor、data、func、base、conv都支持直接转 bool 判断有效性找错了不会崩溃if(func) { /* 存在则调用 */ }meta::type本身还能直接construct/destroy真实实例并可用回调遍历类型下的所有成员——这正是编辑器、序列化器、序列化框架最爱的能力。常用进阶any 类型、策略与枚举meta::any自带零分配的任意类型容器meta 提供了自己的any类型区别于std::anyAPI 类似但类型信息直接链接到反射系统meta::any any{0}; // 装着 int 的 any meta::any empty{}; // 空容器稍后填充得益于 SBO 技术装小对象时分配次数为零它还提供try_cast、cast、convert等成员函数处理类型转换能像引用一样包装已有对象std::ref而不复制。策略微调默认行为的编译期开关默认情况下读取数据成员会返回拷贝src/meta/policy.hpp里只有三个轻量的策略标记类可解决大部分特殊场景meta::as_is_t—— 默认策略按值拷贝meta::as_void_t—— 丢弃返回值例如只调用不关心的函数meta::as_alias_t—— 让包装对象成为原对象的别名修改直接生效用法就是在注册时多传一个模板参数.datamy_type::data_member, meta::as_alias_t(hash(member));枚举和命名常量枚举可以直接当类型反射把每个枚举值挂上去即可访问方式与其他数据成员完全一致甚至能给int这类算术类型附加具名常量。序列化场景下特别好用。项目结构与学习路线整个仓库非常小巧值得逐层阅读核心实现src/meta/meta.hpp2000 余行含详尽的 Doxygen 注释注册工厂src/meta/factory.hpp策略定义src/meta/policy.hpp完整用法示例test/meta.cpp2000 余行测试相当于最好的实战教材贡献指南docs/CONTRIBUTING.md构建配置CMakeLists.txt及cmake/in/下的 CMake 模板想深入 API 细节官方文档基于 Doxygen运行cmake .. -DBUILD_DOCSON make即可在本地生成 HTML 版 API 参考。常见问题 FAQQmeta 支持 C14 吗当前版本要求 C17C14 需求可联系项目作者。Q不传标识符可以注册吗可以。不传标识符时类型只在反射系统内部存在不允许按名称查找——适合只需反射功能、不想暴露类型名的场景。Q如何注销一个类型调用meta::unregistermy_type()会连带清理它的数据成员、函数等基类不受影响之后还能用完全不同的名称重新注册。Q反射注册放在哪里推荐集中放在一个独立的注册文件中启动时调用一次即可业务代码保持零侵入。总结meta 库用不到 5 分钟的学习成本换来了 C 世界少见的干净运行时反射header-only 引入、零宏污染、按名查找类型、链式注册成员、自带零分配 any。它的 API 表面克制reflect、resolve两大入口底层能力却覆盖构造、析构、继承、转换、属性注解等完整场景。如果你正在做序列化、脚本绑定或可视化编辑器meta 值得放进你的工具箱。项目采用 MIT 协议代码发布源码见LICENSE文件放心商用。【免费下载链接】metaHeader-only, non-intrusive and macro-free runtime reflection system in C项目地址: https://gitcode.com/gh_mirrors/meta/meta创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
