yaml> ( str -- obj ) - Factor Documentation

yaml> ( str -- obj )
YAML serialization

Prev:	>yaml-docs ( seq -- str )
Next:	yaml-docs> ( str -- arr )

Vocabulary
yaml

Inputs

str

a string

Outputs

obj

an object

Word description
Deserializes the YAML formatted string into a Factor object. Throws yaml-no-document when there is no document (for example the empty string).

Notes
Contrary to yaml-docs>, this word only parses the input until one document is produced. Valid or invalid content after the first document is ignored. To verifiy that the whole input is one valid YAML document, use yaml-docs> and assert that the length of the output array is 1.

See also
yaml-docs>

Definition

USING: destructors kernel yaml.ffi yaml.private ;

IN: yaml

: yaml> ( str -- obj )
[
init-parser
[ YAML_STREAM_START_EVENT expect-event ]
[ ?parse-yaml-doc [ yaml-no-document ] unless ] 2bi
] with-destructors ;