User Tools


Macro REMF

remf removes from the property list stored in place a property with a property indicator

identical to indicator. If there are multiple properties with the identical key, remf only removes the first such property.

remf returns false if no such property was found, or true if a property was found.

The property indicator and the corresponding property value are removed in an undefined order by destructively splicing the property list. remf is permitted to either setf place or to setf any part, car or cdr, of the list structure held by that place.

For information about the evaluation of subforms of place, \seesection\GenRefSubFormEval.

Syntax

  • remf place indicatorgeneralized-boolean

Arguments and Values

Examples

(defparameter *x* (cons () ()))

*X*

(setf (getf (car *x*) 'prop1) 'val1)

VAL1

(remf (car *x*) 'prop1)

true

(remf (car *x*) 'prop1)

false

Side Effects

The property list stored in place is modified.

Affected By

None.

Exceptional Situations

None.

See Also

Example Implementation

To be done.

Notes

None.

\issue{PLIST-DUPLICATES:ALLOW} \issue{REMF-DESTRUCTION-UNSPECIFIED:X3J13-MAR-89} \issue{PUSH-EVALUATION-ORDER:FIRST-ITEM}