2600S-901-01 Rev. C / January 2008 Return to Section Topics 12-15
Series 2600 System SourceMeter® Instruments Reference Manual Section 12: Instrument Control Library
data queue functions
You can use the data queue commands to share data between test scripts running in parallel and
to access data from a remote group or a local node on a TSP-Link network. You can access data
from the data queue even if a remote group or a local node has overlapped operations in process.
bit.test
Function Returns the Boolean value (true or false) of a bit at a given index position.
Usage value = bit.test(value1, index)
value1 Given number.
index Index position of the bit to be tested (1 to 32).
value Returned decimal value of the bit.
Remarks • This function returns value, which is the result of the tested bit. The least significant bit
of the given number is at index 1. The most significant bit is at index 32.
• Any fractional part of value1 will be truncated to make it an integer. If the indexed bit for
value1 is set to 0, the returned value will be false. If the indexed bit for value1 is set to
1, the returned value will be true.
• If the index is bigger than the number of bits in value1, the result will be false.
•See “Logic and bit operations” on page 12-10 for more information.
Also see bit.clear, bit.get, bit.getfield, bit.set, bit.setfield, bit.toggle
Example The binary equivalent of decimal 10 is 1010. Testing the bit at index position 4 will
return a Boolean
value of true:
value = bit.test(10, 4)
print(value)
Output: true
bit.toggle
Function Toggles the value of a bit at a given index position.
Usage value = bit.toggle(value1, index)
value1 Given number.
index Index position of the bit to be toggled (1 to 32).
value Returned value of the new number.
Remarks • This function returns value, which is the result of toggling a bit in value1.
• Any fractional part of value1 is truncated to make it an integer. The returned decimal
value is also an integer. The least significant bit of the given number is index 1. The
most significant bit is index 32.
• The indexed bit for value1 is toggled from 0 to 1, or 1 to 0.
•See “Logic and bit operations” on page 12-10 for more information.
Also see bit.clear, bit.get, bit.getfield, bit.set, bit.setfield, bit.test
Example The binary equivalent of decimal 10 is 1010. Toggling the bit at index position 3 will
return a decimal
value of 14 (binary 1110).
value = bit.toggle(10, 3)
print(value)
Output: 1.400000e+01
dataqueue.add
Function Adds an entry into the data queue.