Scroll to navigation

std::basic_regex::assign(3) C++ Standard Libary std::basic_regex::assign(3)

NAME

std::basic_regex::assign - std::basic_regex::assign

Synopsis


basic_regex& assign( const basic_regex& other ); (1) (since C++11)
basic_regex& assign( basic_regex&& other ) noexcept; (2) (since C++11)
basic_regex& assign( const CharT* s,
flag_type f = (3) (since C++11)
std::regex_constants::ECMAScript );
basic_regex& assign( const CharT* ptr, std::size_t count,
flag_type f = (4) (since C++11)
std::regex_constants::ECMAScript );
template< class ST, class SA >


basic_regex& assign( const std::basic_string<CharT,ST,SA>& str, (5) (since C++11)


flag_type f =
std::regex_constants::ECMAScript );
template< class InputIt >


basic_regex& assign( InputIt first, InputIt last, (6) (since C++11)


flag_type f =
std::regex_constants::ECMAScript );
basic_regex& assign( std::initializer_list<CharT> ilist,
flag_type f = (7) (since C++11)
std::regex_constants::ECMAScript );


Assigns the contents to the regular expression.


1) Assigns the contents of other. flags() and mark_count() are equivalent to the
values of other.flags() and other.mark_count() after the call.
2) Assigns the contents of other using move semantics. flags() and mark_count() are
equivalent to the values of other.flags() and other.mark_count() before the
assignment. After the call, other is in a valid, but unspecified state.
3-7) Assigns a sequence of characters to the regular expression. The syntax flags
are set to f. mark_count() returns the number of marked subexpressions within the
resulting subexpression after the call.
3) Assigns a null-terminated string pointed to by s.
4) Assigns a sequence of count characters, pointed to by s.
5) Assigns the string str.
6) Assigns the characters in the range [first, last).
7) Assigns the characters in the initializer list ilist.

Parameters


other - another regular expression to assign
s - pointer to a character sequence to assign
str - string to assign
first, last - the range of characters to assign
ilist - initializer list containing characters to assign

Type requirements


-
InputIt must meet the requirements of LegacyInputIterator.

Return value


*this

Exceptions


1) May throw implementation-defined exceptions.
3-7) std::regex_error if the supplied regular expression is not valid. The object is
not modified in that case.

Example


This section is incomplete
Reason: no example

See also


operator= assigns the contents
(public member function)

Category:


* Todo no example

2024.06.10 http://cppreference.com