# std::regex_traits<CharT>::imbue

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

Replaces the current locale with a copy of loc. If loc is different than the current locale, then all cached data is invalidated.

## Official Specification Summary (cppreference)

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

Replaces the current locale with a copy of `loc`. If `loc` is different than the current locale, then all cached data is invalidated.

After the call `getloc() == loc`.

### Parameters

- `loc` - the locale to imbue

### Return value

The current locale of the traits object.

If `imbue()` has been never called for this object, then the global locale at the time of the call is returned. Otherwise, the locale passed to the last call to `imbue()` is returned.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`getloc`](https://en.cppreference.com/w/cpp/regex/regex_traits/getloc): gets the locale (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/regex/regex_traits/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.