Did you know ... Search Documentation:
yaml.pl -- Process YAML data
PublicShow source

This module parses YAML serialized data into a Prolog term with structure that is compatible with the JSON library. This library is a wrapper around the C library libyaml. This library forms the basis of the YAML support in several languages and thus guarantees compatibility of our YAML support with other languages.

Source yaml_read(+Input, -DOM) is det
Parse Input to a YALM DOM. The DOM representation uses the following mapping:
  • A YAML sequence is mapped to a Prolog List.
  • A YAML mapping is mapped to a Prolog dict.
  • Untagged scalars follow the implicit tag rules defined by YAML, providing numbers (int, float and special floats), null and the booleans true and false. Other untagged values are returned as a Prolog string. Tagged values are returned as tag(Tag, String) which is processed by yalm_tagged/3. This internal predicate calls the user hook yaml:tagged/3 with the same arguments and, if the hook fails, provides the following defaults:
    • !!binary converts the Base64 to a string of bytes.
    • !!str explicitly keeps a string
    • !!null translates "null" to null
    • !!bool translates to true and false
    • !!int translates to an integer
    • !!float translates to a float
    • Anything else is returned as tag(Tag, String)
Input- is one of (1) a stream, (2) a term string(Data) or (3) a file name.
Source yaml_write(+Out:stream, +DOM) is det
Source yaml_write(+Out:stream, +DOM, +Options) is det
Emit a YAML DOM object as a serialized YAML document to the stream Out. Options processed are:
Use canonical representation. Default is false.
Use unicode Default is true.
Use implicit or explicit representation. Currently only affects the opening and closing the document. Default is true. Use false for embedded documents.
If true, minimize the term by factoring out common structures and use &anchor and *anchor. Factorization is always used if DOM is a cyclic term.

Undocumented predicates

The following predicates are exported, but not or incorrectly documented.

Source yaml_write(Arg1, Arg2, Arg3)