LispWorks CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

remove-items

Generic Function
Summary

Removes some items from a collection.

Package

capi

Signature

remove-items collection list-or-predicate

Arguments

collection

A collection.

list-or-predicate

A list, or a function of one argument returning a boolean value.

Description

The generic function remove-items removes from the collection collection those items determined by list-or-predicate .

If list-or-predicate is list, then the items removed are those matching some element of list-or-predicate , compared by the test-function of collection . Otherwise, the items removed are those for which the function list-or-predicate returns true.

This is logically equivalent to recalculating the collection items and then calling (setf collection-items) . However, remove-items is more efficient and causes less flickering on screen.

remove-items can only be used when the collection has the default items-get-function svref .

See also

append-items
collection
replace-items


LispWorks CAPI Reference Manual - 21 Dec 2009

NextPrevUpTopContentsIndex