iter_swap(s...ve_iterator)(3)

💅 iter_swap(s...ve_iterator)(3) — C++ Standard Libary 💅

okay so bestie, welcome to the iter_swap(std::move_iterator) page from the C++ Standard Libary — yes, that's the manual name up top, typo and all, I'm not touching it 😭. This is iterator friendship content, and honestly? It ate.

💖 NAME 💖

iter_swap(std::move_iterator) - iter_swap(std::move_iterator)

That's the whole name, bestie. It's the std::move_iterator flavor of iter_swap, and it said what it said. 💅

🌀 Synopsis 🌀

          template< std::indirectly_swappable<Iter> Iter2 >

              friend constexpr void
                  iter_swap( const move_iterator& x, const
       (since C++20)
          std::move_iterator<Iter2>& y )

                      noexcept(/*see below*/);

Swaps the objects pointed to by two underlying iterators. The function body is equivalent to ranges::iter_swap(x.base(), y.base());.

This function template is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::move_iterator<Iter> is an associated class of the arguments.

🎀 Parameters 🎀

• x, y — move iterators to the elements to swap

✨ Return value ✨

(none). Yes, nothing. It's a side-effect main character. 🫶

🔥 Complexity 🔥

Constant. That's the whole vibe.

💀 Exceptions 💀

noexcept specification:

noexcept(noexcept(ranges::iter_swap(x.base(), y.base())))

🌸 Example 🌸

// Run this code — literally go run it:

        #include <iostream>
        #include <iterator>
        #include <string>
        #include <vector>

        int main()
        {
            std::vector<std::string> p{"AA", "EE"},
                                     q{"ⱯⱯ", "ƎƎ"};

            std::move_iterator<std::vector<std::string>::iterator>
                x = std::make_move_iterator(p.begin()),
                y = std::make_move_iterator(q.begin());

            std::cout << *x << ' ' << *y << '\n';

            iter_swap(x, y); // ADL

            std::cout << *x << ' ' << *y << '\n';
        }

🌈 Output 🌈

        AA ⱯⱯ
        ⱯⱯ AA

🦋 See also 🦋

• swap — swaps the values of two objects (function template)
• swap_ranges — swaps two ranges of elements (function template)
• iter_swap — swaps the elements pointed to by two iterators (function template)
• iter_swap — swaps the values referenced by two dereferenceable objects (C++20) (customization point object)
• iter_swap — swaps the objects pointed to by two adjusted underlying iterators (C++20) (function template)

👑 Category 👑

• * conditionally noexcept

mwah 💋 this page comes from http://cppreference.com, dated 2024.06.10, and its footer tag is iter_swap(s...ve_iterator)(3) — periodt. 🫶