Question

在我的一个项目中，我正在尝试实现一种更通用的方法来编写我们内部简化的XML文件。为此，我成功使用了boost-fusion。

对于每种新的XML文件格式，客户端必须编写以下内容。假设XML文件包含标记Person和标记Company。

#include <boost/fusion/include/define_struct.hpp>
#include <boost/variant.hpp>
#include <map>
#include <vector>

BOOST_FUSION_DEFINE_STRUCT(
(),
Person,
(std::string, name) // name is mandatory for all tags
(int, age))

BOOST_FUSION_DEFINE_STRUCT(
(),
Company,
(std::string, name) // name is mandatory for all tags
(int, noEmployees)
(std::string, location)
)

typedef boost::variant<Person, Company> Types;

std::vector<std::pair<Types, std::vector<std::string>>> xmlTags =
{
    {Person(), {"name", "age"}},
    {Company(), {"name", "noEmployees", "location"}},
};

int main(int argc, char**args) {
}

我仍然对上述解决方案不太满意，因为用户仍然需要定义xmlTags，这应该自动生成。此外，还应生成Types。客户端可能忘记调整映射，导致错误的XML文件或崩溃XML Reader / Writer。

一个好的解决方案可能如下：

DEFINE_XML_TAGS(
    XML_TAG(
        Person,
        (int, age)
    )
    XML_TAG(
        Company,
        (int, noEmployees)
        (std::string, location)
    )
)

为我生成所有这些样板代码。我认为Boost-Preprocessor将成为这个好解决方案的一部分。

但是，我不知道如何达到预期的效果。有没有使用过这个图书馆。幸运的是，我们的编译器支持可变参数模板参数。

有谁知道如何达到预期效果？

Answer 1

如果您对使用Boost.Preprocessor库感兴趣，则需要熟悉两种基本的“数据类型”：sequence和tuple。您可以在the documentation的参考部分中找到库使用的宏的完整列表。我将解释我在下面使用的那些。

界面中有两个宏：XML_TAG和DEFINE_XML_TAGS XML_TAG非常简单，只是将其参数放在两组括号中。这会导致您使用的许多XML_TAG转换为元素为元组(struct_name,sequence_of_type_and_name_pairs)的序列。
DEFINE_XML_TAGS是完成所有工作的宏。它使用三个辅助宏GENERATE_STRUCT_DEFS，GENERATE_VARIANT_OF_TYPES和GENERATE_XMLTAGS。

GENERATE_VARIANT_OF_TYPES
调用ENUMERATE_TYPES(TAG_SEQ)以获取逗号分隔的类型列表。现在TAG_SEQ是((Person,(int,age)))((Company,(int,noEmployees)(std::string,location)))，我们想拥有Person,Company。 BOOST_PP_ENUM(SEQ)接受一个序列并返回以逗号分隔的元素。所以我们需要BOOST_PP_ENUM((Person)(Company))。 BOOST_PP_SEQ_FOR_EACH(MACRO,DATA,SEQ)调用MACRO与SEQ中的每个元素以及您传递的任何数据。因此BOOST_PP_SEQ_FOR_EACH(GET_TYPE_SEQUENCE,_,TAG_SEQ)使用GET_TYPE_SEQUENCE和(Person,(int,age))调用(Company,(int,noEmployees)(sd:string,location))。 GET_TYPE_SEQUENCE然后简单地获取每个元组的第一个元素，并使用BOOST_PP_TUPLE_ELEM将其放在一组括号中。

GENERATE_XML_TAGS
它调用GENERATE_PAIRS，后者又使用GENERATE_ONE_PAIR调用SEQ_FOR_EACH。正如前一节中所解释的，GENERATE_ONE_PAIR获取每个元组（struct_name，sequence_of_type_name_pairs）。它接受名称并在其后添加一对括号，然后使用sequence_of_type_name_pairs调用GENERATE_VECTOR_OF_MEMBER_NAMES。 GENERATE_VECTOR_OF_MEMBER_NAMES首先添加强制性“名称”成员，然后使用与上面解释的宏非常相似的BOOST_PP_ENUM执行某些操作，区别在于它需要做一个小技巧，因为当前的元组序列没有两组括号（在第3种方法中解释为here）。 GENERATE_MEMBER_NAME_SEQUENCE然后只需获取成员的名称，将其转换为字符串，然后在其周围放置一组括号。

GENERATE_STRUCT_DEFS
BOOST_PP_REPEAT(N,MACRO,DATA)调用MACRO N次，传递DATA和当前重复索引。 GENERATE_ONE_STRUCT_DEF获取序列的索引元素，然后首先获取结构的名称，最后获取类型名称对的序列，并使用这些值调用DO_GENERATE_ONE_STRUCT_DEF。最后DO_GENERATE_ONE_STRUCT_DEF构建BOOST_FUSION_DEFINE_STRUCT宏调用。

我想，但我知识不足以确保有一个 BOOST_FUSION_ADAPT_STRUCT_NAMESPACE_DEFINITION_END中的错误。它用我认为应该直接使用BOOST_PP_REPEAT_1 BOOST_PP_REPEAT。我有未定义并重新定义该宏使用 BOOST_PP_REPEAT并且一切似乎都有效，但你可能不应该盲目相信。

Test Running on WandBox

<强> define_xml_tags.hpp

#include <boost/fusion/include/define_struct.hpp>
#include <boost/variant.hpp>
#include <vector>
#include <utility>
#include <boost/preprocessor/cat.hpp>
#include <boost/preprocessor/repetition/repeat.hpp>
#include <boost/preprocessor/seq/enum.hpp>
#include <boost/preprocessor/seq/for_each.hpp>
#include <boost/preprocessor/seq/for_each_i.hpp>
#include <boost/preprocessor/seq/size.hpp>
#include <boost/preprocessor/stringize.hpp>
#include <boost/preprocessor/tuple/elem.hpp>

//I think there is a bug in the original macro, it uses BOOST_PP_REPEAT_1 where I think it should use BOOST_PP_REPEAT, but I don't know enough to know for sure
#undef BOOST_FUSION_ADAPT_STRUCT_NAMESPACE_DEFINITION_END

#define BOOST_FUSION_ADAPT_STRUCT_NAMESPACE_DEFINITION_END(NAMESPACE_SEQ)       \
    BOOST_PP_REPEAT(                                                          \
        BOOST_PP_DEC(BOOST_PP_SEQ_SIZE(NAMESPACE_SEQ)),                         \
        BOOST_FUSION_ADAPT_STRUCT_NAMESPACE_END_I,                              \
        _)

//helps form a SEQUENCE of TUPLES
#define XML_TAG(NAME,MEMBER_SEQ) ((NAME,MEMBER_SEQ)) 

//helpers for GENERATE_STRUCT_DEFS, read from the bottom to the top
#define DO_GENERATE_ONE_STRUCT_DEF(NAME,MEMBER_SEQ) \
BOOST_FUSION_DEFINE_STRUCT( (), NAME, (std::string, name) MEMBER_SEQ)

#define GENERATE_ONE_STRUCT_DEF(Z,INDEX,TAG_SEQ) \
DO_GENERATE_ONE_STRUCT_DEF(BOOST_PP_TUPLE_ELEM(2,0,BOOST_PP_SEQ_ELEM(INDEX,TAG_SEQ)), BOOST_PP_TUPLE_ELEM(2,1,BOOST_PP_SEQ_ELEM(INDEX,TAG_SEQ)))

#define GENERATE_STRUCT_DEFS(TAG_SEQ) \
BOOST_PP_REPEAT(BOOST_PP_SEQ_SIZE(TAG_SEQ),GENERATE_ONE_STRUCT_DEF,TAG_SEQ)


//helpers for GENERATE_VARIANT_OF_TYPES, bottom to top
#define GET_TYPE_SEQUENCE(R,DATA,NAME_MEMBERSEQ_TUPLE) \
(BOOST_PP_TUPLE_ELEM(2,0,NAME_MEMBERSEQ_TUPLE))

#define ENUMERATE_TYPES(TAG_SEQ) \
BOOST_PP_SEQ_ENUM(BOOST_PP_SEQ_FOR_EACH(GET_TYPE_SEQUENCE,_,TAG_SEQ))

#define GENERATE_VARIANT_OF_TYPES(TAG_SEQ) \
typedef boost::variant<ENUMERATE_TYPES(TAG_SEQ)> Types;


//helpers for GENERATE_XMLTAGS, go from bottom to top in order to understand

//Heavily "inspired" from BOOST_FUSION_ADAPT_STRUCT
#define GENERATE_NAME_SEQUENCE_FILLER_0(X, Y)  \
    ((X, Y)) GENERATE_NAME_SEQUENCE_FILLER_1
#define GENERATE_NAME_SEQUENCE_FILLER_1(X, Y)  \
    ((X, Y)) GENERATE_NAME_SEQUENCE_FILLER_0
#define GENERATE_NAME_SEQUENCE_FILLER_0_END
#define GENERATE_NAME_SEQUENCE_FILLER_1_END

#define GENERATE_MEMBER_NAME_SEQUENCE(R,DATA,INDEX,TYPE_NAME_TUPLE) (BOOST_PP_STRINGIZE(BOOST_PP_TUPLE_ELEM(2,1,TYPE_NAME_TUPLE)))

#define GENERATE_VECTOR_OF_MEMBER_NAMES(MEMBER_SEQ) \
{ "name", BOOST_PP_SEQ_ENUM(BOOST_PP_SEQ_FOR_EACH_I(GENERATE_MEMBER_NAME_SEQUENCE,_,BOOST_PP_CAT(GENERATE_NAME_SEQUENCE_FILLER_0 MEMBER_SEQ,_END))) }

#define GENERATE_ONE_PAIR(R,DATA,NAME_MEMBERSEQ_TUPLE) \
{ BOOST_PP_TUPLE_ELEM(2,0,NAME_MEMBERSEQ_TUPLE)(), GENERATE_VECTOR_OF_MEMBER_NAMES(BOOST_PP_TUPLE_ELEM(2,1,NAME_MEMBERSEQ_TUPLE)) },

#define GENERATE_PAIRS(TAG_SEQ) \
BOOST_PP_SEQ_FOR_EACH(GENERATE_ONE_PAIR,_,TAG_SEQ)

#define GENERATE_XMLTAGS(TAG_SEQ) \
const std::vector<std::pair<Types,std::vector<std::string>>> xmlTags = { GENERATE_PAIRS(TAG_SEQ) };


//This is the actual macro, it simply invokes three different macros that do a different task each
#define DEFINE_XML_TAGS(TAG_SEQ) \
GENERATE_STRUCT_DEFS(TAG_SEQ) \
GENERATE_VARIANT_OF_TYPES(TAG_SEQ) \
GENERATE_XMLTAGS(TAG_SEQ)

<强>的main.cpp

#include <iostream>
#include <boost/fusion/include/io.hpp>
#include <boost/fusion/include/as_vector.hpp>
#include <boost/variant/static_visitor.hpp>

#include "define_xml_tags.hpp"



DEFINE_XML_TAGS(
    XML_TAG(
        Person,
        (int, age)
    )
    XML_TAG(
        Company,
        (int, noEmployees)
        (std::string, location)
    )
)

struct printer : boost::static_visitor<void> {
    void operator()(const Person& p) const
    {
        std::cout << "This is a person:" << boost::fusion::as_vector(p) << '\n';
    }

    void operator()(const Company& c) const
    {
        std::cout << "This is a company:" << boost::fusion::as_vector(c) << '\n';
    }
};

void identify(Types v)
{
    boost::apply_visitor(printer(),v);
}


int main() 
{
    Person p;
    p.name="John";
    p.age = 18;

    identify(p);

    Company c;
    c.name="Mpany Co";
    c.noEmployees=123;
    c.location="Fake St";
    identify(c);


    std::cout << "\nChecking xmlTags:\n";
    for(const auto& pair : xmlTags)
    {
        identify(pair.first);
        std::cout << "It has the following members:\n";
        for(const auto& str : pair.second)
            std::cout << str << '\n';
    }

    std::cout << std::endl;
}

通过将参数转换为字符串文字来生成样板代码

1 个答案: