![background image](http://html2.mh-extra.com/html/keithley/system-sourcemeter-2601b/system-sourcemeter-2601b_reference-manual_4009934388.webp)
Section 7: TSP command reference
Series 2600B System SourceMeter® Instrument Reference Manual
7-48
2600BS-901-01 Rev. B / May 2013
dataqueue.next()
This function removes the next entry from the data queue.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
value
= dataqueue.next()
value
= dataqueue.next(
timeout
)
value
The next entry in the data queue
timeout
The number of seconds to wait for data in the queue
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")
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.000
2.000
3.000
4.000
5.000
6.000
7.000
8.000
9.000
1.001
There are 0 items in the data queue
Also see
dataqueue.add()
(on page 7-45)
dataqueue.CAPACITY
dataqueue.clear()
(on page 7-46)
dataqueue.count
(on page 7-47)
format.asciiprecision
Summary of Contents for System SourceMeter 2601B
Page 841: ......