Series 3700 System Switch/Multimeter Reference Manual
Section 9
:
Instrument Control Library (ICL)
Document Number: 3700S-901-01 Rev. A / August 2007
9-15
bit.setfield
Example
The binary equivalent of decimal 15 is 1111. After overwriting it with a decimal 5
(binary 101) at index position 2, the returned value will be decimal 11 (binary 1011):
value = bit.setfield(15, 2, 3, 5)
print(value)
Output: 1.01
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.
Also see
Logic and bit operations
(on page 9-9)
bit.clear
(on page 9-11)
bit.get
(on page 9-12)
bit.getfield
(on page 9-12)
bit.set
(on page 9-13)
bit.setfield
(on page 9-14)
bit.toggle
(on page 9-15)
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.