TakeOut

Module: ecereCOM
Namespace: ecere::com
Class: Container

bool TakeOut(const d)

Description

Remove an item from a Container by value (implies a Find and is slower than removing from Iterator). The element is not freed.

Parameters

d  const   Value of element which should be taken out.  
 
Return Value bool 

Remarks


Beware of using TakeOut() with 'class' data types and 'class_no_expansion' not set, as OnCompare() may resolve two different instances as equivalent.

Even in containers where values are not guaranteed to be unique, only a single element will be taken out per call.