<iterator>

  • Articolo

Definisce iteratori predefiniti e iteratori di flusso, primitive iteratore e modelli di supporto.

Requisiti

Intestazione: <iterator>

Spazio dei nomi: std

Osservazioni:

Gli iteratori sono una generalizzazione di puntatori che consentono a un programma C++ di lavorare con strutture di dati diverse in modo uniforme. Anziché operare su tipi di dati specifici, gli algoritmi operano su un intervallo di valori come specificato da un tipo di iteratore. Gli algoritmi possono operare su qualsiasi struttura di dati che soddisfi i requisiti dell'iteratore.

In C++20 sono disponibili sei categorie di iteratori. Gli iteratori sono disposti in una gerarchia di funzionalità. Le relative funzionalità sono specificate dai concetti di C++20. Per una descrizione dei vari iteratori e delle relative funzionalità, vedere Concetti relativi agli iteratori

Visual Studio ha aggiunto estensioni agli iteratori della libreria standard C++ per supportare il debug per gli iteratori controllati e deselezionati. Per altre informazioni, vedere Librerie protette: libreria standard.

Membri

Funzioni

Nome Descrizione
advance Incrementa un iteratore di un numero specificato di posizioni.
back_inserter Crea un iteratore in grado di inserire gli elementi nella parte finale di un contenitore specificato.
begin Recupera un iteratore al primo elemento di un contenitore specificato.
cbegin Recupera un iteratore di sola lettura nel primo elemento di un contenitore specificato.
cend Recupera un iteratore di sola lettura all'elemento che segue l'ultimo elemento nel contenitore specificato.
crbegin Ottiene un iteratore di sola lettura inverso all'inizio del contenitore specificato.
crend Ottenere l'sentinel alla fine di ciò che crbegin() restituisce.
data Ottenere un puntatore al primo elemento nel contenitore specificato.
distance Determina il numero di incrementi tra le posizioni a cui puntano due iteratori.
end Recupera un iteratore all'elemento successivo all'ultimo elemento nel contenitore specificato.
empty Verificare se il contenitore specificato è vuoto.
front_inserter Crea un iteratore in grado di inserire elementi all'inizio di un contenitore specificato.
inserter Adattatore dell'iteratore che aggiunge un nuovo elemento a un contenitore in corrispondenza di un punto di inserimento specificato.
make_checked_array_iterator Crea un oggetto checked_array_iterator che può essere utilizzato da altri algoritmi. Nota: questa funzione è un'estensione Microsoft della libreria standard C++. Il codice implementato tramite questa funzione non è portabile in ambienti di compilazione C++ Standard che non supportano questa estensione Microsoft.
make_move_iterator Restituisce un iteratore di spostamento contenente l'iteratore fornito come relativo iteratore di base archiviato.
make_unchecked_array_iterator Crea un oggetto unchecked_array_iterator che può essere utilizzato da altri algoritmi. Nota: questa funzione è un'estensione Microsoft della libreria standard C++. Il codice implementato tramite questa funzione non è portabile in ambienti di compilazione C++ Standard che non supportano questa estensione Microsoft.
next Esegue l'iterazione per un numero specificato di volte e restituisce la nuova posizione dell'iteratore.
prev Esegue l'iterazione in ordine inverso per un numero specificato di volte e restituisce la nuova posizione dell'iteratore.
rbegin Ottenere un iteratore inverso all'inizio del contenitore specificato.
rend Ottenere un iteratore inverso nella sentinella alla fine del contenitore specificato.
size Ottiene il numero di elementi.

Operatori

Nome Descrizione
operator!= Verifica se l'oggetto iteratore a sinistra dell'operatore non è uguale all'oggetto iteratore a destra.
operator== Verifica se l'oggetto iteratore a sinistra dell'operatore è uguale all'oggetto iteratore a destra.
operator< Verifica se l'oggetto iteratore a sinistra dell'operatore è minore all'oggetto iteratore a destra.
operator<= Verifica se l'oggetto iteratore a sinistra dell'operatore è minore o uguale all'oggetto iteratore a destra.
operator> Verifica se l'oggetto iteratore a sinistra dell'operatore è maggiore dell'oggetto iteratore a destra.
operator>= Verifica se l'oggetto iteratore a sinistra dell'operatore è maggiore o uguale all'oggetto iteratore a destra.
operator+ Aggiunge un offset a un iteratore e restituisce il nuovo reverse_iterator che punta all'elemento inserito in corrispondenza della nuova posizione dell'offset.
operator- Sottrae un iteratore da un altro e restituisce la differenza.

Classi

Nome Descrizione
back_insert_iterator Il modello di classe descrive un oggetto iteratore di output. Inserisce gli elementi in un contenitore di tipo Container, a cui accede tramite l'oggetto protetto pointer archiviato denominato contenitore.
bidirectional_iterator_tag Classe che fornisce un tipo restituito per una iterator_category funzione che rappresenta un iteratore bidirezionale.
checked_array_iterator Classe che accede a una matrice mediante un iteratore verificato ad accesso causale. Nota: questa classe è un'estensione Microsoft della libreria standard C++. Il codice implementato tramite questa funzione non è portabile in ambienti di compilazione C++ Standard che non supportano questa estensione Microsoft.
forward_iterator_tag Classe che fornisce un tipo restituito per una iterator_category funzione che rappresenta un iteratore in avanti.
front_insert_iterator Il modello di classe descrive un oggetto iteratore di output. Inserisce gli elementi in un contenitore di tipo Container, a cui accede tramite l'oggetto protetto pointer archiviato denominato contenitore.
input_iterator_tag Classe che fornisce un tipo restituito per una iterator_category funzione che rappresenta un iteratore di input.
insert_iterator Il modello di classe descrive un oggetto iteratore di output. Inserisce gli elementi in un contenitore di tipo Container, a cui accede tramite l'oggetto protetto pointer archiviato denominato contenitore. Archivia anche l'oggetto protetto iterator , della classe Container::iterator, denominata iter.
istream_iterator Il modello di classe descrive un oggetto iteratore di input. Estrae oggetti della classe Ty da un flusso di input a cui accede tramite un oggetto archiviato, di tipo puntatore a basic_istream<Elem, Tr>.
istreambuf_iterator Il modello di classe descrive un oggetto iteratore di input. Inserisce elementi della classe Elem in un buffer del flusso di output a cui accede tramite un oggetto archiviato, di tipo pointer .basic_streambuf<Elem, Tr>
iterator Il modello di classe viene usato come tipo di base per tutti gli iteratori.
iterator_traits Classe helper del modello che fornisce tipi critici associati a diversi tipi di iteratori in modo che sia possibile fare riferimento a essi nello stesso modo.
move_iterator Un oggetto move_iterator consente di archiviare un iteratore ad accesso casuale di tipo RandomIterator. Si comporta come un iteratore ad accesso casuale, salvo quando viene dereferenziato. Viene eseguito il cast in modo implicito del risultato di operator* a value_type&&: per creare un rvalue reference.
ostream_iterator Il modello di classe descrive un oggetto iteratore di output. Inserisce oggetti della classe Type in un flusso di output a cui accede tramite un oggetto archiviato, di tipo pointer basic_ostream<Elem, Tr>.
ostreambuf_iterator Il modello di classe descrive un oggetto iteratore di output. Inserisce elementi della classe Elem in un buffer del flusso di output a cui accede tramite un oggetto archiviato, di tipo puntatore a basic_streambuf<Elem, Tr>.
output_iterator_tag Classe che fornisce un tipo restituito per iterator_category la funzione che rappresenta un iteratore di output.
random_access_iterator_tag Classe che fornisce un tipo restituito per iterator_category la funzione che rappresenta un iteratore ad accesso casuale.
reverse_iterator Il modello di classe descrive un oggetto che si comporta come un iteratore ad accesso casuale, solo inverso.
unchecked_array_iterator Classe che accede a una matrice mediante un iteratore ad accesso causale non verificato. Nota: questa classe è un'estensione Microsoft della libreria standard C++. Il codice implementato tramite questa funzione non è portabile in ambienti di compilazione C++ Standard che non supportano questa estensione Microsoft.

Concetti

I concetti seguenti sono definiti nello spazio dei std nomi . Si applicano agli iteratori e sono correlati anche alle categorie di iteratori per gli intervalli descritti nei <ranges> concetti.

Concetto di iteratore Descrizione
bidirectional_iteratorC++20 Specifica un iteratore in grado di leggere e scrivere sia avanti che indietro.
contiguous_iteratorC++20 Specifica un iteratore i cui elementi sono sequenziali in memoria, le stesse dimensioni e possono essere accessibili usando l'aritmetica del puntatore.
forward_iteratorC++20 Specifica un iteratore in grado di leggere (ed eventualmente scrivere) più volte.
input_iteratorC++20 Specifica un iteratore da cui è possibile leggere almeno una volta.
input_or_output_iteratorC++20 Base della tassonomia del concetto di iteratore.
output_iterator Specifica un iteratore in cui è possibile scrivere.
random_access_iteratorC++20 Specifica un iteratore che è possibile leggere e scrivere in base all'indice.
sentinel_forC++20 Specifica un sentinel per un tipo di iteratore.
sized_sentinel_forC++20 Specifica che un iteratore e il relativo sentinella possono essere sottratti (usando -) per trovare la differenza nel tempo costante.

Vedi anche

Riferimento file di intestazione
Thread Safety in the C++ Standard Library (Sicurezza dei thread nella libreria standard C++)
Informazioni di riferimento per la libreria standard C++