GBBopen 1.5 Reference -- pushnew-elements

pushnew-elements

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 of one argument, or `nil` (default is `nil`)
test		A function of two arguments that returns a generalized boolean (default is `#'eql`)
test-not		A function 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-elements