User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-22 3700S-901-01 Rev. C / July 2008
bit.setfield()
Function
Overwrites a bit field at a given index position.
Usage
value = bit.setfield(value1, index, width, fieldvalue)
value1: Given number.
index: Index position of the least significant bit of the field; 1 to (33 - width ).
width: Field width number of bits in the field; 1 to 24.
fieldvalue: Value to write to the field.
value: Returned value of the new number.
Remarks
This function returns value, which is value1 with a field of bits overwritten,
starting at the given index position. The index specifies the position of the least
significant bit of the given field. The width bits starting at the given index will be set
to the value given by fieldvalue. The least significant bit in value1 has an
index of 1 and the most significant bit has an index of 32.
Prior to setting the field of bits, any fractional parts of value1 and fieldvalue will be
truncated to make them integers.
If the fieldvalue is wider than the width, the extra most significant bits of the
fieldvalue will be truncated. For example, assume the width is 4 bits, and the
binary value for fieldwidth is 11110 (5 bits). The most significant bit of
fieldwidth will be truncated, and a binary value of 1110 will be used as the
fieldvalue.
Also see
Logic and bit operations (on page 13-17)
bit.clear() (on page 13-19)
bit.getfield() (on page 13-20)
bit.set() (on page 13-21)
bit.test() (on page 13-22)
bit.toggle() (on page 13-23)
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.100000e+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.