std::stack<T,Container>::push_range
From cppreference.com
| template< container-compatible-range<value_type> R > void push_range( R&& rg ); |
(since C++23) | |
Inserts a copy of each element of rg in stack, as if by:
- c.append_range(std::forward<R>(rg)) if that is a valid expression (i.e. the underlying container c has an appropriate
append_rangemember function), or - ranges::copy(rg, std::back_inserter(c)) otherwise.
Each iterator in the range rg is dereferenced exactly once.
Contents |
[edit] Parameters
| rg | - | a container compatible range, that is, an input_range whose elements are convertible to T
|
[edit] Complexity
Identical to the complexity of c.append_range or ranges::copy(rg, std::back_inserter(c)) (depending on what function is used internally).
[edit] Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges |
202202L |
(C++23) | Ranges-aware construction and insertion |
[edit] Example
Run this code
#include <initializer_list> #include <stack> #include <version> #ifdef __cpp_lib_format_ranges #include <print> using std::println; #else #define FMT_HEADER_ONLY #include <fmt/ranges.h> using fmt::println; #endif int main() { std::stack<int> adaptor; const auto rg = {1, 3, 2, 4}; #ifdef __cpp_lib_containers_ranges adaptor.push_range(rg); #else for (int e : rg) adaptor.push(e); #endif println("{}", adaptor); }
Output:
[1, 3, 2, 4]
[edit] See also
| inserts element at the top (public member function) |
