yaml-cpp —— C++ 项目配置工具入门

Reference

http://code.google.com/p/yaml-cpp/

What is yaml？

YAML Ain't Markup Language, yaml不是标记语言。yaml命名是递归的，类似于GNU's Not Unix.

YAML is a human friendly data serialization
  standard for all programming languages.

yaml 用来编写项目的配置文件，优势如下，友好，简明：

http://zh-cn.w3support.net/index.php?db=so&id=1308536

http://www.ibm.com/developerworks/cn/xml/x-matters/part23/

A Complete Example 

看懂这个完整的演示程序，yaml 就入门了。。。

Here's a complete example of how to parse a complex YAML file:

monsters.yaml //这是yaml文件，后缀必须是yaml

- name: Ogre
  position: [0, 5, 0]
  powers:
    - name: Club
      damage: 10
    - name: Fist
      damage: 8
- name: Dragon
  position: [1, 0, 10]
  powers:
    - name: Fire Breath
      damage: 25
    - name: Claws
      damage: 15
- name: Wizard
  position: [5, -3, 0]
  powers:
    - name: Acid Rain
      damage: 50
    - name: Staff
      damage: 3

关于配置文件
1.类似于python，空白缩进表示一个结构。注意不是tab缩进。
2.以 - 开头，接下来的每一行都是这个结构的一个成员，也可以把多个成员写在同一行用[]标示。
main.cpp

#include "yaml-cpp/yaml.h" //安装yaml-cpp参考google code 主页
#include <iostream>
#include <fstream>
#include <string>
#include <vector>

// our data types //这个例子好像是取自开源游戏引擎ogre，随便说的
struct Vec3 { //位置坐标
   float x, y, z;
};

struct Power { //招式，魔法
   std::string name; //招式名字，如 葵花宝典
   int damage; //伤害值
};

struct Monster { //怪兽
   std::string name;
   Vec3 position;
   std::vector <Power> powers;
};

// now the extraction operators for these types //重载 >> 预算符。。。。
void operator >> (const YAML::Node& node, Vec3& v) {
   node[0] >> v.x;
   node[1] >> v.y;
   node[2] >> v.z;
}

void operator >> (const YAML::Node& node, Power& power) {
   node["name"] >> power.name;
   node["damage"] >> power.damage;
}

void operator >> (const YAML::Node& node, Monster& monster) {
   node["name"] >> monster.name;
   node["position"] >> monster.position;
   const YAML::Node& powers = node["powers"];
   for(unsigned i=0;i<powers.size();i++) {
      Power power;
      powers[i] >> power;
      monster.powers.push_back(power);
   }
}

int main() //测试程序
{
   std::ifstream fin("monsters.yaml"); // 读入yaml配置文件。
   YAML::Parser parser(fin); //yaml 分析输入的配文件。出错抛出YAML::ParserException
   YAML::Node doc; 
   parser.GetNextDocument(doc); //doc 就是我们的yaml配置文件
   for(unsigned i=0;i<doc.size();i++) {//i的实际值是0，1，2 ；关联yaml 中三个大的struct：ogre，dragon，wizard
      Monster monster;
      doc[i] >> monster;
      std::cout << monster.name << "\n";
   }

   return 0;
}