(rontolisp) docs
← cl Package Functions

delete-if-not

(delete-if-not predicate list &key key start end count from-end)

The destructive counterpart of remove-if-not: returns list keeping only the elements that satisfy predicate, splicing out the rest in place. A vector or string argument has no cons cells to splice, so it comes back as a fresh sequence instead, like remove-if-not. Because the head may change, use the return value rather than the original variable. :start/:end bound the scanned subsequence -- an element outside it is neither tested nor acted on -- :count caps how many matches are acted on, and :from-end reverses the order the elements are visited, so with :count the matches taken are the last ones. A bound outside the sequence -- negative, not an integer, past its length, or a start past its end -- signals a type-error before any element is examined; a nil :end means the length. A :count that is neither an integer nor nil signals a type-error the same way, before the bounds are checked; a negative count acts as zero and nil is no limit.