Series 2600B System SourceMeter® Instrument Reference Manual
Section 6: Instrument programming
2600BS-901-01 Rev. B / May 2013
6-41
When you create a script using
script.new()
, if you do not include
name
, the script is added to the
run-time environment as an unnamed script. The
script.new()
function returns the script. You can
assign it to a global variable, a local variable, or ignore the return value. A global variable is not
automatically created.
For example, send the following command:
hello = script.new('display.clear() display.settext("hello")')
A script is created in the run-time environment and a global variable is created that references the
script.
To run the script, send the command:
hello()
Figure 115: Create an unnamed script
A script will become unnamed if you create a new script with the same name. In this circumstance,
the name of the script in the
script.user.scripts
table is set to an empty string before it is
replaced by the new script.
For example, if
beepTwoSec
already exists in the
script.user.scripts
table and you sent:
beepTwoSec1200 = script.new("beeper.enable = 1 beeper.beep(2, 1200)", "beepTwoSec")
The following actions occur:
•
beepTwoSec1200
is added as a global variable.
•
The script that was in the run-time environment as
beepTwoSec
is changed to an unnamed script
(the name attribute is set to an empty string).
•
The global variable
beepTwoSec
remains in the run-time environment unchanged (it points to the
now unnamed script).
•
A new script named
beepTwoSec
is added to the run-time environment.
In this example, you can access the new script by sending either of the following commands:
beepTwoSec1200()
script.user.scripts.beepTwoSec()
To access the unnamed script, you can send the command:
beepTwoSec()
Summary of Contents for System SourceMeter 2601B
Page 841: ......