System SourceMeter® Instrument Reference Manual Section 7:
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
Usage
fileVar, errorMsg = io.open(path)
fileVar, errorMsg = io.open(path, mode)
The descriptor of the opened file
Indicates whether an error was encountered while processing the
The path of the file to open
A string representing the intended access mode ("r" = read,
= write, and
= 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)
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
io.close() (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)
The descriptor of the output file or an error message (if the function fails)
A file descriptor to assign (or the path of a file to open) as the default output
file