std::basic_regex::assign

 

C++

Language

Headers

Library concepts

Language support library

Diagnostics library

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library(C++11)

Atomic operations library(C++11)

Thread support library(C++11)

Filesystem library(C++17)

Technical Specifications

 

Regular expressions library

Classes

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Algorithms

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Iterators

regex_iterator (C++11)

regex_token_iterator (C++11)

Exceptions

regex_error (C++11)

Traits

regex_traits (C++11)

Constants

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

Regex Grammar

Modified ECMAScript-262 (C++11)

 

std::basic_regex

Member Functions

basic_regex::basic_regex

basic_regex::~basic_regex

basic_regex::operator=

basic_regex::assign

Observers

basic_regex::mark_count

basic_regex::flags

Locale

basic_regex::getloc

basic_regex::imbue

Modifiers

basic_regex::swap

Constants

basic_regex constants

Non-member Functions

swap(std::basic_regex)

Deduction guides(C++17)

 

basic_regex& assign(const basic_regex& other );	(1)	(since C++11)
basic_regex& assign( basic_regex&& that )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, size_t count,                      flag_type f =std::regex_constants::ECMAScript);	(4)	(since C++11)
template<class ST, class SA > basic_regex& assign(conststd::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.

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 InputIterator.

Return value

*this

Exceptions

1-2) (none)

3-7)std::regex_error if the supplied regular expression is not valid. The object is not modified in that case.

See also

operator=

assigns the contents (public member function)