Collection::RemoveAll
Section: ET++ method description (n)
Updated: automatically Fri Mar 1 10:57:30 1991
Index
Return to Main Contents
NAME
Collection::RemoveAll - instance method
TEMPLATE
void RemoveAll(CollPtr elementsToBeRemoved)
SPECIFIERS
public
virtual
DESCRIPTION
Attempts to remove all elements of elementsToBeRemoved from the
receiver.
RemoveAll is based on method Remove. The order of the elements to be
removed is determined by the iterator returned by MakeIterator of
elementsToBeRemoved.
A RemoveAll sends the default change message one time if the size of the
receiver has changed.
See also method AddAll and method FreeAll.
RemoveAll is declared virtual for provision of more efficient
implementations.
Hint: Comparing the receiver's Size before and after a RemoveAll operation
might be interesting in some cases.
Method is rarely overridden.
ARGUMENTS
- CollPtr elementsToBeRemoved
-
A collection whose elements are to be removed from the receiver.
RETURN ARGUMENT
void
CATEGORIES
manipulation, client interface
FIRST DEFINITION
class Collection
FILES
- implementation:
-
Collection.C
KNOWN PROBLEMS
There is no comparable operation that is based on RemovePtr.
It depends on the implementation of Remove, wether change message are sent.
If they do, they do it for each succesful Remove operation. This is neither
correct.
Index
- NAME
-
- TEMPLATE
-
- SPECIFIERS
-
- DESCRIPTION
-
- ARGUMENTS
-
- RETURN ARGUMENT
-
- CATEGORIES
-
- FIRST DEFINITION
-
- FILES
-
- KNOWN PROBLEMS
-
This document was created by
man2html,
using the manual pages.
Time: 00:40:30 GMT, March 30, 2022