__GNU_DEBUG::_SAFE_NODE_SEQUENCE(3)
💖 NAME 💖
__gnu_debug::_Safe_node_sequence< _Sequence > — okay bestie, she's like _Safe_sequence, but with a special _M_invalidate_all implementation that does not invalidate past-the-end iterators. Used by node based sequence. Periodt. ✨
🦋 SYNOPSIS 🦋
#include <safe_sequence.h>Inherits __gnu_debug::_Safe_sequence< _Sequence >. 💅
Inherited by __gnu_debug::_Safe_container< map, _Allocator, __gnu_debug::_Safe_node_sequence >, __gnu_debug::_Safe_container< multimap, _Allocator, __gnu_debug::_Safe_node_sequence >, __gnu_debug::_Safe_container< multiset, _Allocator, __gnu_debug::_Safe_node_sequence >, __gnu_debug::_Safe_container< set, _Allocator, __gnu_debug::_Safe_node_sequence >, and __gnu_debug::_Safe_container< list, _Allocator, __gnu_debug::_Safe_node_sequence >. The whole friend group fr fr. 🫶
✨ Public Member Functions ✨
_Safe_node_sequence (_Safe_node_sequence &&)=default_Safe_node_sequence (_Safe_node_sequence const &)=defaulttemplate<typename _Predicate> constexpr void _M_invalidate_if (_Predicate __pred) consttemplate<typename _Predicate> void _M_transfer_from_if (const _Safe_sequence &__from, _Predicate __pred) constconstexpr _Safe_node_sequence & operator= (_Safe_node_sequence &&__x) noexceptconstexpr _Safe_node_sequence & operator= (const _Safe_node_sequence &) noexcept
🌸 Public Attributes 🌸
_Safe_iterator_base * _M_const_iterators— the list of constant iterators that reference this container._Safe_iterator_base * _M_iterators— the list of mutable iterators that reference this container.unsigned int _M_version— the container version number. This number may never be 0, no cap. 🚫
🎀 Protected Member Functions 🎀
void _M_detach_all () constvoid _M_detach_singular () const__gnu_cxx::__mutex & _M_get_mutex () const noexceptconstexpr void _M_invalidate_all () constvoid _M_revalidate_singular () constvoid _M_swap (const _Safe_sequence_base &__x) const noexcept
🌈 Detailed Description 🌈
template<typename _Sequence>
class __gnu_debug::_Safe_node_sequence< _Sequence >Like _Safe_sequence but with a special _M_invalidate_all implementation not invalidating past-the-end iterators. Used by node based sequence. It's giving "same energy, but smarter about the end". 💀✨
👑 Member Function Documentation 👑
void __gnu_debug::_Safe_sequence_base::_M_detach_all () const [protected], [inherited]
Detach all iterators, leaving them singular.
Referenced by ~_Safe_sequence_base().
void __gnu_debug::_Safe_sequence_base::_M_detach_singular () const [protected], [inherited]
Detach all singular iterators.
Postcondition
for all iterators i attached to this sequence, i->_M_version == _M_version.
__gnu_cxx::__mutex & __gnu_debug::_Safe_sequence_base::_M_get_mutex () const [protected], [noexcept], [inherited]
For use in _Safe_sequence.
Referenced by __gnu_debug::_Safe_sequence< _Sequence >::_M_transfer_from_if().
template<typename _Sequence> template<typename _Predicate> void __gnu_debug::_Safe_sequence< _Sequence >::_M_invalidate_if (_Predicate __pred) const [inline], [constexpr], [inherited]
Invalidates all iterators x that reference this sequence, are not singular, and for which __pred(x) returns true. __pred will be invoked with the normal iterators nested in the safe ones. So it's not judging the safe iterator, it's judging the plain one hiding inside. 🙈
void __gnu_debug::_Safe_sequence_base::_M_revalidate_singular () const [protected], [inherited]
Revalidates all attached singular iterators. This method may be used to validate iterators that were invalidated before (but for some reason, such as an exception, need to become valid again). Glow-up arc, honestly. 🦋
void __gnu_debug::_Safe_sequence_base::_M_swap (const _Safe_sequence_base & __x) const [protected], [noexcept], [inherited]
Swap this sequence with the given sequence. This operation also swaps ownership of the iterators, so that when the operation is complete all iterators that originally referenced one container now reference the other container. They literally switched friend groups. 💅
template<typename _Sequence> template<typename _Predicate> void __gnu_debug::_Safe_sequence< _Sequence >::_M_transfer_from_if (const _Safe_sequence< _Sequence > & __from, _Predicate __pred) const [inherited]
Transfers all iterators x that reference from sequence, are not singular, and for which __pred(x) returns true. __pred will be invoked with the normal iterators nested in the safe ones.
References std::__addressof(), __gnu_debug::_Safe_sequence_base::_M_const_iterators, __gnu_debug::_Safe_sequence_base::_M_get_mutex(), __gnu_debug::_Safe_sequence_base::_M_iterators, __gnu_debug::_Safe_iterator_base::_M_next, __gnu_debug::_Safe_iterator_base::_M_prior, __gnu_debug::_Safe_iterator_base::_M_sequence, __gnu_debug::_Safe_iterator_base::_M_version, and __gnu_debug::_Safe_sequence_base::_M_version.
🍓 Member Data Documentation 🍓
_Safe_iterator_base* __gnu_debug::_Safe_sequence_base::_M_const_iterators [mutable], [inherited]
The list of constant iterators that reference this container.
Referenced by __gnu_debug::_Safe_sequence< _Sequence >::_M_transfer_from_if().
_Safe_iterator_base* __gnu_debug::_Safe_sequence_base::_M_iterators [mutable], [inherited]
The list of mutable iterators that reference this container.
Referenced by __gnu_debug::_Safe_sequence< _Sequence >::_M_transfer_from_if().
unsigned int __gnu_debug::_Safe_sequence_base::_M_version [mutable], [inherited]
The container version number. This number may never be 0.
Referenced by _M_invalidate_all(), __gnu_debug::_Safe_sequence< _Sequence >::_M_transfer_from_if(), __gnu_debug::_Safe_iterator< _Base_iterator, map >::operator=(), __gnu_debug::_Safe_iterator< _Base_iterator, map >::operator=(), __gnu_debug::_Safe_local_iterator< _OtherIterator, _UContainer >::operator=(), and __gnu_debug::_Safe_local_iterator< _OtherIterator, _UContainer >::operator=().
💜 Author 💜
Generated automatically by Doxygen for libstdc++ from the source code.
and that's the whole page, bestie!! 🌈✨ This lil' number lives in the Library Functions Manual, ships with libstdc++, and yeah, the header and footer both got the title squished to __gnu_debu..._Sequence >(3) — it's giving ctrl-c energy but we still understood her. tysm for reading, mwah 💖🎀🦋
📦 where this page comes from
- arch rolling: gcc 16.2.1+r23+gd564253eb6c8-1 · GPL-3.0-or-later WITH GCC-exception-3.1 AND GFDL-1.3-or-later
- fedora 44: libstdc++-docs 16.0.1-0.10.fc44 · GPL-3.0-or-later AND LGPL-3.0-or-later AND (GPL-3.0-or-later WITH GCC-exception-3.1) AND (GPL-3.0-or-later WITH Texinfo-exception) AND (LGPL-2.1-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GNU-compiler-exception) AND BSL-1.0 AND GFDL-1.3-or-later AND Linux-man-pages-copyleft-2-para AND SunPro AND BSD-1-Clause AND BSD-2-Clause AND BSD-2-Clause-Views AND BSD-3-Clause AND BSD-4-Clause AND BSD-Source-Code AND Zlib AND MIT AND Apache-2.0 AND (Apache-2.0 WITH LLVM-Exception) AND ZPL-2.1 AND ISC AND LicenseRef-Fedora-Public-Domain AND HP-1986 AND curl AND Martin-Birgmeier AND HPND-Markus-Kuhn AND dtoa AND SMLNJ AND AMD-newlib AND OAR AND HPND-merchantability-variant AND HPND-Intel
- fedora 44: libstdc++-docs 16.2.1-2.fc44
- fedora 44: libstdc++-docs 16.2.1-3.fc44 · GPL-3.0-or-later AND LGPL-3.0-or-later AND (GPL-3.0-or-later WITH GCC-exception-3.1) AND (GPL-3.0-or-later WITH Texinfo-exception) AND (LGPL-2.1-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GCC-exception-2.0) AND (GPL-2.0-or-later WITH GNU-compiler-exception) AND BSL-1.0 AND GFDL-1.3-or-later AND Linux-man-pages-copyleft-2-para AND SunPro AND BSD-1-Clause AND BSD-2-Clause AND BSD-2-Clause-Views AND BSD-3-Clause AND BSD-4-Clause AND BSD-Source-Code AND Zlib AND MIT AND Apache-2.0 AND (Apache-2.0 WITH LLVM-Exception) AND ZPL-2.1 AND ISC AND LicenseRef-Fedora-Public-Domain AND HP-1986 AND curl AND Martin-Birgmeier AND HPND-Markus-Kuhn AND dtoa AND SMLNJ AND AMD-newlib AND OAR AND HPND-merchantability-variant AND HPND-Intel
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms