User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-23
bit.test()
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.
Also see
Logic and bit operations (on page 13-17)
bit.clear() (on page 13-19)
bit.get() (on page 13-19)
bit.getfield() (on page 13-20)
bit.set() (on page 13-21)
bit.setfield() (on page 13-21)
bit.toggle() (on page 13-23)
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.