Online Help

The calling sequence convert( e, 'record' ) converts the expression e to a record.

The input expression e must be a module without local variables, a list of equations whose left-hand sides are symbols, or a table all of whose indices are symbols. No other expression may be converted to a record.

The calling sequence convert( e, 'record', 'deep' ) converts the table e to a record and any entries of e that are tables are also converted to records recursively. The deep option works only for tables.

Note: If the input expression e is a record, then it is returned unchanged.

If the input expression e is a module, then it must not have non-exported local variables to be converted to a record. The resulting record has the names of the module exports as slot names, and their assigned values (if any) as the corresponding slot values.

A list of equations of the form $\[{\mathrm{name}}_1={\mathrm{value}}_1,{\mathrm{name}}_2={\mathrm{value}}_2,...,{\mathrm{name}}_k={\mathrm{value}}_k\]$ may be converted to a record. Each left-hand side ${\mathrm{name}}_i$ must be a symbol. In this case, the resulting record is precisely the one that would be obtained by calling the Record constructor with the given equations as arguments.

If the input expression e is a table, then every one among its indices must be a symbol. The resulting record has the table indices as slot names, and the corresponding tabular values as the record slot values.

In any calling sequence, you can optionally use 'record'['packed'] in place of 'record' to specify that the output will be a packed Record .

$r≔\mathrm{Record}\left(a=1\,b=2\right)$

$r≔\mathrm{Record}\left(a=1\,b=2\right)$

$\mathrm{type}\left(r\,'\mathrm{record}'\right)$

$\mathrm{true}$

$\mathrm{convert}\left(r\,'\mathrm{record}'\right)$

$\mathrm{Record}\left(a=1\,b=2\right)$

$m≔\mathbf{module}\left(\right)\mathrm{\_export}\left(a\,b\right)\;a≔1\;b≔2\mathbf{end\; module}\:$

$\mathrm{convert}\left(m\,'\mathrm{record}'\right)$

$\mathrm{Record}\left(a=1\,b=2\right)$

$m≔\mathbf{module}\left(\right)\mathrm{\_export}\left(a\,b\right)\;\mathrm{\_local}\left(u\right)\;a≔1\;b≔2\;u≔3\mathbf{end\; module}\:$

$\mathrm{convert}\left(m\,'\mathrm{record}'\right)$

Error, (in `convert/record`) cannot convert a module with locals to a record

$\mathrm{convert}\left(\left[a=1\,b=2\right]\,'\mathrm{record}'\right)$

$\mathrm{Record}\left(a=1\,b=2\right)$

$\mathrm{convert}\left(\mathrm{table}\left(\left[a=1\,b=2\right]\right)\,'\mathrm{record}'\right)$

$\mathrm{Record}\left(a=1\,b=2\right)$

$\mathrm{convert}\left(\mathrm{table}\left(\left[a=1\,b=2\right]\right)\,'\mathrm{record}'\left['\mathrm{packed}'\right]\right)$

${\mathrm{Record}}_{\mathrm{packed}}\left(a=1\,b=2\right)$

$\mathrm{convert}\left(\mathrm{table}\left(\left[a=1\,b=\mathrm{table}\left(\left[d=3\,e=\mathrm{table}\left(\left[f=5\right]\right)\right]\right)\right]\right)\,'\mathrm{record}'\right)$

$\mathrm{Record}\left(a=1\,b=table\left(\left[e=table\left(\left[f=5\right]\right)\,d=3\right]\right)\right)$

The convert/record command was updated in Maple 2020.

The deep option was introduced in Maple 2020.

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