Skip to main content

vectorp

vectorp Function

Syntax:

vectorp object → generalized-boolean

Arguments and Values:

object—an object.

generalized-boolean—a generalized boolean.

Description:

Returns true if object is of type vector; otherwise, returns false.

Examples:

(vectorp "aaaaaa") → true 
(vectorp (make-array 6 :fill-pointer t)) → true 
(vectorp (make-array ’(2 3 4))) → false 
(vectorp #\*11) → true 
(vectorp #b11) → false

Notes:

(vectorp object) ≡ (typep object ’vector)

Expanded Reference: vectorp​

Basic Usage​

vectorp returns true if its argument is a vector (a one-dimensional array), false otherwise.

(vectorp (make-array 5))
=> T

(vectorp (vector 1 2 3))
=> T

(vectorp 42)
=> NIL

Strings and Bit Vectors Are Vectors​

Strings and bit vectors are specialized one-dimensional arrays, so they are vectors.

(vectorp "hello")
=> T

(vectorp #*10110)
=> T

Multi-Dimensional Arrays Are Not Vectors​

Only one-dimensional arrays qualify as vectors.

(vectorp (make-array '(2 3)))
=> NIL

(vectorp (make-array '(3 3 3)))
=> NIL

Vectors with Fill Pointers​

Vectors with fill pointers are still vectors.

(vectorp (make-array 10 :fill-pointer 5))
=> T

Equivalence to typep​

(vectorp x) is equivalent to (typep x 'vector).

(let ((v (vector 'a 'b 'c)))
  (eq (vectorp v) (typep v 'vector)))
=> T