vector

vector Function

Syntax:

vector &rest objects → vector

Arguments and Values:

object—an object.

vector—a vector of type (vector t *).

Description:

Creates a fresh simple general vector whose size corresponds to the number of objects. The vector is initialized to contain the objects.

Examples:

(arrayp (setq v (vector 1 2 ’sirens))) → true 
(vectorp v) → true 
(simple-vector-p v) → true 
(length v) → 3 

See Also:

make-array

Notes:

vector is analogous to list.

(vector a₁ a₂ ... a_n)

≡ (make-array (list n) :element-type t

:initial-contents

(list a₁ a₂ ... a_n))

Expanded Reference: vector

vector creates a fresh simple general vector containing the given objects. It is analogous to list but produces a vector instead of a list.

(vector 1 2 3)
=> #(1 2 3)

(vector 'a 'b 'c 'd)
=> #(A B C D)

;; No arguments produces an empty vector
(vector)
=> #()

Since vector creates a general vector (element-type t), it can hold any mix of objects.

(vector 1 "hello" 'foo #\a 3.14)
=> #(1 "hello" FOO #\a 3.14)

(vector '(1 2) #(3 4) "five")
=> #((1 2) #(3 4) "five")

The vector returned by vector is always a simple-vector (no fill pointer, not adjustable, not displaced).

(simple-vector-p (vector 1 2 3))
=> T

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

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

(vector a b c) is equivalent to (make-array 3 :initial-contents (list a b c)).

(let ((v1 (vector 10 20 30))
      (v2 (make-array 3 :initial-contents '(10 20 30))))
  (equalp v1 v2))
=> T