CLCS
src report error
Index
byte Numbers Dictionary dpb
Function

deposit-field

deposit-field newbyte bytespec integer ⇒ result-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

See Also

byte; byte-size; byte-position, dpb

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.

Backlinks

Byte Operations on Integers, dpb, Function Call Forms as Places, mask-field, Numbers Dictionary, Symbols in the COMMON-LISP Package