Keithley 2657A, Reference Manual, Page: 327 / 805

Section 7: TSP command reference Model 2657A High Power System SourceMeter® Instrument Reference Manual
7-14 2657A-901-01 Rev. B/December 2012
Usage
result
= bit.setfield(
value
,
index
,
width
,
fieldValue
)
result
Result of the bit manipulation
value
Specified number
index
One-based bit position in
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 of
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.01
Also see
Bit manipulation and logic operations (on page 5-3)
bit.get() (on page 7-11)
bit.set()
(on page 7-13)
bit.getfield() (on page 7-12)
bit.test()
This function returns the Boolean value (
true
or
false
) of a bit at the specified index position.
Type TSP-Link accessible Affected by Where saved Default value
Function No
Usage
result
= bit.test(
value
,
index
)
result
Result of the bit manipulation
value
Specified number
index
One-based bit position within value to test (1 to 32)