initializer_list-Klasse

Bietet Zugriff auf ein Array von Elementen, in dem jedes Mitglied von einem angegebenen Typ ist.

Syntax

template <class Type>
class initializer_list

Parameter

Typ
Der in initializer_list zu speichernde Elementdatentyp.

Hinweise

Ein initializer_list-Element kann mit einer Initialisiererliste in Klammern erstellt werden:

initializer_list<int> i1{ 1, 2, 3, 4 };

Der Compiler transformiert in Klammern gesetzte Initialisiererlisten mit homogenen Elementen in initializer_list, wenn für die Funktionssignatur initializer_list erforderlich ist. Weitere Informationen zur Verwendung initializer_listfinden Sie unter Uniform Initialization and Delegating constructors

Konstruktoren

Konstruktor Beschreibung
initializer_list Konstruiert ein Objekt vom Typ initializer_list.

TypeDefs

Typname Beschreibung
value_type Der Typ der Elemente im initializer_list.
reference Ein Typ, der einen Verweis auf ein in der initializer_list gespeichertes Element bereitstellt.
const_reference Ein Typ, der einen Konstantenverweis auf ein in der initializer_list gespeichertes Element bereitstellt.
size_type Ein Typ, der die Anzahl von Elementen in der initializer_list darstellt.
iterator Ein Typ, der einen Iterator für die initializer_list bereitstellt.
const_iterator Ein Typ, der einen konstanten Iterator für die initializer_list bereitstellt.

Memberfunktionen

Memberfunktion Beschreibung
begin Gibt einen Zeiger auf das erste Element in einer initializer_list zurück.
end Gibt einen Zeiger auf das Element hinter dem letzten Element in einer initializer_list zurück.
size Gibt die Anzahl von Elementen in der initializer_list zurück.

Anforderungen

Header:<initializer_list>

Namespace: std

initializer_list::begin

Gibt einen Zeiger auf das erste Element in einer initializer_list zurück.

constexpr const InputIterator* begin() const noexcept;

Rückgabewert

Ein Zeiger auf das erste Element von initializer_list. Wenn die Liste leer ist, ist der Zeiger für den Beginn und das Ende der Liste gleich.

initializer_list::end

Gibt einen Zeiger auf das Element hinter dem letzten Element in einer initializer list zurück.

constexpr const InputIterator* end() const noexcept;

Rückgabewert

Ein Zeiger auf das Element eine Position hinter dem letzten Element in der Liste. Wenn die Liste leer ist, ist sie mit dem Mauszeiger auf das erste Element in der Liste identisch.

initializer_list::initializer_list

Konstruiert ein Objekt vom Typ initializer_list.

constexpr initializer_list() noexcept;
initializer_list(const InputIterator First, const InputIterator Last);

Parameter

First
Die Position des ersten Elements in dem zu kopierenden Elementbereich.

Last
Die Position des ersten Elements nach dem zu kopierenden Elementbereich.

Hinweise

Eine initializer_list basiert auf einem Array von Objekten des angegebenen Typs. Durch kopieren einer initializer_list Liste wird eine zweite Instanz einer Liste erstellt, die auf dieselben Objekte zeigt; die zugrunde liegenden Objekte werden nicht kopiert.

Beispiel

// initializer_list_class.cpp
// compile with: /EHsc
#include <initializer_list>
#include <iostream>

int main()
{
    using namespace std;
    // Create an empty initializer_list c0
    initializer_list <int> c0;

    // Create an initializer_list c1 with 1 element
    initializer_list <int> c1{ 3 };

    // Create an initializer_list c2 with 5 elements
    initializer_list <int> c2{ 5, 4, 3, 2, 1 };

    // Create a copy, initializer_list c3, of initializer_list c2
    initializer_list <int> c3(c2);

    // Create a initializer_list c4 by copying the range c3[ first,  last)
    const int* c3_ptr = c3.begin();
    c3_ptr++;
    c3_ptr++;
    initializer_list <int> c4(c3.begin(), c3_ptr);

    // Move initializer_list c4 to initializer_list c5
    initializer_list <int> c5(move(c4));

    cout << "c1 =";
    for (auto c : c1)
        cout << " " << c;
    cout << endl;

    cout << "c2 =";
    for (auto c : c2)
        cout << " " << c;
    cout << endl;

    cout << "c3 =";
    for (auto c : c3)
        cout << " " << c;
    cout << endl;

    cout << "c5 =";
    for (auto c : c5)
        cout << " " << c;
    cout << endl;
}
c1 = 3
c2 = 5 4 3 2 1
c3 = 5 4 3 2 1
c5 = 5 4

initializer_list::size

Gibt die Anzahl von Elementen in der Liste zurück.

constexpr size_t size() const noexcept;

Rückgabewert

Die Anzahl von Elementen in der Liste.

Siehe auch

<forward_list>