Models 707B and 708B Switching Matrix Reference Manual
Section 7: Command reference
707B-901-01 Rev. A / August 2010
7-15
bit.setfield()
This function overwrites a bit field at a specified index position.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function No
Usage
result = bit.setfield(value, index, width, fieldValue)
result
Result of the bit manipulation
value
Specified number
index
One-based bit position within
value
to set (
1
to
32
)
width
The number of bits to include in the field (
1
to
32
)
fieldValue
Value to write to the field
Details
This function returns
result
, which is
value
with a field of bits overwritten, starting at
index
. The
index
specifies the position of the least significant bit of
value
. The
width
bits starting at
index
are set to
fieldValue
.
The least significant bit
value
is at
index
position
1
; the most significant bit is at
index
position
32
.
Before setting the field of bits, any fractional parts of
value
and
fieldValue
are truncated to form integers.
If
fieldValue
is wider than
width
, the most significant bits of the
fieldValue
that exceed the width are
truncated. For example, if
width
is
4
bits and the binary value for
fieldValue
is 11110 (5 bits), the most
significant bit of
fieldValue
is truncated and a binary value of 1110 is used.
Example
testResult = bit.setfield(15, 2, 3, 5)
print(testResult)
The binary equivalent of decimal
15
is 1111. After
overwriting it with a decimal
5
(binary 101) at
index
position
2
, the returned
value
is decimal 11 (binary
1011).
Output:
1.101
Also see
(on page 7-13)
(on page 6-22)
