# std::basic_regex<CharT,Traits>::assign

> C++ Atlas: `cppatlas.com/w/cpp/regex/basic_regex/assign` | Source: https://en.cppreference.com/w/cpp/regex/basic_regex/assign | Domain: Regular expressions | Standards: C++11

Assigns the contents to the regular expression.

## Official Specification Summary (cppreference)

```cpp
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.

  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

> Note: This section is incomplete Reason: no example

### See also

- [`operator=`](https://en.cppreference.com/w/cpp/regex/basic_regex/operator=): assigns the contents (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/regex/basic_regex/assign (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.