std::sub_match<BidirIt>::swap
From cppreference.com
 
 
 
 
 
 C++ 
 Feature test macros (C++20)
 Concepts library (C++20)
 Metaprogramming library (C++11)
 Ranges library (C++20)
 Filesystem library (C++17)
 Concurrency support library (C++11)
 Execution control library (C++26)
Text processing library 
   
 Regular expressions library (C++11)
 Formatting library (C++20)
Regular expressions library 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Classes
(C++11)
(C++11)
(C++11)
 Algorithms
(C++11)
(C++11)
(C++11)
 Iterators
(C++11)
(C++11)
 Exceptions
(C++11)
 Traits
(C++11)
 Constants
(C++11)
(C++11)
(C++11)
 Regex Grammar
(C++11)
std::sub_match 
 
 
 Member functions
sub_match::swap
 Non-member functions
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
void swap( sub_match& s ) noexcept(/* see below */);
 
 (since C++11) 
Exchanges the contents of two sub-match objects. Equivalent to
this->pair<BidirIt, BidirIt>::swap(s);
std::swap (matched, s.matched);
[edit] Parameters
 s
 -
 a 
sub_match to swap with
 Type requirements
 -
BidirIt must meet the requirements of LegacySwappable.
[edit] Exceptions
noexcept specification:  
noexcept(std::is_nothrow_swappable_v <BidirIt>)
[edit] Example
Run this code
#include <cassert> #include <iostream> #include <regex> int main() { const char* s = "Quick red cat"; std::sub_match <const char*> x, y; x.first = &s[0]; x.second = &s[5]; x.matched = false; y.first = &s[012]; y.second = &s[13]; y.matched = true; std::cout << "Before swap:\n"; std::cout << "x.str() = [" << x.str() << "]\n"; std::cout << "y.str() = [" << y.str() << "]\n"; assert (!x.matched and y.matched); x.swap(y); std::cout << "After swap:\n"; std::cout << "x.str() = [" << x.str() << "]\n"; std::cout << "y.str() = [" << y.str() << "]\n"; assert (x.matched and !y.matched); }
Output:
Before swap: x.str() = [] y.str() = [cat] After swap: x.str() = [cat] y.str() = []
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior | 
|---|---|---|---|
| LWG 3204 | C++11 | std::sub_match  used inherited std::pair::swap(pair&) which led to a slicing | std::sub_match::swap(sub_match&) is added |