属性是解析器的产物。
合成
每个解析器都有一个公开的属性。
当您在表达式中组合解析器时,生成的属性将被组合成所谓的综合属性。例如。 int_ >> double_ 合成一个 (int, double)¹ 的元组。
传播
当暴露的属性传播到周围的规则上下文时,许多自动兼容性规则和转换是可能的,例如就像在
qi::rule<It, std::string()> r1 = +qi::char_; // std::vector<char> -> std::string
qi::rule<It, boost::optional<int>()> r2 = qi::int_;
qi::rule<It, map<int, double>() > r3 = (qi::int_ >> qi::double) % ';'; // requires `boost/fusion/adapted/std_pair.hpp`
绑定属性引用
这是属性的不同含义略有混淆;
parser API 接受可变数量的参数,这些参数将从解析中接收结果值。
这些被称为“绑定属性”。上下文实际上将直接引用它们。与上述相同的兼容性/传播规则适用,因此可以直接执行此操作:
using namespace qi;
std::map<std::string, int> data;
bool ok = phrase_parse(f, l, 'keyvalues: ' >> (lexeme[+alpha] >> '=' >> int_) % ';', space, data);
扩展
可以为用户定义的类型自定义转换和兼容性规则。这有点超出了这里的范围,但可以在此处找到文档:docs 和 [SO] 提供了大量示例来演示它们的使用。
链接
文档列出了使用每个运算符/指令合成的类型。
另见Detecting the parameter types in a Spirit semantic action
¹ 从技术上讲,它可能是boost::fusion::vector2<int, double>,但你不应该关心这个实现细节;属性传播规则对你隐藏了这个细节