Libreria Forward_list C ++ - Funzione cbefore_begin ()

Descrizione

La funzione C ++ std::forward_list::cbefore_begin() restituisce un iteratore ad accesso casuale costante che punta alla posizione prima del primo elemento di forward_list.

Questo iteratore può essere utilizzato con emplace_after , erase_after , insert_after e splice_after .

L'iteratore ottenuto da questa funzione membro può essere utilizzato per iterare il contenitore ma non può essere utilizzato per modificare il contenuto dell'oggetto a cui punta anche se l'oggetto stesso non è costante.

Dichiarazione

Di seguito è riportata la dichiarazione per l'intestazione std :: forward_list :: cbefore_begin () della funzione std :: forward_list.

C ++ 11

const_iterator cbefore_begin() const noexcept;

Parametri

Nessuna

Valore di ritorno

Restituisce un iteratore ad accesso casuale costante.

Eccezioni

Questa funzione membro non genera mai eccezioni.

Complessità temporale

Costante cioè O (1)

Esempio

L'esempio seguente mostra l'utilizzo della funzione std :: forward_list :: cbefore_begin ().

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl = {2, 3, 4, 5};
   auto it = fl.cbefore_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;
}

Compiliamo ed eseguiamo il programma sopra, questo produrrà il seguente risultato:

List contains following elements
1
2
3
4
5