Tektronix Keithley 2601B-PULSE Reference Manual

Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference
2601B-PULSE-901-01A April 2020 11-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 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.10000e+01
Also see
Bit manipulation and logic operations (on page 9-4)
bit.get() (on page 11-12)
bit.set() (on page 11-14)
bit.getfield() (on page 11-13)

Tektronix Keithley 2601B-PULSE Specifications

General

Brand	Tektronix
Model	Keithley 2601B-PULSE
Category	Measuring Instruments
Language	English