Skip to main content

fill-pointer

fill-pointer Accessor

Syntax:

fill-pointer vector → fill-pointer

(setf (fill-pointer vector) new-fill-pointer**)**

Arguments and Values:

vector—a vector with a fill pointer .

fill-pointer, new-fill-pointer—a valid fill pointer for the vector.

Description:

Accesses the fill pointer of vector.

Examples:

(setq a (make-array 8 :fill-pointer 4)) → #(NIL NIL NIL NIL) 
(fill-pointer a) → 4 
(dotimes (i (length a)) (setf (aref a i) (\* i i))) → NIL 
a → #(0 1 4 9) 
(setf (fill-pointer a) 3) → 3 
(fill-pointer a) → 3 
a → #(0 1 4) 
(setf (fill-pointer a) 8) → 8 
a → #(0 1 4 9 NIL NIL NIL NIL)

Exceptional Situations:

Should signal an error of type type-error if vector is not a vector with a fill pointer .

See Also:

make-array, length

Notes:

There is no operator that will remove a vector ’s fill pointer .

Expanded Reference: fill-pointer​

tip

TODO: Please contribute to this page by adding explanations and examples

(fill-pointer )