deduction guides for std::stack

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Container-Bibliothek

Sequenz

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

Assoziativ

setzt

multiset

map

multimap

Ungeordnete assoziative

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adapter

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Ansichten

span (C++20)

mdspan (C++23)

Tabellen

Iterator-Invalidierung

Mitgliedsfunktionstabelle

Nicht-Mitgliedsfunktionstabelle

 

std::stack

Memberfunktionen

stack::stack

stack::~stack

stack::operator=

Elementzugriff

stack::top

Kapazität

stack::empty

stack::size

Modifizierer

stack::push

stack::push_range (C++23)

stack::emplace (C++11)

stack::pop

stack::swap (C++11)

Nicht-Member-Funktionen

swap(std::stack) (C++11)

operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20)

Hilfsklassen

uses_allocator<std::stack> (C++11)

formatter<std::stack> (C++23)

Ableitungs-Guides(C++17)

 

Definiert in Header <stack>
template< class Container > stack( Container )     -> stack<typename Container::value_type, Container>;	(1)	(seit C++17)
template< class Container, class Alloc > stack( Container, Alloc )     -> stack<typename Container::value_type, Container>;	(2)	(seit C++17)
template< class InputIt > stack( InputIt, InputIt )     -> stack<typename std::iterator_traits<InputIt>::value_type>;	(3)	(seit C++23)
template< class InputIt, class Alloc > stack( InputIt, InputIt, Alloc )     -> stack<typename std::iterator_traits<InputIt>::value_type,        std::deque<typename std::iterator_traits<InputIt>::value_type, Alloc>>;	(4)	(seit C++23)
template< ranges::input_range R > stack( std::from_range_t, R&& )     -> stack<ranges::range_value_t<R>>;	(5)	(seit C++23)
template< ranges::input_range R, class Allocator > stack( std::from_range_t, R&&, Allocator )     -> stack<ranges::range_value_t<R>,        std::deque<ranges::range_value_t<R>, Allocator>>;	(6)	(seit C++23)

Diese Deduktionshilfen werden für stack bereitgestellt, um die Deduktion vom zugrunde liegenden Containertyp zu ermöglichen.

1) Deduziert den zugrunde liegenden Containertyp aus dem Argument.

2) Dasselbe wie (1), nur dass der Allokator bereitgestellt wird.

3) Deduziert den Elementtyp aus dem Iterator unter Verwendung von std::deque<typename std::iterator_traits<InputIt>::value_type> als zugrunde liegendem Containertyp.

4) Dasselbe wie (3), nur dass der Allokator bereitgestellt wird.

5) Deduziert den Elementtyp aus einem std::from_range_t Tag und einem input_range.

6) Dasselbe wie (5), nur dass der Allokator bereitgestellt wird.

Diese Überladungen nehmen nur an der Auflösung von Überladungen teil, wenn

• InputIt (falls vorhanden) LegacyInputIterator erfüllt,
• Container (falls vorhanden) kein Allocator erfüllt,
• für (3)(bis C++23)(4)(seit C++23) erfüllt Alloc Allocator, und
• std::uses_allocator_v<Container, Alloc> ist true, wenn sowohl Container als auch Alloc vorhanden sind.

Hinweis: Das Ausmaß, in dem die Bibliothek feststellt, dass ein Typ LegacyInputIterator nicht erfüllt, ist nicht spezifiziert, außer dass ganzzahlige Typen als Minimum keine Eingabeiteratoren sind. Ebenso ist das Ausmaß, in dem sie feststellt, dass ein Typ Allocator nicht erfüllt, nicht spezifiziert, außer dass als Minimum der Mitgliedstyp Alloc::value_type existieren muss und der Ausdruck std::declval<Alloc&>().allocate(std::size_t{}) als unevaluierter Operand wohlgeformt sein muss.

Notizen

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_adaptor_iterator_pair_constructor	202106L	(C++23)	Iterator-Paar-Konstruktoren für std::queue und std::stack; Überladungen (2) und (4)
__cpp_lib_containers_ranges	202202L	(C++23)	Bereichsbezogene Konstruktion und Einfügung; Überladungen (5) und (6)

Beispiel

Führen Sie diesen Code aus

#include <stack>
#include <vector>
 
int main()
{
    std::vector<int> v = {1, 2, 3, 4};
    std::stack s{v}; // guide #1 deduces std::stack<int, vector<int>>
}