Ruby Psych.parse_stream用法及代码示例

parse_stream(yaml, filename: nil, &block)

解析 yaml 中的 YAML 字符串。返回 Psych::Nodes::Stream 。此方法可以处理 yaml 中包含的多个 YAML 文档。如果引发 Psych::SyntaxError ，则在异常消息中使用filename。

如果给定一个块，则在解析块时将产生一个 Psych::Nodes::Document 节点。

当检测到 YAML 语法错误时引发 Psych::SyntaxError 。

例子：

Psych.parse_stream("---\n - a\n - b") # => #<Psych::Nodes::Stream:0x00>

Psych.parse_stream("--- a\n--- b") do |node|
  node # => #<Psych::Nodes::Document:0x00>
end

begin
  Psych.parse_stream("--- `", filename: "file.txt")
rescue Psych::SyntaxError => ex
  ex.file    # => 'file.txt'
  ex.message # => "(file.txt): found character that cannot start any token"
end

当 NilClass 被传递时引发 TypeError 。

有关 YAML AST 的更多信息，请参阅 Psych::Nodes 。