Namespaces
Variants

std::vector<T,Allocator>:: front

From cppreference.net

C++
Containers library
std::vector
Member types
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
reference front ( ) ;
(1) (constexpr seit C++20)
const_reference front ( ) const ;
(2) (constexpr seit C++20)

Gibt eine Referenz auf das erste Element im Container zurück.

Wenn empty() true ist, ist das Verhalten undefiniert.

(bis C++26)

Wenn empty() true ist:

  • Wenn die Implementierung gehärtet ist, tritt eine Vertragsverletzung auf. Wenn der Vertragsverletzungs-Handler unter "Observe"-Auswertungssemantik zurückkehrt, ist das Verhalten undefiniert.
  • Wenn die Implementierung nicht gehärtet ist, ist das Verhalten undefiniert.
(seit C++26)

Inhaltsverzeichnis

Rückgabewert

Verweis auf das erste Element.

Komplexität

Konstante.

Hinweise

Für einen Container c ist der Ausdruck c. front ( ) äquivalent zu * c. begin ( ) .

Beispiel

Der folgende Code verwendet front , um das erste Element eines std:: vector < char > anzuzeigen:

Diesen Code ausführen 
#include <cassert>
#include <vector>
int main()
{
    std::vector<char> letters{'a', 'b', 'c', 'd'};
    assert(letters.front() == 'a');
}

Siehe auch

Zugriff auf das letzte Element
(öffentliche Elementfunktion)
(C++11)
gibt einen Reverse-Iterator zum Ende zurück
(öffentliche Elementfunktion)
(C++11)
gibt einen Iterator zum Anfang zurück
(öffentliche Elementfunktion)
direkter Zugriff auf den zugrundeliegenden zusammenhängenden Speicher
(öffentliche Elementfunktion)