|  | ANSI Common Lisp  15 Arrays  15.2 Dictionary of Arrays 
 
| 15.2.21  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.
Allegro CL Implementation Details:
 None. |