BloombergLP::bslalg::RbTreeUtil::findInsertLocation

Return the insert parent for value, using an optional hint.

Synopsis

Declared in <bslalg_rbtreeutil.h>

template<
    class NODE_VALUE_COMPARATOR,
    class VALUE>
static
RbTreeNode*
findInsertLocation(
    bool* insertAsLeftChildFlag,
    RbTreeAnchor* tree,
    NODE_VALUE_COMPARATOR& comparator,
    VALUE const& value,
    RbTreeNode* hint);

Description

Return the address of the node before which the specified value should be inserted into the specified tree, using the specified hint to improve performance when it is the immediate successor.

Return Value

address of the node that would be the parent of value

Parameters

NameDescription
insertAsLeftChildFlagset to whether value is a left child
treetree in which to locate the insert parent
comparatorfunctor used to order nodes against value
valuevalue whose insert location is returned
hintpossible immediate successor of value in tree