...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Intrusive containers have thread safety guarantees similar to STL containers.
Some Intrusive hooks (auto-unlink hooks, for example) modify containers without having a reference to them: this is considered a write access to the container.
Other functions, like checking if an object is already inserted in a container
using the is_linked()
member of safe hooks, constitute read access on the container without having
a reference to it, so no other thread should have write access (direct or indirect)
to that container.
Since the same object can be inserted in several containers at the same time using different hooks, the thread safety of Boost.Intrusive is related to the containers and also to the object whose lifetime is manually managed by the user.
As we can see, the analysis of the thread-safety of a program using Boost.Intrusive is harder than with non-intrusive containers.
To analyze the thread safety, consider the following points:
unlink()
functions modify the container indirectly.
is_linked()
functions are a read access to the container.