boost::gil::histogram::emplace_hint

Attempts to build and insert a std::pair into the %unordered_map.

Synopsis

Declared in <boost/gil/histogram.hpp>

template<typename... _Args>
iterator
emplace_hint(
    const_iterator __pos,
    _Args&&... __args);

Description

This function is not concerned about whether the insertion took place, and thus does not return a boolean like the single‐argument emplace() does. Note that the first parameter is only a hint and can potentially improve the performance of the insertion process. A bad hint would cause no gains in efficiency.

See https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints for more on hinting.

Insertion requires amortized constant time.

Return Value

An iterator that points to the element with key of the std::pair built from __args (may or may not be that std::pair).

Parameters

Name

Description

__pos

An iterator that serves as a hint as to where the pair should be inserted.

__args

Arguments used to generate a new pair instance (see std::piecewise_contruct for passing arguments to each part of the pair constructor).

Created with MrDocs