# std::deque<T,Allocator>::emplace_front

> C++ Atlas: `cppatlas.com/w/cpp/container/deque/emplace_front` | Source: https://en.cppreference.com/w/cpp/container/deque/emplace_front | Domain: Containers | Standards: C++11, C++17

Inserts a new element to the beginning of the container. The element is constructed through std::allocator_traits::construct, which typically uses placement-new to construct the element in-place at the location provided by the container.

## Official Specification Summary (cppreference)

```cpp
template< class... Args >
void emplace_front( Args&&... args ); // (since C++11) (until C++17)

template< class... Args >
reference emplace_front( Args&&... args ); // (since C++17)
```

Inserts a new element to the beginning of the container. The element is constructed through `std::allocator_traits::construct`, which typically uses placement-new to construct the element in-place at the location provided by the container. The arguments `args...` are forwarded to the constructor as `std::forward<Args>(args)...`.

All iterators (including the `end()` iterator) are invalidated. No references are invalidated.

### Parameters

- `args` - arguments to forward to the constructor of the element

**Type requirements**

- `T (the container's element type)` must meet the requirements of *EmplaceConstructible*.

### Return value

(none) (until C++17)

A reference to the inserted element. (since C++17)

### Complexity

Constant.

### Exceptions

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

### See also

- [`push_front`](https://en.cppreference.com/w/cpp/container/deque/push_front): inserts an element to the beginning (public member function)

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