names=parse_stream
visibility=public
kind=defined

--- parse_stream(yaml) -> Psych::Nodes::Stream
--- parse_stream(yaml){|node| ... } -> ()

YAML ドキュメントをパースします。
yaml が 複数の YAML ドキュメントを含む場合を取り扱うことができます。

ブロックなしの場合は YAML の AST (すべての YAML ドキュメントを
保持した [[c:Psych::Nodes::Stream]] オブジェクト)を返します。

ブロック付きの場合は、そのブロックに最初の YAML ドキュメント
の Psych::Nodes::Document オブジェクトが渡されます。
この場合の返り値には意味がありません。


@see [[c:Psych::Nodes]]

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

