2600S-901-01 Rev. C / January 2008
Return to
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 “
for more information.
Also see
,
,
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 “
for more information.
Also see
,
,
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.01
dataqueue.add
Function
Adds an entry into the data queue.
