REMOVE

[FUNCTION]


OM 6.1
Function Reference
ARGUMENTS:
  - item    
  - sequence    
&key
 
  - from-end    
  - test   [default = (quote eql)]
  - test-not    
  - start   [default = 0]
  - end    
  - count    
  - key    

Description:

Returns a new sequence that has the same elements as <sequence> except those that satisfy the test <test> with <item>.
By default the test is 'eql so the items that are equal to <item> are removed.

<test> can be a function or a function name.
<start> and <end> determine bounding indices in the original sequence for removing elements.
<count> allows to specify a maximal number of items to remove.
<from-end> if T, starts removing items from end of the sequence
<key> is a function applyed to each item before to be tested
<test-not> is used to remove elemet that do not satistfy the test (deprecated use)

Ex. (remove 5 '(2 5 6 7 5 3)) ==> (2 6 7 3)
Ex. (remove 5 '(2 5 6 7 5 3) :test '>) ==> (2 3)
Ex. (remove 5 '((b 2) (c 5) (d 6) (e 7) (f 5) (g 3))) :key 'second) ==> ((b 2) (d 6) (e 7) (g 3))