Dataqueue.add() - Keithley 708B Reference Manual

Models 707B and 708B Switching Matrix Reference Manual

dataqueue.add()

This function adds an entry to the data queue.
Type TSP-Link accessible
Function Yes
Usage
results = dataqueue.add(value)
results = dataqueue.add(value, timeout)
results
value
timeout
Details
You can only use the timeout value while adding data to the local data queue.
The timeout value is ignored if the data queue is not full.
The dataqueue.add() function returns false:
•
If the timeout expires before space is available in the data queue
•
If the data queue is full and a timeout value is not specified
If the value is a table, a duplicate of the 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()
dataqueue.add(10)
dataqueue.add(11, 2)
result = dataqueue.add(12, 3)
if result == false then
print("Failed to add 12 to the dataqueue")
end
print("The dataqueue contains:")
while dataqueue.count > 0 do
print(dataqueue.next())
end
Also see
dataqueue.CAPACITY
dataqueue.clear()
dataqueue.count
dataqueue.next()
707B-901-01 Rev. A / August 2010
Affected by
The resulting value of true or false based on the success of the function
The data item to add; value can be of any type
The maximum number of seconds to wait for space in the data queue
(on page 7-52)
(on page 7-52)
(on page 7-53)
(on page 7-54)
Where saved Default value
Clear the data queue.
Each line adds one item to the data queue.
Output:
The dataqueue contains:
1.0000000e+01
1.1000000e+01
1.2000000e+01
Section 7: Command reference
7-51