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 |