CLCS
Function

deposit-field

deposit-field newbyte bytespec integerresult-integer

Arguments and Values

newbytean integer.
bytespeca byte specifier.
integeran integer.
result-integeran integer.

Description

Replaces a field of bits within integer; specifically, returns an integer that contains the bits of newbyte within the byte specified by bytespec, and elsewhere contains the bits of integer.

Examples

 (deposit-field 7 (byte 2 1) 0) ⇒  6
 (deposit-field -1 (byte 4 0) 0) ⇒  15
 (deposit-field 0 (byte 2 1) -3) ⇒  -7

Notes

 (logbitp j (deposit-field m (byte s p) n))
 ≡ (if (and (>= j p) (< j (+ p s)))
        (logbitp j m)
        (logbitp j n))

deposit-field is to mask-field as dpb is to ldb.