Keithley 2651A Reference Manual

Section 7: Command reference Model 2651A High Power System SourceMeter® Instrument Reference Manual
7-14 2651A-901-01 Rev. A / March 2011
Also see
bit.clear() (on page 7-11)
bit.get()
(on page 7-11)
bit.getfield()
(on page 7-12)
bit.setfield()
(on page 7-14)
bit.test() (on page 7-15)
bit.toggle()
(on page 7-15)
Logical operators
(on page 6-22)
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 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

Keithley 2651A Specifications

General

Brand	Keithley
Model	2651A
Category	Measuring Instruments
Language	English