Tektronix DSA8300, Programmer'S Manual

Page: 25 / 455

Command Syntax
("). The following is an example of a quoted string:
"This is a quoted
string"
. This documentation represents these arguments as follows:
Table 2-15: Quoted String Argument
Symbol Meaning
<QString> Quoted string of ASCII text
A quoted string can include any character de fi ned in the 7-bit ASCII character
set. Follow these rules when you use quoted strings:
1. Use the same type of quote character to open and close the string. For
example:
"this is a valid string"
.
2. You can mix quotation marks within a string as long as you follow the
previous rule. For example,
"this is an 'acceptable' string"
.
3. You can include a quote character within a string by repeating the quote. For
example:
"here is a "" mark"
.
4. Strings can have upper or lower case characters.
5. If you use a GPIB network, you cannot terminate a quoted string with the
END message before the closing delimiter.
6. A carriage return or line feed embedded in a quoted string does not terminate
the string, but is treated as just another character in the string.
7. The maximum length of a quoted string returned from a query is 1000
characters.
Here are some invalid strings:
"Invalid string argument'
(quotes are not of the same type)
"test<EOI>"
(termination character is embedded in the string)
Block
Several instrument commands use a block argument form (see the following table).
Table 2-16: Block Argument
Symbol Meaning
<NZDig> A nonzero digit character in the range of 1–9
<Dig> A digit character, in the range of 0–9
<DChar> A character with the hexadecimal equivalent of 00 through FF (0
through 255 decimal)
<Block>
A block of data bytes de fi ned as: <Block> ::=
{#<NZDig><Dig>[<Dig>...][<DChar>...]
|#0[<DChar>...]<terminator>}
DSA8300 Programmer Manual 2-9