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

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.