Keithley 2450 Reference Manual page 572

Model 2450 Interactive SourceMeter® Instrument Reference Manual
dataqueue.next()
This function removes the next entry from the data queue.
Type TSP-Link accessible
Function Yes
Usage
value = dataqueue.next()
value = dataqueue.next(timeout)
value
timeout
Details
If the data queue is empty, the function waits up to the timeout value.
If data is not available in the data queue before the timeout expires, the return value is nil.
The entries in the data queue are removed in first-in, first-out (FIFO) order.
If the value is a table, a duplicate of the original table and any subtables is made. The duplicate table does not
contain any references to the original table or to any subtables.
Example
dataqueue.clear()
for i = 1, 10 do
dataqueue.add(i)
end
print("There are " .. dataqueue.count
.. " items in the data queue")
while dataqueue.count > 0 do
x = dataqueue.next()
print(x)
end
print("There are " .. dataqueue.count
.. " items in the data queue")
Also see
dataqueue.add()
dataqueue.CAPACITY
dataqueue.clear()
dataqueue.count
format.asciiprecision
2450-901-01 Rev. B/September 2013
Affected by
The next entry in the data queue
The number of seconds to wait for data in the queue
(on page 8-38)
(on page 8-39)
(on page 8-39)
(on page 8-40)
(on page 8-62)
Section 8: TSP command reference
Where saved Default value
Clears the data queue, adds ten entries, then
reads the entries from the data queue. Note that
your output may differ depending on the setting
of format.asciiprecision.
Output:
There are 10 items in the data
queue
1.0000000e+00
2.0000000e+00
3.0000000e+00
4.0000000e+00
5.0000000e+00
6.0000000e+00
7.0000000e+00
8.0000000e+00
9.0000000e+00
1.0000000e+01
There are 0 items in the data queue
8-41