read_tuple ( : : FileName : Tuple )

Read a tuple from a file.

The operator read_tuple reads the contents of FileName and converts it into Tuple. The file has to be generated by write_tuple.


Parameters

FileName (input_control)
filename -> string
Name of the file to be read.

Tuple (output_control)
number(-array) -> real / integer / string
Tuple with any kind of data.


Result

If the parameters are correct the operator read_tuple returns the value 2 (H_MSG_TRUE). If the file could not be opened read_tuple returns 5 (H_MSG_FAIL). Otherwise an exception handling is raised.


Parallelization Information

read_tuple is reentrant and processed without parallelization.


Alternatives

fwrite_string


See also

write_tuple, gnuplot_plot_ctrl, write_image, write_region, open_file


Module

Operators not requiring licensing



Copyright © 1996-2005 MVTec Software GmbH