Specifications

544 Chapter 18
COM Interface Reference
How to read array data
How to read array data
In the case of using the Output method to send GPIB commands with “?”, the returned
values are built up in the queue provided in the E4991A main body. The Enter method is
the object used to read data from that queue. If the data is a single data item that is not
divided with commas (,), it can be read as is. In the case of data divided with commas (,),
the required data can be read in the required form by specifying the following option
parameters in the
Enter method.
NOTE Binary formatted array data cannot be read by the Enter method. It is necessary to set the
transfer format for reading array data to the ASCII format by using FORM:DATA on
page 374 before using the Enter method.
Option parameters offered in Enter method
The following option parameters can be specified in the Enter method as required.
Not specifying option parameter
When the Enter method is executed without specifying option parameters, the part of
data to be read differs depending on the data type of the variable used in reading data.
However, the contents of the queue become empty regardless of the data type.
• When the data type is numeric:
Example 18-20 No specification of option parameters
Assume there are returned values ("1,2,3,4") of "SCPI.Output "DATA:RAW?" kept in
the queue.
Dim Val as Double
SCPI.Output "DATA:RAW?"
SCPI.Enter Val
If "SCPI.Enter Val" is executed here, the first data only is read and substituted into Val
(Val=1). The rest of the data is cancelled at this point, and the queue becomes empty.
# Receives data by dividing data with comma (,).
* Skips a data item in the queue.