__GNU_DEBUG::_SAFE_FORWARD_LIST(3cxx)

📦
version 14-20240412 · 15 versions
, in ubuntu noble

💅 NAME 💅

__gnu_debug::_Safe_forward_list< _SafeSequence > — okay bestie, this is the 3cxx manual page for the special-iterators swap-and-invalidation situation for forward_list, and it's literally all because of the before_begin iterator. Periodt. 🎀

✨ SYNOPSIS ✨

#include <forward_list>

Inherits __gnu_debug::_Safe_sequence< _SafeSequence >. Slay. 💖

🫶 Public Member Functions

  • void _M_invalidate_if (_Predicate __pred) — the invalidate-if vibe check.
  • void _M_transfer_from_if (_Safe_sequence &__from, _Predicate __pred) — the transfer-from-if situation.

🎀 Public Attributes

  • _Safe_iterator_base * _M_const_iterators — The list of constant iterators that reference this container. Iconic little registry. ✨
  • _Safe_iterator_base * _M_iterators — The list of mutable iterators that reference this container. Also iconic. 💅
  • unsigned int _M_version — The container version number. This number may never be 0. No cap, never ever. 🚨

🦋 Protected Member Functions

  • void _M_detach_all ()
  • void _M_detach_singular ()
  • __gnu_cxx::__mutex & _M_get_mutex () throw ()
  • void _M_invalidate_all ()
  • void _M_invalidate_all () const
  • void _M_revalidate_singular ()
  • void _M_swap (_Safe_sequence_base &) noexcept

🌸 Detailed Description 🌸

template<typename _SafeSequence>
class __gnu_debug::_Safe_forward_list< _SafeSequence >

Special iterators swap and invalidation for forward_list because of the before_begin iterator. That's the whole main character energy of this page, fr fr. 🦋

💖 Member Function Documentation 💖

🧹 void __gnu_debug::_Safe_sequence_base::_M_detach_all () — [protected], [inherited]

Detach all iterators, leaving them singular.

Referenced by __gnu_debug::_Safe_sequence_base::~_Safe_sequence_base().

🫧 void __gnu_debug::_Safe_sequence_base::_M_detach_singular () — [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 () — [protected], [inherited]

For use in _Safe_sequence.

Referenced by __gnu_debug::_Safe_sequence< _Sequence >::_M_transfer_from_if().

💥 void __gnu_debug::_Safe_sequence_base::_M_invalidate_all () const — [inline], [protected], [inherited]

Invalidates all iterators.

References __gnu_debug::_Safe_sequence_base::_M_version.

🎯 void __gnu_debug::_Safe_sequence< _SafeSequence >::_M_invalidate_if (_Predicate __pred) — [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.

🩹 void __gnu_debug::_Safe_sequence_base::_M_revalidate_singular () — [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).

🚚 void __gnu_debug::_Safe_sequence< _SafeSequence >::_M_transfer_from_if (_Safe_sequence< _SafeSequence > & __from, _Predicate __pred) — [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.

💎 Member Data Documentation 💎

  • _Safe_iterator_base* __gnu_debug::_Safe_sequence_base::_M_const_iterators — [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 — [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 __gnu_debug::_Safe_sequence_base::_M_invalidate_all(), __gnu_debug::_Safe_iterator< _Iterator, _Sequence, _Category >::operator=(), __gnu_debug::_Safe_local_iterator< _Iterator, _Sequence >::operator=(), __gnu_debug::_Safe_iterator< _Iterator, _Sequence, _Category >::operator=(), and __gnu_debug::_Safe_local_iterator< _Iterator, _Sequence >::operator=().

⭐ Author ⭐

Generated automatically by Doxygen for libstdc++ from the source code. Not me writing this by hand at 2 a.m., obviously. 🙈

Cute lil sign-off: the source/version is libstdc++, the manual section is 3cxx, and the date slot is giving mysterious timeless energy. Bye bestie, drink water and keep your iterators valid 💜🎀🫶
📦 where this page comes from