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.