YAML - Dòng ký tự

Trong YAML, bạn bắt gặp các luồng ký tự khác nhau như sau:

Directives
Điểm đánh dấu ranh giới tài liệu
Documents
Hoàn thành luồng

Trong chương này, chúng ta sẽ thảo luận chi tiết về chúng.

Chỉ thị

Lệnh là các lệnh cơ bản được sử dụng trong bộ xử lý YAML. Chỉ thị là các chi tiết trình bày như nhận xét không được phản ánh trong cây tuần tự. Trong YAML, không có cách nào để xác định các chỉ thị riêng. Phần này thảo luận về các loại chỉ thị khác nhau với các ví dụ có liên quan -

Chỉ thị dành riêng

Các chỉ thị dành riêng được khởi tạo bằng ba ký tự gạch nối (---) như trong ví dụ dưới đây. Các chỉ thị dành riêng được chuyển đổi thành giá trị cụ thể của JSON.

%YAML 1.1
--- !!str
"foo"

Chỉ thị YAML

YAML Directive là những chỉ thị mặc định. Nếu được chuyển đổi trong JSON, giá trị được tìm nạp bao gồm ký tự gạch chéo ở các ký tự đứng trước và ký tự kết thúc.

%YAML 1.1
---
!!str "foo"

Điểm đánh dấu ranh giới tài liệu

YAML sử dụng các điểm đánh dấu này để cho phép chứa nhiều tài liệu trong một luồng. Những điểm đánh dấu này được sử dụng đặc biệt để chuyển tải cấu trúc của tài liệu YAML. Lưu ý rằng một dòng bắt đầu bằng “---” được sử dụng để bắt đầu một tài liệu mới.

Đoạn mã sau giải thích về điều này với các ví dụ:

%YAML 1.1
---
!!str "foo"
%YAML 1.1
---
!!str "bar"
%YAML 1.1
---
!!str "baz"

Các tài liệu

Tài liệu YAML được coi là một cấu trúc dữ liệu gốc duy nhất được trình bày dưới dạng một nút gốc duy nhất. Các chi tiết trình bày trong tài liệu YAML như chỉ thị, nhận xét, thụt đầu dòng và kiểu không được coi là nội dung có trong chúng.

Có hai loại tài liệu được sử dụng trong YAML. Chúng được giải thích trong phần này -

Tài liệu rõ ràng

Nó bắt đầu với điểm đánh dấu bắt đầu tài liệu, sau đó là sự trình bày của nút gốc. Ví dụ về khai báo rõ ràng YAML được đưa ra dưới đây:

---

some: yaml

...

Nó bao gồm các điểm đánh dấu bắt đầu và kết thúc rõ ràng là “---“ và “…” trong ví dụ nhất định. Khi chuyển đổi YAML được chỉ định ở định dạng JSON, chúng tôi nhận được đầu ra như hình dưới đây:

{
   "some": "yaml"
}

Tài liệu ngầm

Các tài liệu này không bắt đầu bằng điểm đánh dấu bắt đầu tài liệu. Hãy quan sát đoạn mã dưới đây -

fruits:
   - Apple
   - Orange
   - Pineapple
   - Mango

Chuyển đổi các giá trị này ở định dạng JSON, chúng ta nhận được đầu ra là một đối tượng JSON đơn giản như được đưa ra bên dưới:

{
   "fruits": [
      "Apple",
      "Orange",
      "Pineapple",
      "Mango"
   ]
}

Hoàn thành luồng

YAML bao gồm một chuỗi các byte được gọi là dòng ký tự. Luồng bắt đầu bằng tiền tố chứa thứ tự byte biểu thị mã hóa ký tự. Luồng hoàn chỉnh bắt đầu với tiền tố chứa mã hóa ký tự, sau đó là nhận xét.

Dưới đây là một ví dụ về luồng hoàn chỉnh (luồng ký tự):

%YAML 1.1
---
!!str "Text content\n"