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

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

Replaces the current locale with loc. The regular expression does not match any character sequence after the call.

## Official Specification Summary (cppreference)

```cpp
locale_type imbue( locale_type loc ); // (since C++11)
```

Replaces the current locale with `loc`. The regular expression does not match any character sequence after the call.

Effectively calls `traits_i.imbue(loc)` where `traits_i` is a default initialized instance of the type `Traits` stored within the regular expression object.

### Parameters

- `loc` - new locale to use

### Return value

The locale before the call to this function. Effectively returns the result of expression `traits_i.imbue(loc)`.

### Exceptions

May throw implementation-defined exceptions.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`getloc`](https://en.cppreference.com/w/cpp/regex/basic_regex/getloc): get locale information (public member function)

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