Jackson Labs PHASE STATION 53100A, User Manual

Page: 161 / 225

PhaseStation 53100A User’s Manual V1.04 25-Apr-2022 161
ScriptNumParam(Number n )
Returns a Number corresponding to the floating-point numeric value of the
n
th (zero-
based) command line parameter following the JavaScript (.js) program name on the
TimeLab command line. An exception will be thrown if the requested parameter is not
present or is not representable as a numeric value.
See 53100A_command_line_example.js for a detailed usage example.
ScriptNumVal(String format_string, Number value)
Returns a String consisting of the specified
format_string
with an embedded numeric
value.
In operation,
ScriptNumVal()
passes its
format_string
and floating-point
value
arguments to
the standard C sprintf() function, returning the resulting formatted string.
Example: The following statement
Print(ScriptNumVal("Pi = %.2lf", 3.1415926535));
will display:
Pi = 3.14
Additional usage examples appear in both 53100A_performance_test.js and
5330A_ADC_test.js . Refer to the sprintf() documentation in the C runtime library
reference for a detailed discussion of the format and precision specifiers supported for
floating-point values.
ScriptParamCount()
Returns a Number value representing the number of command-line parameters
following the JavaScript (.js) program name on the TimeLab command line.
The result will be zero if no script was specified on the TimeLab command line, or if no
subsequent parameter strings were passed on the command line.
See 53100A_command_line_example.js for a detailed usage example.
ScriptPlaySound(String filename)
Plays the specified sound file. Sound files for use with this function are typically stored
in the .wav format.
If
filename
contains a backslash character, TimeLab assumes it consists of a fully-qualified
path name and plays the sound from the filename exactly as specified. Otherwise,
filenames without backslash characters are played from the TimeLab installation
directory.