GBBopen 1.5 Reference -- delq-one

delq-one

delq-one

item list => list

[Function]

Purpose
Destructively delete the first occurrence of item from list using eq as the comparison function.

Package :gbbopen-tools

Module :gbbopen-tools

Arguments and values

item		An object
list		A proper list

Returns
A list from which the first item element has been deleted.

Description
Delq-one is a convenient and efficient shorthand for:

  (delete item (the list list) :test #'eq :count 1)

As is the case with delete, delq-one may modify the top-level structure of list in constructing the result-list.

Examples

  > (delq-one 'b '(a b c b))
  (a c b)
  > (delq-one 'x '(a b c b))
  (a b c b)
  >

delq-one