
Section 7: TSP command reference
2606B System SourceMeter® Instrument Reference Manual
7-110
2606B-901-01 Rev. B / May 2018
Details
The path of the file to open may be absolute or relative to the current working directory.
When accessed from a remote node using the TSP-Link network, this command does not accept a
file descriptor parameter and does not return a value.
If the function fails, an error message is returned.
Also see
(on page 7-108)
(on page 7-109)
io.read()
This function reads data from the default input file.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
data1
= io.read()
data1
= io.read(
format1
)
data1, data2
= io.read(
format1, format2
)
data1, ..., dataN
= io.read(
format1, ..., formatN
)
data1
The data read from the file
data2
The data read from the file
dataN
The data read from the file; the number of return values matches the number
of format values given
format1
A string or number indicating the type of data to be read
format2
A string or number indicating the type of data to be read
formatN
A string or number indicating the type of data to be read
...
One or more entries (or values) separated by commas
Details
The format parameters may be any of the following:
Format parameter
Description
"*N"
Returns a number
"*a"
Returns the whole file, starting at the present position; returns an empty string if it
is at the end of file
"*l"
Returns the next line, skipping the end of line; returns
nil
if the present file
position is at the end of file
N
Returns a string with up to
N
characters; returns an empty string if
N
is zero (0);
returns
nil
if the present file position is at the end of file
Any number of format parameters may be passed to this command, each corresponding to a returned
data value.
If no format parameters are provided, the function will perform as if the function was passed the value
"*l"
.