Namespaces
Variants

std::basic_string<CharT,Traits,Allocator>:: front

From cppreference.net
C++
Strings library
std::basic_string
CharT & front ( ) ;
(1) (constexpr seit C++20)
const CharT & front ( ) const ;
(2) (constexpr seit C++20)

Gibt eine Referenz auf das erste Zeichen in der Zeichenkette 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

operator [ ] ( 0 )

Komplexität

Konstante.

Hinweise

In libstdc++, front() ist nicht verfügbar im C++98-Modus.

Beispiel

Diesen Code ausführen 
#include <iostream>
#include <string>
int main()
{
    std::string s("Exemplary");
    char& f1 = s.front();
    f1 = 'e';
    std::cout << s << '\n'; // "exemplary"
    std::string const c("Exemplary");
    char const& f2 = c.front();
    std::cout << &f2 << '\n'; // "Exemplary"
}

Ausgabe: 

exemplary
Exemplary

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
LWG 534 C++98 std::basic_string hatte die Memberfunktion front() nicht hinzugefügt

Siehe auch

( DR* )
greift auf das letzte Zeichen zu
(öffentliche Elementfunktion)
greift auf das erste Zeichen zu
(öffentliche Elementfunktion von std::basic_string_view<CharT,Traits> )