Function byte, byte-size, byte-position

Syntax:

Arguments and Values:

12.8.0 2

size, position—a non-negative integer.

bytespec—a byte specifier.

Description:

12.8.0 3 12.8.0 2byte returns a byte specifier that indicates a byte of width size and whose bits have weights $2^{\mathrm{position}+\mathrm{size}-1}$ through $2^{\mathrm{position}}$, and whose representation is implementation-dependent.

byte-size returns the number of bits specified by bytespec.

byte-position returns the position specified by bytespec.

Examples:

 (setq b (byte 100 200)) → #<BYTE-SPECIFIER size 100 position 200>
 (byte-size b) → 100
 (byte-position b) → 200

Affected By:

None.

Exceptional Situations:

None.

See Also:

ldb, dpb

Notes:

 (byte-size (byte j k)) ≡ j
 (byte-position (byte j k)) ≡ k

A byte of size of 0 is permissible; it refers to a byte of width zero. For example,

 (ldb (byte 0 3) #o7777) → 0
 (dpb #o7777 (byte 0 3) 0) → 0