Namespaces
Variants

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

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

Retourne une référence au premier caractère de la chaîne.

Si empty() est true , le comportement est indéfini.

(jusqu'à C++26)

Si empty() est true :

  • Si l'implémentation est durcie , une violation de contrat se produit. De plus, si le gestionnaire de violation de contrat retourne sous la sémantique d'évaluation "observer", le comportement est indéfini.
  • Si l'implémentation n'est pas durcie, le comportement est indéfini.
(depuis C++26)

Table des matières

Valeur de retour

operator [ ] ( 0 )

Complexité

Constante.

Notes

Dans libstdc++, front() est non disponible en mode C++98.

Exemple

Exécuter ce code 
#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"
}

Sortie : 

exemplary
Exemplary

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR Appliqué à Comportement publié Comportement corrigé
LWG 534 C++98 std::basic_string ne possédait pas la fonction membre front() ajoutée

Voir aussi

( DR* )
accède au dernier caractère
(fonction membre publique)
accède au premier caractère
(fonction membre publique de std::basic_string_view<CharT,Traits> )