YAML 学习

1.是什么？

官网
官方解释

YAML: YAML Ain't Markup Language

What It Is: YAML is a human friendly data serialization
  standard for all programming languages.

YAML（/ˈjæməl/，尾音类似camel骆驼）是一个可读性高，用来表达数据序列化的格式

2.怎么使用？

2.1基本使用规则

• 大小写敏感
• 使用缩进表示层级关系
• 缩进不允许使用tab，只允许空格
• 缩进的空格数不重要，只要相同层级的元素左对齐即可
• '#'表示注释

3.1数据类型

• 对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）
• 数组：一组按次序排列的值，又称为序列（sequence） / 列表（list）
• 纯量（scalars）：单个的、不可再分的值

具体参考

3.2类型介绍

在线编辑工具

3.2.1 数组

以 - 开头的行表示构成一个数组：
简单数组

- A
- B
- C

结果：

[ 'A', 'B', 'C' ]

复杂数组
数组子成员是一个数组

A:
 - 
  - a
  - b
  - c

结果：

{ A: [ [ 'a', 'b', 'c' ] ] }

3.2.2 对象

简单对象

对象键值对使用冒号结构表示 key: value，冒号后面要加一个空格。
也可以使用 key:{key1: value1, key2: value2, ...}。
还可以使用缩进表示层级关系；

obj1: 
   A : aaa
   B: bb
   C: cc
   
obj2: {A: aa,B: bb,C: cc}

结果：

  obj1: { A: 'aaa', B: 'bb', C: 'cc' }
  
  obj2: { A: 'aa', B: 'bb', C: 'cc' } 

复杂对象
使用问号加一个空格代表一个复杂的 key，配合一个冒号加一个空格代表一个 value

? 
 - key3
 - key4
:
 - val3
 - val4

结果：

'key3,key4': [ 'val3', 'val4' ] 

3.2.3 数组对象混合

A:
 - 
   a: aaa
   b: bbb
   c: ccc

结果：

{ A: [ { a: 'aaa', b: 'bbb', c: 'ccc' } ] }

3.2.3 纯量

• 字符串
• 布尔值
• 整数
• 浮点数
• Null
• 时间
• 日期

举例：

boolean: 
    - TRUE  #true,True都可以
    - FALSE  #false，False都可以
float:
    - 3.14
    - 6.8523015e+5  #可以使用科学计数法
int:
    - 123
    - 0b1010_0111_0100_1010_1110    #二进制表示
null:
    nodeName: 'node'
    parent: ~  #使用~表示null
string:
    - 哈哈
    - 'Hello world'  #可以使用双引号或者单引号包裹特殊字符
    - newline
      newline2    #字符串可以拆成多行，每一行会被转化成一个空格
date:
    - 2018-02-17    #日期必须使用ISO 8601格式，即yyyy-MM-dd
datetime: 
    -  2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区

结果：

{ boolean: [ true, false ],
  float: [ 3.14, 685230.15 ],
  int: [ 123, 685230 ],
  null: { nodeName: 'node', parent: null },
  string: [ '哈哈', 'Hello world', 'newline newline2' ],
  date: [ Sat Feb 17 2018 08:00:00 GMT+0800 (中国标准时间) ],
  datetime: [ Sat Feb 17 2018 15:02:31 GMT+0800 (中国标准时间) ] }

3.2.4 引用

一个地方定义，在另一个地方使用
& 锚点和 * 别名
& 用来建立锚点（defaults），<< 表示合并到当前数据，* 用来引用锚点。

#对象使用引用
a: &bb
 aa: aaa
 bb: bbb
 
dev:
 log: info
 <<: *bb
 
test:
 log: debug
 <<: *bb

##数组使用引用
- cc
- &ss dd
- *ss   ##引用前一个
- ee

结果：

{ a: { aa: 'aaa', bb: 'bbb' },
  dev: { log: 'info', aa: 'aaa', bb: 'bbb' },
  test: { log: 'debug', aa: 'aaa', bb: 'bbb' } }


[ 'cc', 'dd', 'dd', 'ee' ]

以上只是简单的使用，更多使用方法和规则参考官网说明，目前是1.2版本。

C++关于YAML与Json互相转换可以参考这里

本文参考网址：
https://yaml.org/spec/1.2/spec.html#id2760395
https://www.sylar.top/sblog/detail/36
https://www.runoob.com/w3cnote/yaml-intro.html