std::basic_regex<CharT,Traits>::assign - cppreference.com (original) (raw)

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 = std::regex_constants::ECMAScript ); (3) (since C++11)
basic_regex& assign( const CharT* ptr, std::size_t count, flag_type f = std::regex_constants::ECMAScript ); (4) (since C++11)
template< class ST, class SA > basic_regex& assign( const std::basic_string<CharT,ST,SA>& str, flag_type f = std::regex_constants::ECMAScript ); (5) (since C++11)
template< class InputIt > basic_regex& assign( InputIt first, InputIt last, flag_type f = std::regex_constants::ECMAScript ); (6) (since C++11)
basic_regex& assign( std::initializer_list<CharT> ilist, flag_type f = std::regex_constants::ECMAScript ); (7) (since C++11)

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.

  1. Assigns a null-terminated string pointed to by s.

  2. Assigns a sequence of count characters, pointed to by s.

  3. Assigns the string str.

  4. Assigns the characters in the range [first, last).

  5. Assigns the characters in the initializer list ilist.

[edit] 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.

[edit] Return value

*this

[edit] 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.

[edit] Example

[edit] See also