User`s manual

282 Chapter 8
O:\Manuals\E6380A_Progguid\Book\Ibasic.fm
IBASIC Controller
PROGram Subsystem
Example 8-36 Syntax
PROGram[:SELected]:STRing <varname>{,<svalues>}
Example 8-37 Example setting the value of a simple string variable
OUTPUT 714;"PROGram:SELected:STRing Variable,’data’"
or
OUTPUT 714;"PROG:STR Variable,’data’"
Example 8-38 Example of setting the value of a string array with 3 elements of
5 characters each, such as Array$(2)[5]
OUTPUT 714;"PROGram:SELected:STRing Array,’12345’,’12345’,’12345’"
or
OUTPUT 714;"PROG:STR Array,’12345’,’12345’,’12345’"
NOTE With Option Base 0 set in IBASIC, array indexing starts at 0.
:STRing? <varname> The :STRing? query command is used to
return, to an external controller, the current value of string variables or
arrays in an IBASIC program in the Test Set. <varname> is the name of
an existing string variable or string array in the IBASIC program.
NOTE If the variable name <var_name> is longer than 12 characters it must
be sent as string data (<var_name> enclosed in quotes). For example,
OUTPUT 714;"PROG:STR? ’Var_name’".
Attempting to send a <var_name> longer than 12 characters as
character data (<var_name> not enclosed in quotes) will generate the
following error:
HP-IB Error: -112 Program mnemonic too long
If you want to append the IBASIC ‘$’ string identifier onto the string
variable name, the string variable name must be sent as string data,
that is enclosed in quotes. For example,
OUTPUT 714;"PROG:STR? ’Var_name$’"
Appending the IBASIC ‘$’ string identifier onto the string variable
name without enclosing the string variable name in quotes will
generate the following error: HP-IB Error: -101 Invalid character.
For simple string variables the value is returned as a quoted string
(“This is an example.”). For string arrays the values are returned as a
comma separated list of quoted strings (“This is an example.”,“This is
an example.”). The string array elements are returned in ascending
order (Array$(0), Array$(1), Array$(2), etc.).