Section 7: Command reference
Model 2651A High Power System SourceMeter® Instrument Reference Manual
7-84
2651A-901-01 Rev. A / March 2011
Usage
data1
=
fileVar
:read()
data1
=
fileVar
:read(
format1
)
data1
,
data2
=
fileVar
:read(
format1
,
format2
)
data1
, ...,
datan
=
fileVar
:read(
format1
, ...,
formatn
)
data1
First data read from the file
data2
Second data read from the file.
datan
Last data read from the file
fileVar
The descriptor of the file to be read
format1
A string or number indicating the first type of data to be read
format2
A string or number indicating the second type of data to be read
formatn
A string or number indicating the last 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:
"*n"
: Returns a number.
"*a"
: Returns the whole file, starting at the current position (returns an empty string if the current file position is
at the end of the file).
"*l"
: Returns the next line, skipping the end of line; returns
nil
if the current 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; returns
nil
if the current file
position is at the end of file.
If no format parameters are provided, the function will perform as if the function is passed the value
"*l"
.
Any number of format parameters may be passed to this command, each corresponding to a returned data
value.
Also see
(on page 7-85)
(on page 7-100)
fileVar:seek()
This function sets and gets a file's current position.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function No
