std::basic_regex::assign - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::basic_regex::assign

From cppreference.com
< cpp‎ | regex‎ | basic regex

basic_regex& assign( const basic_regex& other ); | (1) | (since C++11)
basic_regex& assign( basic_regex&& that ); | (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( 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.
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`.

### [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 `InputIterator`.

### [edit] Return value

*this

### [edit] Exceptions

1) (none)
2)
`noexcept` specification:
noexcept
3-7) std::regex_error if the supplied regular expression is not valid. The object is not modified in that case.

### [edit] Example

| This section is incomplete Reason: no example

### [edit] See also

operator= | assigns the contents (public member function) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/regex/basic_regex/assign&oldid=91602"
Categories:

- unconditionally noexcept
- Todo no example

Hidden categories:

- Pages with unreviewed unconditional noexcept template
- Pages with unreviewed noexcept template