System SourceMeter® Instrument Reference Manual Section 7:
2600BS-901-01 Rev. B / May 2013 7-165
script.new()
This function creates a script.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
scriptVar = script.new(code)
scriptVar = script.new(code, name)
The name of the variable that will reference the script
A string containing the body of the script
Details
The name parameter is the name that is added to the script.user.scripts table. If name is not given, an
empty string will be used, and the script will be unnamed. If the name already exists in script.user.scripts,
the existing script's name attribute is set to an empty string before it is replaced by the new script.
Note that name is the value that is used for the instrument front panel display. If this value is not defined, the
script will not be available from the instrument front panel.
You must save the new script into nonvolatile memory to keep it when the instrument is turned off.
Example 1
"display.clear() display.settext('Hello from myTest8')", "myTest8")
myTest8()
Creates a new script referenced by the variable myTest8 with the name "myTest8".
Runs the script. The instrument displays "Hello from myTest8".
Example 2
autoexec = script.new(
"display.clear() display.settext('Hello from autoexec')", 'autoexec')
Creates a new autoexec script that clears the display when the instrument is turned on and displays
"
".
Also see
Create a script using the script.new() command (on page 6-40)
Global variables and the script.user.scripts table (on page 6-38)
Named scripts (on page 6-4)
scriptVar.save() (on page 7-172)
script.newautorun() (on page 7-166)