@dump(file:string, variable_1, ... variable_p)
is a special form: the arguments variable_i
are restricted to be
variables. Calling this special form store the values of the variables
in the file whose path is file
. This function is a special form,
so it cannot be curryfied.
The stored value can be restored using the function @loadvar. The dump file produced by @dump is in a human readable format and corresponds to a fragment of the Antescofo grammar.
The returned value is true
if the value of the variable have been
saved, false
elsewhere (e.g. if file
cannot be created). The
process of saving the values is done asynchronuously in a dedicated
thread, so the run-time computation are not perturbed.
The dump file can be produced during one program execution and can be read in another program execution. This mechanism can be used to manage presets.
Note that this special form expands into the ordinary function @dumpvar. The same comments apply.
See also @dumpvar
See Data Exchange Functions: @dump @dumpvar @gnuplot @json_read @json_string @json_write @loadvalue @loadvar @nim2vezer @parse @plot @read_file @rplot @savevalue @set_osc_handling_double @set_osc_handling_int64 @set_osc_handling_tab @string2fun @string2obj @string2proc @to_num @xml_read @xml_string