ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   14 Conses   14.2 Dictionary of Conses

14.2.40 get-properties Function

Syntax:
get-properties plist indicator-list    indicator, value, tail

Arguments and Values:
plist - a property list.

indicator-list - a proper list (of indicators).

indicator - an object that is an element of indicator-list.

value - an object.

tail - a list.

Description:
get-properties is used to look up any of several property list entries all at once.

It searches the plist for the first entry whose indicator is identical to one of the objects in indicator-list. If such an entry is found, the indicator and value returned are the property indicator and its associated property value, and the tail returned is the tail of the plist that begins with the found entry (i.e., whose car is the indicator). If no such entry is found, the indicator, value, and tail are all nil.

Examples:
 (setq x '())   NIL
 (setq *indicator-list* '(prop1 prop2))  (PROP1 PROP2)
 (getf x 'prop1)   NIL
 (setf (getf x 'prop1) 'val1)   VAL1
 (eq (getf x 'prop1) 'val1)  true
 (get-properties x *indicator-list*)   PROP1, VAL1, (PROP1 VAL1)
 x  (PROP1 VAL1)

See Also:
get, getf

Allegro CL Implementation Details:
None.

Home Previous Up Next Table of Contents Index
© Franz Inc. All Rights Reserved - File last updated 2022-07-25