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

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

Inserts, in non-reversing order, copies of elements in rg before begin(). Each iterator in the range rg is dereferenced exactly once.

## Official Specification Summary (cppreference)

```cpp
template< container-compatible-range<T> R >
void prepend_range( R&& rg ); // (since C++23)
```

Inserts, in non-reversing order, copies of elements in `rg` before `begin()`. Each iterator in the range `rg` is dereferenced exactly once.

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

### Parameters

- `rg` - a container compatible range, that is, an `input_range` whose elements are convertible to `T`

**Type requirements**

- `T` must be *EmplaceConstructible* into `deque` from `*ranges::begin(rg)`. Also, `T` must be *MoveInsertable* into `deque` and `T` satisfies *MoveConstructible*, *MoveAssignable*, and *Swappable*. Otherwise, the behavior is undefined.

### Return value

(none)

### Complexity

Linear in size of `rg`.

### Notes

| Feature-test macro | Value | Std | Feature |
| --- | --- | --- | --- |
| `__cpp_lib_containers_ranges` | `202202L` | (C++23) | Ranges-aware construction and insertion |

### Example

```cpp
#include <algorithm>
#include <cassert>
#include <deque>
#include <vector>

int main()
{
    auto container = std::deque{0, 1, 2, 3};
    const auto rg = std::vector{-3, -2, -1};

#if __cpp_lib_containers_ranges
    container.prepend_range(rg);
#else
    container.insert(container.begin(), rg.cbegin(), rg.cend());
#endif
    assert(std::ranges::equal(container, std::deque{-3, -2, -1, 0, 1, 2, 3}));
}
```

### See also

- [`append_range`](https://en.cppreference.com/w/cpp/container/deque/append_range) (C++23): adds a range of elements to the end (public member function)
- [`insert_range`](https://en.cppreference.com/w/cpp/container/deque/insert_range) (C++23): inserts a range of elements (public member function)
- [`push_front`](https://en.cppreference.com/w/cpp/container/deque/push_front): inserts an element to the beginning (public member function)
- [`emplace_front`](https://en.cppreference.com/w/cpp/container/deque/emplace_front) (C++11): constructs an element in-place at the beginning (public member function)

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