array : list or Array

Specifies the data struscture to use for parsed data corresponding to YAML arrays (sequential data delimited with square brackets). With array=list (the default), a YAML array is encoded as a list; with array=Array, it is encoded as an Array.

object : one of table, record, or DataSeries

Specifies the data structure to use for parsed data corresponding to YAML objects (collections of key/value pairs delimited with curly braces).

With object=table (the default), an object is encoded as table; with object=record, it is encoded as a record; with object=DataSeries, it is encoded as a DataSeries.

output : one of table, record, or DataSeries

A legacy alias for the object option.

ParseFile(source) reads YAML data from the file or URL source.

If source is a file, it is closed after it is read.

$\mathrm{address}≔\mathrm{FileTools}:-\mathrm{JoinPath}\left(\left[''example/address.yaml''\right]\,\mathrm{base}=\mathrm{datadir}\right)\:$

$\mathrm{YAML}:-\mathrm{ParseFile}\left(\mathrm{address}\right)$

$table\left(\left[''companyName''=''Maplesoft''\,''founded''=1988\,''phoneNumbers''=\left[table\left(\left[''number''=''+1\; (519)\; 747-2373''\,''type''=''local''\right]\right)\,table\left(\left[''number''=''+1\; (800)\; 267-6583''\,''type''=''toll-free''\right]\right)\,table\left(\left[''number''=''+1\; (519)\; 747-5284''\,''type''=''fax''\right]\right)\right]\,''address''=table\left(\left[''streetAddress''=''615\; Kumpf\; Drive''\,''city''=''Waterloo''\,''province''=''ON''\,''postalCode''=''N2V\; 1K8''\,''country''=''Canada''\right]\right)\right]\right)$

$\mathrm{YAML}:-\mathrm{ParseFile}\left(\mathrm{address}\,\mathrm{object}=\mathrm{record}\right)$

${\mathrm{Record}}_{\mathrm{packed}}\left(\mathrm{companyName}=''Maplesoft''\,\mathrm{founded}=1988\,\mathrm{phoneNumbers}=\left[{\mathrm{Record}}_{\mathrm{packed}}\left(\mathrm{...}\right)\,{\mathrm{Record}}_{\mathrm{packed}}\left(\mathrm{...}\right)\,{\mathrm{Record}}_{\mathrm{packed}}\left(\mathrm{...}\right)\right]\,\mathrm{address}={\mathrm{Record}}_{\mathrm{packed}}\left(\mathrm{...}\right)\right)$

The YAML[ParseFile] command was introduced in Maple 2017.

For more information on Maple 2017 changes, see Updates in Maple 2017.

The YAML[ParseFile] command was updated in Maple 2022.

The array and object options were introduced in Maple 2022.

For more information on Maple 2022 changes, see Updates in Maple 2022.