YAML第一章 基本概念及語法

簡介

本文對YAML的基本概念及語法進行了詳細的分析，尤其是對YAML的語法進行了詳細的闡述，旨在希望通過本文能對YAML有一個基本的了解，能夠書寫YAML文檔。

聲明

本文中的內容屬于個人總結整理而來,個人水平有限，對于部分細節難免有理解錯誤及遺漏之處，如果您在閱讀過程中有所發現，希望您能指正，同時文章中的部分內容也參考了其它大神的文章，如果文章中的內容侵犯了您的權益，表示非常歉意，請您指出，我將盡快修改。

如果您進行轉載，請標明出處。

YAML學習筆記一 YAML基本概念及語法(http://www.liyubin.com/articles/2019/03/14/1552529532355.html)

YAML基本概念

1. YAML簡介

YAML，是一個可讀性高，用來表達資料序列的編程語言。YAML參考了其他多種語言，包括：XML、C語言、Python、Perl以及電子郵件格式。目YAML是”YAML Ain’t a Markup Language”（YAML不是一種置標語言）的遞歸縮寫。在開發的這種語言時，YAML 的意思其實是：”Yet Another Markup Language”（仍是一種置標語言），但為了強調這種語言以數據做為中心，而不是以置標語言為重點，而用返璞詞重新命名。

YAML官方文檔中給的定義很簡單，即：“YAML Ain’t Markup Language” (abbreviated YAML) is a data serialization language designed to be human-friendly and work well with modern programming languages for common everyday tasks. This specification is both an introduction to the YAML language and the concepts supporting it; it is also a complete reference of the information needed to develop applications for processing YAML.

2. YAML VS XML，YAML VS Json，…

網上有很多關于這類的文章的描述，不過多介紹，有興趣的可以自行搜索比較，看看各路大神對YAML的分析

3. YAML不足

YAML沒有自己的數據類型的定義，而是使用實現語言的數據類型。一個YAML文件，在不同語言中解析后得到的數據類型可能會不同，由于其兼容性問題，不同語言間的數據流轉不建議使用YAML。

YAML基本語法

1. YAML語法

• 基本格式要求

  • YAML使用可打印的Unicode編碼作為標準字符編碼，可以使用UTF-8或者UTF-16
  • YAML對于大小寫是敏感的
  • YAML文件使用.yaml做為后綴
  • YAML使用縮進代表層級關系，同時縮進只能使用空格，不能使用tab鍵（推薦：在各種語言中為了使用代碼統一，可以在各編輯器中設置使用空格來替換Tab，一般使用4個空格），對于空格的數量沒有特別的要求，但相同的層級在左對齊

• 基本類型

  • 內置類型

    類型表示方法備注

    整數	!!int	可使用10進制，2進制，8進制，16進制表示
    浮點數	!!float	—
    布爾	!!bool	可以是True，true,tRue,False等，忽略大小寫
    字符串	!!str	復雜的情況下可以文本塊
    二進制	!!binary	也是字符串類型
    日期時間	!!timestamp	采用ISO8601格式
    空值	!!	—
    集合	!!set	—
    序列	!!seq	----
    鍵值表	!!map	鍵是唯一的
    鍵值列表	!!omap	—
    對象列表	!!pairs	—

    特別指出：對于二進制類型來說本質是上一個base64的文本塊，如：

    picture: !!binary |R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5OTk6enp56enmleECcgggoBADs=

  • 常量值

    表示單個的，不可再分的值，主要的結構有：整數，浮點數，字符串，NULL，日期，布爾，時間

    布爾型類型：

    值為true/false，完全忽略大小寫 isstudent: trUe

    浮點數：

    固定小數： pi: 3.1415926科學計數法表示： pi: 31415926e-8負無窮: minmin: -.inf無效數字： notnum: .NaN

    整型值：可以使用10進制、2進制、8進制、16進制表示

    10進制： intvalue: 1232進制： intvalue: 0b1010_10108進制： intvalue: 0o3416進制： intvalue: 0xFFFF

    字符串/文本塊：

    strvalue: newline字符串類的值，也可以使用單引號或雙引號，若字符串中包含有空格或者特殊字符，則必須使用單引號或者雙引號，雙引號與單引號還有不同，雙引號不會對特殊字符轉義，若單引號之中還有單引號，則必須連續使用兩個單引號轉義 字符串可以拆成多行，每一行會被轉成一個空格，對于多行字符串可以使用|保留換行符，也可以使用>折疊換行，使用+表示保留文字塊末尾的換行，使用-表示刪除字符串末尾的換行 字符串也可以HTML標記strvalue: 'new\nline' 使用單引號相當于{ strvalue: 'new\\nline' }strvalue: "new\nline" 使用雙引號相當于{ strvalue: 'new\nline' },雙引號不會對特殊字符轉義strvalue: newline 字符串可以拆成多行，每一行會被轉成一個空格,相當于{ strvalue: 'new line' }strvalue: |newline 使用|來表示需要保留換行符，相當于{ strvalue: 'new\nline\n' }strvalue: >newline 使用>折疊換行，相當于{ strvalue: 'new line\n' }strvalue: |+newline 使用+表示保留末尾的換行,相當于{ strvalue: 'new\nline\n' }strvalue: |-newline 使用-表示刪除末尾的換行，相當于{ strvalue: 'new\nline' }strvalue: |<p style="color: red">newline</p> 相當于{ strvalue: '<p style="color: red">\n newline\n</p>\n' }

    日期類型：

    日期必須使用ISO 8601格式，即：yyyy-MM-dd date: 2019-03-13

    時間類型：

    時間使用ISO 8601格式，時間和日期之間使用T連接，使用+或者-代表時區 datetime: 2019-03-13T20:49:33+08:00

    NULL類型：

    使用~表示null nullvalue: ~相當于{ nullvalue: null }

  • 鍵值表、映射、哈希、字典

    鍵值對的集合，使用冒號(: )代表，格式為key: value,需要注意的是冒號后面需要添加一個空格，如：

    Block style: !!mapClark : EvansBrian : IngersonOren : Ben-Kiki Flow style: !!map { Clark: Evans, Brian: Ingerson, Oren: Ben-Kiki }相當于{ 'Block style': { Clark: 'Evans', Brian: 'Ingerson', Oren: 'Ben-Kiki' },'Flow style': { Clark: 'Evans', Brian: 'Ingerson', Oren: 'Ben-Kiki' } }

    當鍵是一個列表或者鍵值表時，需要使用問號(? )表示復雜的鍵,如：

    ? - blue- red- green : Color也可以使用流式表示 ? [blue, reg, green]: Color相當于：{ 'blue,red,green': 'Color' }

  • 數組、序列、列表

    一組按次序排列的值，使用短橫線(- )代表數組，格式為- value，需要注意的短橫線后面需要添加一個空格，如：

    student：- jone- steven- bob

    數組可以使用復雜的類型，比如:

    classes:- id: 1001name: joneage: 12- id: 1002name: stevenage: 14-id: 1003name: bobage: 15

    數組中復雜的類型，也可以使用流式（flow）方式表示，如：

    classes: [{id: 1001, name: jone, age: 12},{id: 1002, name: steven, age: 14},{id: 1003, name: bob,age: 15}]

• 注釋

  YAML中使得#做為注釋，從這個字符一直到行尾，都會被忽略

• 文檔開始與結束符

  使用三個短橫線(—)，表示一個文檔的開始，一般情況下在同一個文件中有有多個時使用
  使用三個點號(…)，表示一個文檔的結束，一般情況下和—共同使用。尤其是對于網絡傳輸或者流來說，作為明確的結束符號有利于軟件的處理。

  比如： ```--- id: 1001 name: jone age: 12 ... --- id: 1002 name: steven age: 14 ...```

• 類型強制轉換

  可以使用雙感嘆號(!!),表示需要進行類型轉換,如：

  使用!!str將整型及bool型強制轉成字符串string:- !!str 123456- !!str true

  具體的內置類型可以參看上述的類型描述中

• 引用

  可以使用&符號來定義描點，可以使用*來引用定義的描點，可以使用<<來合并到當前數據中，如：

  defaults: &defaults adapter: postgres host: localhostdevelopment:database: myapp_development<<: *defaultstest:database: myapp_test<<: *defaults相當于defaults:adapter: postgreshost: localhostdevelopment:database: myapp_developmentadapter: postgreshost: localhosttest:database: myapp_testadapter: postgreshost: localhost

• 指令符號

  在單一的文檔中可以使用指導指令，一般情況下定義在文檔的開始早于開始符號(—)，使用百分比符號(%)，在YAML1.1中定義了兩個指導指令：

  • %YAML 指導指令，用來識別文件的YAML版本號，放在文檔的首行
  • %TAG 指導指令，被用在URI的字首標記，這個方法在標記節點的型態時相當有用

  TODO:有待進一步補充

• 自定義類型或標識

  可以使用單個感嘆號(!)表示自定義類型

  TODO:有待進一步補充

2. YAML各種語言的實現

YAML語言已經有了多種語言的實現，具體的參見YAML官網，此處將會重點介紹一下C#中YAML的實現。

章節

• YAML學習筆記 總章
• 第一章 YAML基本概念及語法
• 第二章 YAML與Unity
• 第三章 C#解析YAML

參考資料

• YAML 技術研究
• YAML官網
• YAML Tutorial
• YAML快速入門
• YAML詳解 是什么
• 通過一篇YAML來學習YAML
• YAML在線格式化校驗工具

總結

以上是生活随笔為你收集整理的YAML第一章 基本概念及语法的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。