en	= Change Log

en	:idprefix: changes_ :svn-ticket-url: https://svn.boost.org/trac/boost/ticket :github-pr-url: https://github.com/boostorg/unordered/pull :cpp: C++

en	Release 1.89.0

en	Deprecated `boost::unordered::hash_is_avalanching` is now a using-declaration of

en	`boost::hash_is_avalanching` in `<boost/container_hash/hash_is_avalanching.hpp>`. Use that header directly instead. `<boost/unordered/hash_traits.hpp>` will be removed in the future.

en	Added `pull(const_iterator)` to open-addressing containers. This operation

en	allows for efficient removal and retrieval of an element via move construction.

en	Release 1.88.0

en	Migrated the documentation to a multipage format using Antora.

en	Release 1.87.0 - Major update

en	Added concurrent, node-based containers `boost::concurrent_node_map` and `boost::concurrent_node_set`.

en	Added `insert_and_visit(x, f1, f2)` and similar operations to concurrent containers, which

en	allow for visitation of an element right after insertion (by contrast, `insert_or_visit(x, f)` only visits the element if insertion did _not_ take place).

en	Made visitation exclusive-locked within certain

en	`boost::concurrent_flat_set` operations to allow for safe mutable modification of elements ({github-pr-url}/265[PR#265^]).

en	In Visual Studio Natvis, supported any container with an allocator that uses fancy pointers. This applies to any fancy pointer type, as long as the proper Natvis customization point "Intrinsic" functions are written for the fancy pointer type.

en	Added GDB pretty-printers for all containers and iterators. For a container with an allocator that uses fancy pointers, these only work if the proper pretty-printer is written for the fancy pointer type itself.

en	Fixed `std::initializer_list` assignment issues for open-addressing containers

en	({github-pr-url}/277[PR#277^]).

en	Allowed non-copyable callables to be passed to the `std::initializer_list` overloads of `insert_{and|or}_[c]visit` for concurrent containers, by internally passing a `std::reference_wrapper` of the callable to the iterator-pair overloads.

en	Release 1.86.0

en	Added container `pmr` aliases when header `<memory_resource>` is available. The alias `boost::unordered::pmr::[container]` refers to `boost::unordered::[container]` with a `std::pmr::polymorphic_allocator` allocator type.

en	Equipped open-addressing and concurrent containers to internally calculate and provide statistical metrics affected by the quality of the hash function. This functionality is enabled by the global macro `BOOST_UNORDERED_ENABLE_STATS`.

en	Avalanching hash functions must now be marked via an `is_avalanching` typedef with an embedded `value` constant set to `true` (typically, defining `is_avalanching` as `std::true_type`). `using is_avalanching = void` is deprecated but allowed for backwards compatibility.

en	Added Visual Studio Natvis framework custom visualizations for containers and iterators. This works for all containers with an allocator using raw pointers. In this release, containers and iterators are not supported if their allocator uses fancy pointers. This may be addressed in later releases.

en	Release 1.85.0

en	Optimized `emplace()` for a `value_type` or `init_type` (if applicable) argument to bypass creating an intermediate object. The argument is already the same type as the would-be intermediate object.

en	Optimized `emplace()` for `k,v` arguments on map containers to delay constructing the object until it is certain that an element should be inserted. This optimization happens when the map's `key_type` is move constructible or when the `k` argument is a `key_type`.

en	Fixed support for allocators with `explicit` copy constructors ({github-pr-url}/234[PR#234^]).

en	Fixed bug in the `const` version of `unordered_multimap::find(k, hash, eq)` ({github-pr-url}/238[PR#238^]).

en	Release 1.84.0 - Major update

en	Added `boost::concurrent_flat_set`.

en	Added `[c]visit_while` operations to concurrent containers,

en	with serial and parallel variants.

en	Added efficient move construction of `boost::unordered_flat_(map|set)` from

en	`boost::concurrent_flat_(map|set)` and vice versa.

en	Added bulk visitation to concurrent containers for increased lookup performance.

en	Added debug-mode mechanisms for detecting illegal reentrancies into

en	a concurrent container from user code.

en	Added Boost.Serialization support to all containers and their (non-local) iterator types.

en	Added support for fancy pointers to open-addressing and concurrent containers.

en	This enables scenarios like the use of Boost.Interprocess allocators to construct containers in shared memory.

en	Fixed bug in member of pointer operator for local iterators of closed-addressing

en	containers ({github-pr-url}/221[PR#221^], credit goes to GitHub user vslashg for finding and fixing this issue).

en	Starting with this release, `boost::unordered_[multi]set` and `boost::unordered_[multi]map`

en	only work with C++11 onwards.

en	Release 1.83.0 - Major update

en	Added `boost::concurrent_flat_map`, a fast, thread-safe hashmap based on open addressing.

en	Sped up iteration of open-addressing containers.

en	In open-addressing containers, `erase(iterator)`, which previously returned nothing, now

en	returns a proxy object convertible to an iterator to the next element. This enables the typical `it = c.erase(it)` idiom without incurring any performance penalty when the returned proxy is not used.

en	Release 1.82.0 - Major update

en	{cpp}03 support is planned for deprecation. Boost 1.84.0 will no longer support

en	{cpp}03 mode and {cpp}11 will become the new minimum for using the library.

en	Added node-based, open-addressing containers

en	`boost::unordered_node_map` and `boost::unordered_node_set`.

en	Extended heterogeneous lookup to more member functions as specified in

en	https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2363r5.html[P2363].

en	Replaced the previous post-mixing process for open-addressing containers with

en	a new algorithm based on extended multiplication by a constant.

en	Fixed bug in internal emplace() impl where stack-local types were not properly

en	constructed using the Allocator of the container which breaks uses-allocator construction.

en	Release 1.81.0 - Major update

en	Added fast containers `boost::unordered_flat_map` and `boost::unordered_flat_set`

en	based on open addressing.

en	Added CTAD deduction guides for all containers.

en	Added missing constructors as specified in https://cplusplus.github.io/LWG/issue2713[LWG issue 2713].

en	Release 1.80.0 - Major update

en	Refactor internal implementation to be dramatically faster

en	Allow `final` Hasher and KeyEqual objects

en	Update documentation, adding benchmark graphs and notes on the new internal

en	data structures

en	Release 1.79.0

en	Improved {cpp}20 support:

en	** All containers have been updated to support heterogeneous `count`, `equal_range` and `find`. ** All containers now implement the member function `contains`. ** `erase_if` has been implemented for all containers.

en	Improved {cpp}23 support:

en	** All containers have been updated to support heterogeneous `erase` and `extract`.

en	Changed behavior of `reserve` to eagerly

en	allocate ({github-pr-url}/59[PR#59^]).

en	Various warning fixes in the test suite.

en	Update code to internally use `boost::allocator_traits`.

en	Switch to Fibonacci hashing.

en	Update documentation to be written in AsciiDoc instead of QuickBook.

en	Release 1.67.0

en	Improved {cpp}17 support:

en	** Add template deduction guides from the standard. ** Use a simple implementation of `optional` in node handles, so that they're closer to the standard. ** Add missing `noexcept` specifications to `swap`, `operator=` and node handles, and change the implementation to match. Using `std::allocator_traits::is_always_equal`, or our own implementation when not available, and `boost::is_nothrow_swappable` in the implementation.

en	Improved {cpp}20 support:

en	** Use `boost::to_address`, which has the proposed {cpp}20 semantics, rather than the old custom implementation.

en	Add `element_type` to iterators, so that `std::pointer_traits`

en	will work.

en	Use `std::piecewise_construct` on recent versions of Visual {cpp},

en	and other uses of the Dinkumware standard library, now using Boost.Predef to check compiler and library versions.

en	Use `std::iterator_traits` rather than the boost iterator traits

en	in order to remove dependency on Boost.Iterator.

en	Remove iterators' inheritance from `std::iterator`, which is

en	deprecated in {cpp}17, thanks to Daniela Engert ({github-pr-url}/7[PR#7^]).

en	Stop using `BOOST_DEDUCED_TYPENAME`.

en	Update some Boost include paths.

en	Rename some internal methods, and variables.

en	Various testing improvements.

en	Miscellaneous internal changes.

en	Release 1.66.0

en	Simpler move construction implementation.

en	Documentation fixes ({github-pr-url}/6[GitHub #6^]).

en	Release 1.65.0

en	Add deprecated attributes to `quick_erase` and `erase_return_void`.

en	I really will remove them in a future version this time.

en	Small standards compliance fixes:

en	** `noexpect` specs for `swap` free functions. ** Add missing `insert(P&&)` methods.

en	Release 1.64.0

en	Initial support for new {cpp}17 member functions:

en	`insert_or_assign` and `try_emplace` in `unordered_map`,

en	Initial support for `merge` and `extract`.

en	Does not include transferring nodes between `unordered_map` and `unordered_multimap` or between `unordered_set` and `unordered_multiset` yet. That will hopefully be in the next version of Boost.

en	Release 1.63.0

en	Check hint iterator in `insert`/`emplace_hint`.

en	Fix some warnings, mostly in the tests.

en	Manually write out `emplace_args` for small numbers of arguments -

en	should make template error messages a little more bearable.

en	Remove superfluous use of `boost::forward` in emplace arguments,

en	which fixes emplacing string literals in old versions of Visual {cpp}.

en	Fix an exception safety issue in assignment. If bucket allocation

en	throws an exception, it can overwrite the hash and equality functions while leaving the existing elements in place. This would mean that the function objects wouldn't match the container elements, so elements might be in the wrong bucket and equivalent elements would be incorrectly handled.

en	Various reference documentation improvements.

en	Better allocator support ({svn-ticket-url}/12459[#12459^]).

en	Make the no argument constructors implicit.

en	Implement missing allocator aware constructors.

en	Fix assigning the hash/key equality functions for empty containers.

en	Remove unary/binary_function from the examples in the documentation.

en	They are removed in {cpp}17.

en	Support 10 constructor arguments in emplace. It was meant to support up to 10

en	arguments, but an off by one error in the preprocessor code meant it only supported up to 9.

en	Release 1.62.0

en	Remove use of deprecated `boost::iterator`.

en	Remove `BOOST_NO_STD_DISTANCE` workaround.

en	Remove `BOOST_UNORDERED_DEPRECATED_EQUALITY` warning.

en	Simpler implementation of assignment, fixes an exception safety issue

en	for `unordered_multiset` and `unordered_multimap`. Might be a little slower.

en	Stop using return value SFINAE which some older compilers have issues

en	with.

en	Release 1.58.0

en	Remove unnecessary template parameter from const iterators.

en	Rename private `iterator` typedef in some iterator classes, as it

en	confuses some traits classes.

en	Fix move assignment with stateful, propagate_on_container_move_assign

en	allocators ({svn-ticket-url}/10777[#10777^]).

en	Fix rare exception safety issue in move assignment.

en	Fix potential overflow when calculating number of buckets to allocate

en	({github-pr-url}/4[GitHub #4^]).

en	Release 1.57.0

en	Fix the `pointer` typedef in iterators ({svn-ticket-url}/10672[#10672^]).

en	Fix Coverity warning

en	({github-pr-url}/2[GitHub #2^]).

en	Release 1.56.0

en	Fix some shadowed variable warnings ({svn-ticket-url}/9377[#9377^]).

en	Fix allocator use in documentation ({svn-ticket-url}/9719[#9719^]).

en	Always use prime number of buckets for integers. Fixes performance

en	regression when inserting consecutive integers, although makes other uses slower ({svn-ticket-url}/9282[#9282^]).

en	Only construct elements using allocators, as specified in {cpp}11 standard.

en	Release 1.55.0

en	Avoid some warnings ({svn-ticket-url}/8851[#8851^], {svn-ticket-url}/8874[#8874^]).

en	Avoid exposing some detail functions via. ADL on the iterators.

en	Follow the standard by only using the allocators' construct and destroy

en	methods to construct and destroy stored elements. Don't use them for internal data like pointers.

en	Release 1.54.0

en	Mark methods specified in standard as `noexpect`. More to come in the next

en	release.

en	If the hash function and equality predicate are known to both have nothrow

en	move assignment or construction then use them.

en	Release 1.53.0

en	Remove support for the old pre-standard variadic pair constructors, and

en	equality implementation. Both have been deprecated since Boost 1.48.

en	Remove use of deprecated config macros.

en	More internal implementation changes, including a much simpler

en	implementation of `erase`.

en	Release 1.52.0

en	Faster assign, which assigns to existing nodes where possible, rather than

en	creating entirely new nodes and copy constructing.

en	Fixed bug in `erase_range` ({svn-ticket-url}/7471[#7471^]).

en	Reverted some of the internal changes to how nodes are created, especially

en	for {cpp}11 compilers. 'construct' and 'destroy' should work a little better for {cpp}11 allocators.

en	Simplified the implementation a bit. Hopefully more robust.

en	Release 1.51.0

en	Fix construction/destruction issue when using a {cpp}11 compiler with a

en	{cpp}03 allocator ({svn-ticket-url}/7100[#7100^]).

en	Remove a `try..catch` to support compiling without exceptions.

en	Adjust SFINAE use to try to support g++ 3.4 ({svn-ticket-url}/7175[#7175^]).

en	Updated to use the new config macros.

en	Release 1.50.0

en	Fix equality for `unordered_multiset` and `unordered_multimap`.

en	{svn-ticket-url}/6857[Ticket 6857^]:

en	Implement `reserve`.

en	{svn-ticket-url}/6771[Ticket 6771^]:

en	Avoid gcc's `-Wfloat-equal` warning.

en	{svn-ticket-url}/6784[Ticket 6784^]:

en	Fix some Sun specific code.

en	{svn-ticket-url}/6190[Ticket 6190^]:

en	Avoid gcc's `-Wshadow` warning.

en	{svn-ticket-url}/6905[Ticket 6905^]:

en	Make namespaces in macros compatible with `bcp` custom namespaces. Fixed by Luke Elliott.

en	Remove some of the smaller prime number of buckets, as they may make

en	collisions quite probable (e.g. multiples of 5 are very common because we used base 10).

en	On old versions of Visual {cpp}, use the container library's implementation

en	of `allocator_traits`, as it's more likely to work.

en	On machines with 64 bit std::size_t, use power of 2 buckets, with Thomas

en	Wang's hash function to pick which one to use. As modulus is very slow for 64 bit values.

en	Some internal changes.

en	Release 1.49.0

en	Fix warning due to accidental odd assignment.

en	Slightly better error messages.

en	Release 1.48.0 - Major update

en	This is major change which has been converted to use Boost.Move's move emulation, and be more compliant with the {cpp}11 standard. See the xref:compliance.adoc[compliance section] for details.

en	The container now meets {cpp}11's complexity requirements, but to do so uses a little more memory. This means that `quick_erase` and `erase_return_void` are no longer required, they'll be removed in a future version.

en	{cpp}11 support has resulted in some breaking changes:

en	Equality comparison has been changed to the {cpp}11 specification.

en	In a container with equivalent keys, elements in a group with equal keys used to have to be in the same order to be considered equal, now they can be a permutation of each other. To use the old behavior define the macro `BOOST_UNORDERED_DEPRECATED_EQUALITY`.

en	The behaviour of swap is different when the two containers to be

en	swapped has unequal allocators. It used to allocate new nodes using the appropriate allocators, it now swaps the allocators if the allocator has a member structure `propagate_on_container_swap`, such that `propagate_on_container_swap::value` is true.

en	Allocator's `construct` and `destroy` functions are called with raw

en	pointers, rather than the allocator's `pointer` type.

en	`emplace` used to emulate the variadic pair constructors that

en	appeared in early {cpp}0x drafts. Since they were removed it no longer does so. It does emulate the new `piecewise_construct` pair constructors - only you need to use `boost::piecewise_construct`. To use the old emulation of the variadic constructors define `BOOST_UNORDERED_DEPRECATED_PAIR_CONSTRUCT`.

en	Release 1.45.0

en	Fix a bug when inserting into an `unordered_map` or `unordered_set` using

en	iterators which returns `value_type` by copy.

en	Release 1.43.0

en	{svn-ticket-url}/3966[Ticket 3966^]:

en	`erase_return_void` is now `quick_erase`, which is the http://home.roadrunner.com/~hinnant/issue_review/lwg-active.html#579[ current forerunner for resolving the slow erase by iterator^], although there's a strong possibility that this may change in the future. The old method name remains for backwards compatibility but is considered deprecated and will be removed in a future release.

en	Use Boost.Exception.

en	Stop using deprecated `BOOST_HAS_*` macros.

en	Release 1.42.0

en	Support instantiating the containers with incomplete value types.

en	Reduced the number of warnings (mostly in tests).

en	Improved codegear compatibility.

en	{svn-ticket-url}/3693[Ticket 3693^]:

en	Add `erase_return_void` as a temporary workaround for the current `erase` which can be inefficient because it has to find the next element to return an iterator.

en	Add templated find overload for compatible keys.

en	{svn-ticket-url}/3773[Ticket 3773^]:

en	Add missing `std` qualifier to `ptrdiff_t`.

en	Some code formatting changes to fit almost all lines into 80 characters.

en	Release 1.41.0 - Major update

en	The original version made heavy use of macros to sidestep some of the older

en	compilers' poor template support. But since I no longer support those compilers and the macro use was starting to become a maintenance burden it has been rewritten to use templates instead of macros for the implementation classes.

en	The container object is now smaller thanks to using `boost::compressed_pair`

en	for EBO and a slightly different function buffer - now using a bool instead of a member pointer.

en	Buckets are allocated lazily which means that constructing an empty container

en	will not allocate any memory.

en	Release 1.40.0

en	{svn-ticket-url}/2975[Ticket 2975^]:

en	Store the prime list as a preprocessor sequence - so that it will always get the length right if it changes again in the future.

en	{svn-ticket-url}/1978[Ticket 1978^]:

en	Implement `emplace` for all compilers.

en	{svn-ticket-url}/2908[Ticket 2908^],

en	{svn-ticket-url}/3096[Ticket 3096^]: Some workarounds for old versions of borland, including adding explicit destructors to all containers.

en	{svn-ticket-url}/3082[Ticket 3082^]:

en	Disable incorrect Visual {cpp} warnings.

en	Better configuration for {cpp}0x features when the headers aren't available.

en	Create less buckets by default.

en	Release 1.39.0

en	{svn-ticket-url}/2756[Ticket 2756^]: Avoid a warning

en	on Visual {cpp} 2009.

en	Some other minor internal changes to the implementation, tests and

en	documentation.

en	Avoid an unnecessary copy in `operator[]`.

en	{svn-ticket-url}/2975[Ticket 2975^]: Fix length of

en	prime number list.

en	Release 1.38.0

en	Use link:../../../../core/swap.html[`boost::swap`^].

en	{svn-ticket-url}/2237[Ticket 2237^]:

en	Document that the equality and inequality operators are undefined for two objects if their equality predicates aren't equivalent. Thanks to Daniel Krügler.

en	{svn-ticket-url}/1710[Ticket 1710^]:

en	Use a larger prime number list. Thanks to Thorsten Ottosen and Hervé Brönnimann.

en	Use

en	link:../../../../type_traits/index.html[aligned storage^] to store the types. This changes the way the allocator is used to construct nodes. It used to construct the node with two calls to the allocator's `construct` method - once for the pointers and once for the value. It now constructs the node with a single call to construct and then constructs the value using in place construction.

en	Add support for {cpp}0x initializer lists where they're available (currently

en	only g++ 4.4 in {cpp}0x mode).

en	Release 1.37.0

en	Rename overload of `emplace` with hint, to `emplace_hint` as specified in

en	http://www.open-std.org/JTC1/SC22/WG21/docs/papers/2008/n2691.pdf[n2691^].

en	Provide forwarding headers at `<boost/unordered/unordered_map_fwd.hpp>` and

en	`<boost/unordered/unordered_set_fwd.hpp>`.

en	Move all the implementation inside `boost/unordered`, to assist

en	modularization and hopefully make it easier to track Release subversion.

en	Release 1.36.0

en	First official release.

en	Rearrange the internals.

en	Move semantics - full support when rvalue references are available, emulated

en	using a cut down version of the Adobe move library when they are not.

en	Emplace support when rvalue references and variadic template are available.

en	More efficient node allocation when rvalue references and variadic template

en	are available.

en	Added equality operators.

en	Boost 1.35.0 Add-on - 31st March 2008

en	Unofficial release uploaded to vault, to be used with Boost 1.35.0. Incorporated many of the suggestions from the review.

en	Improved portability thanks to Boost regression testing.

en	Fix lots of typos, and clearer text in the documentation.

en	Fix floating point to `std::size_t` conversion when calculating sizes from

en	the max load factor, and use `double` in the calculation for greater accuracy.

en	Fix some errors in the examples.

en	Review Version

en	Initial review version, for the review conducted from 7th December 2007 to 16th December 2007.