Series 2600B System SourceMeter® Instrument Reference Manual
Section 7: TSP command reference
2600BS-901-01 Rev. C / August 2016
7-119
io.open()
This function opens a file for later reference.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
No
Usage
fileVar, errorMsg
= io.open(
path
)
fileVar, errorMsg
= io.open(
path, mode
)
fileVar
The descriptor of the opened file
errorMsg
Indicates whether an error was encountered while processing the
function
path
The path of the file to open
mode
A string representing the intended access mode (
"r"
= read,
"w"
= write, and
"a"
= append)
Details
The path to the file to open may be absolute or relative to the current working directory. If you
successfully open the file,
errorMsg
is nil and
fileVar
has the descriptor that can be used to
access the file.
If an error is encountered, the command returns
nil
for
fileVar
and an error string.
Example
testFile, testError = io.open("testfile.txt", "w")
if testError == nil then
testFile:write("This is my test file")
io.close(testFile)
end
Opens file
testfile.txt
for
writing. If no errors were found
while opening, writes
"This is
my test file"
and closes the
file.
Also see
(on page 7-117)
io.output()
This function assigns a previously opened file or opens a new file as the default output file.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes (see
Details
)
Usage
fileVar
= io.output()
fileVar
= io.output(
newfile
)
fileVar
The descriptor of the output file or an error message (if the function fails)
newfile
A file descriptor to assign (or the path of a file to open) as the default output
file