Bibliothèque C ++ Forward_list - fonction before_begin ()

La description

La fonction C ++ std::forward_list::before_begin() renvoie un itérateur à accès aléatoire qui pointe vers la position avant le premier élément de la forward_list.

Cet itérateur peut être utilisé avec emplace_after , erase_after , insert_after et splice_after .

Déclaration

Voici la déclaration de la fonction std :: forward_list :: before_begin () de l'en-tête std :: forward_list.

C ++ 11

iterator before_begin() noexcept;
const_iterator before_begin() const noexcept;

Paramètres

Aucun

Valeur de retour

Si l'objet forward_list est qualifié de constante, la méthode retourne un itérateur d'accès aléatoire constant, sinon un itérateur d'accès aléatoire non constant.

Exceptions

Cette fonction membre ne lève jamais d'exception.

Complexité temporelle

Constante ie O (1)

Exemple

L'exemple suivant montre l'utilisation de la fonction std :: forward_list :: before_begin ().

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl = {2, 3, 4, 5};
   auto it = fl.before_begin();

   fl.insert_after(it, 1);

   cout << "List contains following elements" << endl;

   for (auto it = fl.begin(); it != fl.end(); ++it)
      cout << *it << endl;

   return 0;
}

Compilons et exécutons le programme ci-dessus, cela produira le résultat suivant -

List contains following elements
1
2
3
4
5