rplaca (ANSI and GNU Common Lisp Document)

Next: car, Previous: atom, Up: Conses Dictionary

#### 14.2.8 rplaca, rplacd [Function]

`rplaca` cons object ⇒ cons

`rplacd` cons object ⇒ cons

#### Pronunciation::

rplaca: pronounced ,r\=e ’plak e or pronounced ,re ’plak e

rplacd: pronounced ,r\=e ’plak de or pronounced ,re ’plak de or pronounced ,r\=e ’plak d\=e or pronounced ,re ’plak d\=e

#### Arguments and Values::

cons—a cons.

object—an object.

#### Description::

rplaca replaces the car of the cons with object.

rplacd replaces the cdr of the cons with object.

#### Examples::

     (defparameter *some-list* (list* 'one 'two 'three 'four)) ⇒  *some-list*
     *some-list* ⇒  (ONE TWO THREE . FOUR)
     (rplaca *some-list* 'uno) ⇒  (UNO TWO THREE . FOUR)
     *some-list* ⇒  (UNO TWO THREE . FOUR)
     (rplacd (last *some-list*) (list 'IV)) ⇒  (THREE IV)
     *some-list* ⇒  (UNO TWO THREE IV)

#### Side Effects::

The cons is modified.

Should signal an error of type type-error if cons is not a cons.