Accessor svref

Syntax:

svref simple-vector index element

(setf (svref simple-vector index) new-element)

Arguments and Values:

simple-vector—a simple vector.

index—a valid array index for the simple-vector.

element, new-element—an object (whose type is a subtype of the array element type of the simple-vector).

Description:

17.2.0 7Accesses the element of simple-vector specified by index.

Implied by use of "Access". -kmp 15-Jan-92 17.2.0 7 \macref{setf} may be used with \funref{svref} to destructively replace a \term{simple vector} element with a new value.

Examples:

 (simple-vector-p (setq v (vector 1 2 'sirens))) → true
 (svref v 0) → 1
 (svref v 2) → SIRENS
 (setf (svref v 1) 'newcomer) → NEWCOMER               
 v → #(1 NEWCOMER SIRENS)

Side Effects:

None.

Affected By:

None.

Exceptional Situations:

None.

See Also:

aref, sbit, schar, vector, Section 3.2.1 (Compiler Terminology)

Notes:

17.2.0 8svref is identical to aref except that it requires its first argument to be a simple vector.

 (svref v i) ≡ (aref (the simple-vector v) i)