Namespaces
Variants

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

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

Renvoie 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.
  • Si l'implémentation n'est pas durcie, le comportement est indéfini.
(depuis C++26)

Valeur de retour

operator [ ] ( 0 )

Complexité

Constante.

Notes

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

Exemple

#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> )