ssdel (AutoLISP)

Deletes an object (entity) from a selection set

Supported Platforms: Windows and Mac OS

Signature

(ssdel ename ss)
ename

Type: ads_name

An entity name.

ss

Type: ads_name

A selection set.

Return Values

Type: ads_name or nil

The name of the selection set; otherwise nil, if the specified entity is not in the set.

Note that the entity is actually deleted from the existing selection set, as opposed to a new set being returned with the element deleted.

Examples

In the following examples, entity name e1 is a member of selection set ss, while entity name e3 is not a member of ss:

(ssdel e1 ss)
<Selection set: 2>

Selection set ss is returned with entity e1 removed.

(ssdel e3 ss)
nil

The function returns nil because e3 is not a member of selection set ss.