pushnew-aconsGBBopen Toolspushnew/incf-aconspushnew-elementsGoTo Top

pushnew-elements   list place &key key test test-not => new-place-value[Macro]

Purpose
Pushes new elements in list onto the list stored in place.

Package   :gbbopen-tools

Module   :gbbopen-tools

Arguments and values

list     A proper list
place     A form which is suitable for use as a generalized reference
key     A function designator specifying a function object of one argument, or nil (default is nil)
test     A function designator specifying a function object of two arguments that returns a generalized boolean (default is #'eql)
test-not     A function designator specifying a function object of two arguments that returns a generalized boolean (use of :test-not is deprecated)
new-place-value     An association list

Returns
The new value of place.

Description
Each element in list is checked to see if it is already present in the proper list stored in place. If the element is not already present, it is prepended to the list stored in place.

Examples

  > (setf x '(1 3 5))
  (1 3 5)
  > (pushnew-elements '(1 2 3) x)
  (2 1 3 5)
  > (pushnew-elements '(3 4 5) x)
  (4 2 1 3 5)
  >


The GBBopen Project


pushnew-aconsGBBopen Toolspushnew/incf-aconspushnew-elementsGoTo Top