Benutzer:Koschi/Kontainer der STL

Aus Spieleprogrammierer-Wiki
Wechseln zu: Navigation, Suche

In der Spieleentwicklung ist es oft nötig, ein gewisse Menge an identischen Daten zu verwalten. Um die Verwaltung der Daten nicht von Grund auf selber zu programmieren bietet die Standard Template Libary eine umfangreiche Sammlung an Kontainern, die das Verwalten der Daten erheblich erleichtert. Die Arbeitsweise und wofür die Verschiedenen Kontainer sind soll in diesem Artikel näher beschrieben werden.

Inhaltsverzeichnis

Was ist ein Kontainer

Einen Kontainer kann man sich als Behältnis für Daten vorstellen, diese Daten werden auch Elemente genannt. Einen bekannter (nicht STL) Kontainer, den wohl jeder bereits kennt und benutzt hat, ist ein simples eindimenionales Array. Der Vorteil bei den STL Kontainer ist, dass die Anzahl der Elemente in den meinsten Fällen dynamisch wachsen können. Es spielt dabei keine Rolle ob diese Daten Structs, Klassen oder eines der Grunddatentypen sind. Wie das "Befüllen" mit Daten erfolgt, hängt aber vom Konatainer selber ab, da sich die Interne Datenstrukture von Kontainertyp zu Kontainertyp unterscheiden kann. Bedingt durch den Aufbau der Kontainer kann man diese in 3 Kategorien aufteilen:

Um die Verwaltung des benötigten Speichers, kümmern sich die Kontainer selber.

Sequentielle Kontainer

Die Daten in einem Sequentiellen Kontainer liegen in der Reihenfolge vor wie sie Eingefügt wurden. Das heist wurde ein Element als drittes hinzugefügt ist es auch später wieder an dieser stelle zu finden. Für Sequentielle Kontainer kann ein Iterator erstellt werde, der es ermöglicht alle Elemente des Kontainers über eine Schleife zu erreichen.

Zu den Sequentille Kontainer gehören:

Assoziative Kontainer

Die Assoziative Kontainer können weiter unterteilt werden in Map- und Set-Kontainer, sowie jeweils in eine multi Version. An welche Stelle im Kontainer die Elemente eingeordnet werden, kann über eine eigene Vergleichsfunktion bestimmt werden.

Mit C++11 wurden noch jeweils eine ungeordnete Versionen eingeführt. Ungeordnet heist in diesem Zusammenhang aber nur, dass nicht die Möglichkeit gegeben ist eine (eigene) Vergleichsfunktion einzusetzen. Intern arbeiten diese ungeordneten Kontainer mit Hashwerten, der Zugriff auf die Daten ist so wesentlich schneller. Es besteht aber die Möglichkeit einen eigenen Hash-Algorithmus einzusetzen, um die Reihenfolge der Daten festzulegen.

Der Zugriff auf ein Elemente kann bei allen Assoziative Kontainer über einen Schlüssel erfolgen. Die Map-Kontainer besitzen ein Schlüssel-Werte-Paar, Schlüssel und Wert können (müssen aber nicht) unterschiedliche Datentypen sein. Die Set-Kontainer besitzen lediglich den Schlüssel, der gleichzeitig auch den Wert darstellt. Der Schlüssel darf dabei nur einmalig im Kontainer vorkommen, es sei den es handelt sich um die multi Version, hier darf der Schlüssel mehrfach vorkommen.

Für Assoziative Kontainer kann ein Iterator erstellt werde, der es ermöglicht alle Elemente des Kontainers über eine Schleife zu erreichen.

Zu den Assoziative Kontainer gehören:

Kontaineradapter

Die Kontaineradapter sind spezielle Varianten von Sequentiellen Kontainer oder Assoziative Kontainer. Diese Kontainer sind auf besondere Aufgaben zugeschnitten, deshalb ist das Interface einfach gehalten und verzichtet auf Iteratoren.

Zu den Kontaineradapter gehören:

Allgemeines

Die Kontainer der Standard Template Libary befinden sich im Namensraum std.

Klassen und Structs sollten Kopierbar sein, dass heißt einen public Kopierkonstruktor haben. Sind sie nicht Kopierbar, müssen die Structs oder Klassen Moveable sein, dieses funktioniert aber nur solange die Objekte nicht Kopiert werden. Moveable bedeutet in diesem Zusammenhang, dass die Klassen oder Structs einen Movekonstruktor benötigen, dann kann die Instanz der Klasse mit der Funktion std::move(T) herumgereicht werden.

Einige Kontainer benötigen bei bestimmten Operationen ein public default Konstruktor oder ein public Gleichheits-Operator, welche bei Klassen oder Structs dann Implementiert werden muss. Geordnete Assoziative Kontainer benötigen, von den Klassen und Structs, einen öffentlichen Vergleichs-Operator.

Header

In folgender Tabelle sind die Header ersichtlich, die Includiert werden müssen, damit der entsprechende Kontainer genutzt werden kann.

Kontainer Name #include
array <array>
deque <deque>
forward_list <forward_list>
list <list>
vector <vector>
map <map>
multimap
unordered_map <unordered_map>
unordered_multimap
set <set>
multiset
unordered_set <unordered_set>
unordered_multiset
priority_queue <queue>
queue
stack <stack>

Klassenfunktionen

Funktion Details zur Funktion a
r
r
a
y
d
e
q
u
e
f
o
r
w
a
r
d
_
l
i
s
t
l
i
s
t
m
a
p
m
u
l
t
i
m
a
p
m
u
l
t
i
s
e
t
p
r
i
o
r
i
t
y
_
q
u
e
u
e
q
u
e
u
e
s
e
t
s
t
a
c
k
u
n
o
r
d
e
r
e
d
_
m
a
p
u
n
o
r
d
e
r
e
d
_
m
u
l
t
i
m
a
p
u
n
o
r
d
e
r
e
d
_
m
u
l
t
i
s
e
t
u
n
o
r
d
e
r
e
d
_
s
e
t
v
e
c
t
o
r
assign Die Funktion assign weist dem Kontainer einen komplett neuen Inhalt zu und löscht die alten Elemente. Die Größe des Kontainers wird der Anzahl der neuen Elemente angepasst.
Deklaration Erklärung
1) void assign (InputIterator first, InputIterator last);

2) void assign (size_type n, const T& val);
3) void assign (initializer_list<T> il);

1) Übernimmt vom Iterator first bis Iterator last alle Elemente
2) Übernimmt n mal den Wert von val
3) Übernimmt Werte aus einer std::initializer_list

Code-Beispiel

deque

#include <deque>
#include <iostream>
 
int main()
{
    int first = 1;
    int second = 2;
    int third = 3;
 
    std::deque<int> dequeContainer1, dequeContainer2, dequeContainer3;
 
    // 2) fügt 7 mal first in dequeContainer2 ein
    dequeContainer2.assign(7, first);
 
    // 1) fügt von dequeContainer2 die Elemente 2,3,4,5 und 6 in dequeContainer1 ein
    dequeContainer1.assign(dequeContainer2.begin() + 1, dequeContainer2.end() - 1);
 
    // 3) fügt die 3 Instanzen von intArray in dequeContainer3 ein
    int intArray[] = {first, second, third};
    dequeContainer3.assign(intArray, intArray + 3);
 
    std::cout << "dequeContainer1 size: " << dequeContainer1.size() << std::endl;
    std::cout << "dequeContainer2 size: " << dequeContainer2.size() << std::endl;
    std::cout << "dequeContainer3 size: " << dequeContainer3.size() << std::endl;
 
    return 0;
}
 
/*
Ausgabe: 
dequeContainer1 size: 5
dequeContainer2 size: 7
dequeContainer3 size: 3
*/

forward_list

#include <forward_list>
#include <iostream>
 
int main()
{
    int first = 1;
    int second = 2;
    int third = 3;
 
    std::forward_list<int> forwardListContainer1, forwardListContainer2;
 
    // 2) fügt 7 mal first in forwardListContainer2 ein
    forwardListContainer2.assign(7, first);
 
    // 1) fügt von forwardListContainer2 alle Elemente in forwardListContainer1 ein
    forwardListContainer1.assign(forwardListContainer2.begin(), forwardListContainer2.end());
 
    // 3) fügt die 3 Instanzen von intArray in forwardListContainer2 ein
    int intArray[] = {first, second, third};
    forwardListContainer2.assign(intArray, intArray + 3);
    
    // Ausgabe Inhalt
    std::cout << "forwardListContainer1: ";
    for(auto it = forwardListContainer1.begin(); it !=  forwardListContainer1.end(); ++it)
        std::cout << *it << " ";
 
    std::cout << std::endl;
    // Ausgabe Inhalt
    std::cout << "forwardListContainer2: ";
    for(auto it = forwardListContainer2.begin(); it !=  forwardListContainer2.end(); ++it)
        std::cout << *it << " ";
 
    return 0;
}
 
/*
Ausgabe:
forwardListContainer1: 1 1 1 1 1 1 1
forwardListContainer2: 1 2 3
*/

list

#include <list>
#include <iostream>
 
int main()
{
    int first = 1;
    int second = 2;
    int third = 3;
 
    std::list<int> listContainer1, listContainer2;
 
    // 2) fügt 7 mal first in listContainer2 ein
    listContainer2.assign(7, first);
 
    // 1) fügt von listContainer2 alle Elemente 1 in listContainer1 ein
    listContainer1.assign(listContainer2.begin(), listContainer2.end());
 
    // 3) fügt die 3 Instanzen von intArray in listContainer2 ein
    int intArray[] = {first, second, third};
    listContainer2.assign(intArray, intArray + 3);
    
    std::cout << "listContainer1 size: " << listContainer1.size() << std::endl;
    std::cout << "listContainer2 size: " << listContainer2.size() << std::endl;
 
    return 0;
}
 
/*
Ausgabe:
listContainer1 size: 7
listContainer2 size: 3
*/

vector

#include <vector>
#include <iostream>
 
int main()
{
    int first = 1;
    int second = 2;
    int third = 3;
 
    std::vector<int> vectorContainer1, vectorContainer2;
 
    // 2) fügt 7 mal first vectorContainer2 ein
    vectorContainer2.assign(7, first);
 
    // 1) fügt von vectorContainer2 die Elemente 2,3,4,5 und 6 in vectorContainer1 ein
    vectorContainer1.assign(vectorContainer2.begin() + 1, vectorContainer2.end() - 1);
 
    // 3) fügt die 3 Instanzen von intArray in vectorContainer2 ein
    int intArray[] = {first, second, third};
    vectorContainer2.assign(intArray, intArray + 3);
    
    std::cout << "vectorContainer1 size: " << vectorContainer1.size() << std::endl;
    std::cout << "vectorContainer2 size: " << vectorContainer2.size() << std::endl;
 
    return 0;
}
 
/*
Ausgabe:
vectorContainer1 size: 5
vectorContainer2 size: 3
*/
O X X X O O O O O O O O O O O X
at Über die at Funktion kann eine bestimmtes Element des Kontainers zurückgegeben werden.
Deklaration Erklärung

1) T& at (size_type n);
2) const T& at (size_type n) const;

Git das n-te Element zurück,
bei 1) als Referenz
bei 2) als Konstante Referenz

Code-Beispiel

array

 

deque

 

map

 

unordered_map

 

vector

 


X X O O X O O O O O O X O O O X
back Die back Funktion gibt eine Referenz auf das letzte Element im Kontainer zurück. Diese Funktion sollte nicht bei einem leeren Kontainer angewendet werden, das Verhalten ist nicht Definiert!
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O X O O O O X O O O O O O X
before_begin Die Funktion before_begin liefert einen Iterator zurück, der vor das ersten Elemente zeigt. Dieser Iterator sollt nicht dereferenziert werden! Er ist nur dafür da anzugeben wo eine andere Funktion ihre aktion stattfindet wie z.B. für emplace_after oder erase_after.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X O O O O O O O O O O O O O
begin Die Funktion begin gibt einen Iterator zurück, der auf das erste Element im Kontainer zeigt.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X O O X O X X X X X
bucket Gibt die Bucketnummer des Elementes zurück.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
bucket_count Die Funktion bucket_count gibt die anzahl an Bucket's zurück, die der Kontainer enthält.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
bucket_size
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
capcity Gibt zurück, für wieviel Elemente aktuell Speicher allokiert wurde. Diese kann gleich size sein, muss es aber nicht. In der Regel wird mehr Speicher für Elemente allokiert als benötigt.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O O O O O X
cbefor_begin Die Funktion cbefore_begin liefert einen Konstanten Iterator zurück, der vor das ersten Elemente zeigt. Dieser Iterator sollt nicht dereferenziert werden! Er ist nur dafür da anzugeben wo eine andere Funktion ihre aktion stattfindet wie z.B. für emplace_after oder erase_after.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X O O O O O O O O O O O O O
cbegin Die Funktion cbegin gibt ein Konstanten Iterator zurück, der auf das erste Element im Kontainer zeigt.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X O O X O X X X X X
cend Die Funktion cend gibt ein Konstanten Iterator zurück, der hinter das letzte Element im Kontainer zeigt.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X O O X O X X X X X
clear Die Funktion clear entfernt alle Elemente des Kontainers.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X X X X X X O O X O X X X X X
count Die Funktion count sucht im Kontainer nach der Anzahl der Elemente die einen bestimmten Wert haben und gibt die Anzahl zurück.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O X X X X O
crbegin Die Funktion crbegin gibt ein Konstanten Iterator zurück, der auf das letzte Element im Kontainer zeigt und diesen Kontainer von hinten nach vorne durchläuft (durch inkrementieren).
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O X X X X O O X O O O O O X
crend Die Funktion crend gibt ein Konstanten Iterator zurück, der vor das erste Element im Kontainer zeigt und diesen Kontainer von hinten nach vorne durchläuft (durch inkrementieren).
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O X X X X O O X O O O O O X
data Die Funktion data gibt einen (internen) Pointer auf das erste Element des Kontainers zurück.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X O O O O O O O O O O O O O O X
emplace Die Funktion emplace fügt ein neues Element ein, an der Position des angegebenen Iterators. Zurückgegeben wird ein Iterator auf das neu erzeugt Element.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X X X X X X X X X X X X X
emplace_after Die Funktion emplace_after fügt ein neues Element ein, hinter der Position des angegebenen Iterators. Zurückgegeben wird ein Iterator auf das neu erzeugt Element.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X O O O O O O O O O O O O O
emplace_back Die Funktion emplace_back fügt ein neues Element hinter das letzte Element ein.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X O O O O O O O O O O O X
emplace_front Die Funktion emplace_front fügt ein neues Element vor das erste Element ein.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X O O O O O O O O O O O O
emplace_hint
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O X X X X O
empty Die Funktion empty gibt zurück, ob der Kontainer leer ist oder nicht.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X X X X X X X X X X
end Die Funktion end gibt ein Iterator zurück, der hinter das letzte Element im Kontainer zeigt.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X O O X O X X X X X
equal_range
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O X X X X O
erase Die Funktion erase löscht ein oder mehrere Elemente aus dem Kontainer und gibt ein Iterator auf das Element hinter dem letzten gelöschten Element zurück.
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X X X X O O X O X X X X X
erase_after
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X O O O O O O O O O O O O O
fill
Deklaration Erklärung
 ?  ??

Code-Beispiel


X O O O O O O O O O O O O O O O
find
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O X X X X O
front
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X O O O O X O O O O O O X
get_allocator
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X X X X X X O O X O X X X X X
hash_function
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X X
insert
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X X X X O O X O X X X X O
insert_after
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X O O O O O O O O O O O O O
key_comp
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O O O O O O
key_eq
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
load_factor
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
lower_bound
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O O O O O O
max_bucket_count
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
max_load_factor
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
max_size
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X O O X O X X X X X
merge
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X X O O O O O O O O O O O O
operator=
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X X X X X X O O X O X X X X X
operator[]
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O O X O O O O O O X O O O X
pop
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O X X O X O O O O O
pop_back
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X O O O O O O O O O O O X
pop_front
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X X X O O O O O O O O O O O O
push
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O X X O X O O O O O
push_back
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O X O O O O O O O O O O O X
push_font
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X X X O O O O O O O O O O O O
rbegin Die Funktion rbegin gibt ein Iterator zurück, der auf das letzte Element im Kontainer zeigt und diesen Kontainer von hinten nach vorne durchläuft (durch inkrementieren).
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O X X X X O O X O O O O O X
rehash
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O O O O O X X X X O
remove
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X X O O O O O O O O O O O O
remove_if
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X X O O O O O O O O O O O O
rend Die Funktion rend gibt ein Iterator zurück, der vor das erste Element im Kontainer zeigt und diesen Kontainer von hinten nach vorne durchläuft (durch inkrementieren).
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O X X X X O O X O O O O O X
reverse
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X X O O O O O O O X X X X X
resize
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X X X O O O O O O O O O O O X
shrinkt_to_fit
Deklaration Erklärung
 ?  ??

Code-Beispiel


O X O O O O O O O O O O O O O X
size Gibt zurück wieviel Elemente der Kontainer besitzt.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X O X X X X X X X X X X X X X
sort
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X X O O O O O O O O O O O O
splice
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O X O O O O O O O O O O O O
splice_after
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X O O O O O O O O O O O O O
swap Tauscht den Inhalt mit einem anderen Kontainer, gleichen typs.
Deklaration Erklärung
 ?  ??

Code-Beispiel


X X X X X X X X X X X X X X X X
top
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O O O O X O O X O O O O O
unique
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O X X O O O O O O O O O O O O
upper_bound
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O O O O O O
value_comp
Deklaration Erklärung
 ?  ??

Code-Beispiel


O O O O X X X O O X O O O O O O

Laufzeitverhalten

Diagramm Laufzeitverhalten für O(1), O(log n) und O(n)

Eine direkte Zeitangabe ist wenig sinvoll, da diese auch von der Hardware abhängig ist. Das Laufzeitverhalten beschreibt, wie sich der Zeitaufwand ändert, wenn sich die Anzahl der Elemente im Kontainer erhöt. Da es bei großen Projekten oft auch um Geschwindikeit geht, kann hier schon im Vorfeld die Richtige wahl, Refactoring vermeiden.

Bedeutung:

Kontainer Name array deque forward_list list vector
Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende
Element zugriff O(1) O(1) O(1) N/A O(1) N/A O(1) O(1)
Element einfügen N/A O(1) O(n) O(1) O(1) O(n) O(1) O(n) O(1) O(n) O(1)
Element löschen N/A O(1) O(1) O(n) O(1) O(1) O(n O(1) O(n) O(1)
Element finden N/A
Kontainer Name map multimap unordered_map unordered_multimap
Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende
Element zugriff O(log n) O(log n) O(1)+ O(1)+
Element einfügen O(log n) O(log n) O(1)+ O(1)+
Element löschen O(log n) O(log n) O(1)+ O(1)+
Element finden O(log n) O(log n) O(1)+ O(1)+
Kontainer Name set multiset unordered_set unordered_multiset
Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende Beginn Mitte Ende
Element zugriff O(log n) O(log n) O(1)+ O(1)+
Element einfügen O(log n) O(log n) O(1)+ O(1)+
Element löschen O(log n) O(log n) O(1)+ O(1)+
Element finden O(log n) O(log n) O(1)+ O(1)+
Kontainer Name priority_queue queue stack
Größter Wert nicht Größter Wert Beginn Mitte Ende Beginn Mitte Ende
Element zugriff O(1) N/A O(1) N/A O(1) O(1) N/A
Element einfügen O(log n) N/A O(1) O(1) N/A
Element löschen O(log n) N/A O(1) N/A O(1) N/A
Element finden N/A
Meine Werkzeuge
Namensräume
Varianten
Aktionen
Navigation
Werkzeuge