acons (ANSI and GNU Common Lisp Document)

Next: assoc, Previous: mapc, Up: Conses Dictionary

#### 14.2.35 acons [Function]

`acons` key datum alist ⇒ new-alist

#### Arguments and Values::

key—an object.

datum—an object.

alist—an association list.

new-alist—an association list.

#### Description::

Creates a fresh cons, the cdr of which is alist and the car of which is another fresh cons, the car of which is key and the cdr of which is datum.

#### Examples::

     (setq alist '()) ⇒  NIL
     (acons 1 "one" alist) ⇒  ((1 . "one"))
     alist ⇒  NIL
     (setq alist (acons 1 "one" (acons 2 "two" alist))) ⇒  ((1 . "one") (2 . "two"))
     (assoc 1 alist) ⇒  (1 . "one")
     (setq alist (acons 1 "uno" alist)) ⇒  ((1 . "uno") (1 . "one") (2 . "two"))
     (assoc 1 alist) ⇒  (1 . "uno")

#### See Also::

assoc , pairlis

#### Notes::

    (acons key datum alist) ≡ (cons (cons key datum) alist)