vector (STL/CLR)

Articolo
06/10/2015

La classe modello descrive un oggetto che comandi di una sequenza variare lunghezza di elementi che ha accesso casuale. Utilizzare il contenitore vector per gestire una sequenza di elementi come blocco contiguo di archiviazione. Il blocco viene implementato come una matrice le cui dimensioni aumentano su richiesta.

In descrizione di seguito, GValue sono gli stessi di Value eccetto l'ultimo sia un tipo di riferimento, nel qual caso viene Value^.

template<typename Value>
    ref class vector
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        System::Collections::Generic::IList<GValue>,
        Microsoft::VisualC::StlClr::IVector<GValue>
    { ..... };

Parametri

Valore
Tipo di un elemento nella sequenza controllata.

Membri

Definizione del tipo	Descrizione
vector::const_iterator (STL/CLR)	Il tipo di un iteratore costante della sequenza controllata.
vector::const_reference (STL/CLR)	Il tipo di un riferimento costante a un elemento.
vector::const_reverse_iterator (STL/CLR)	Il tipo di iteratore inverso costante per la sequenza selezionata.
vector::difference_type (STL/CLR)	Il tipo di una distanza con segno tra due elementi.
vector::generic_container (STL/CLR)	Il tipo dell'interfaccia generica del contenitore.
vector::generic_iterator (STL/CLR)	Il tipo di iteratore per l'interfaccia generica del contenitore.
vector::generic_reverse_iterator (STL/CLR)	Il tipo di iteratore inverso per l'interfaccia generica del contenitore.
vector::generic_value (STL/CLR)	Il tipo di elemento dell'interfaccia generica del contenitore.
vector::iterator (STL/CLR)	Il tipo di un iteratore della sequenza controllata.
vector::reference (STL/CLR)	Il tipo di un riferimento a un elemento.
vector::reverse_iterator (STL/CLR)	Il tipo di iteratore inverso per la sequenza selezionata.
vector::size_type (STL/CLR)	Il tipo di una distanza con segno tra due elementi.
vector::value_type (STL/CLR)	Il tipo di un elemento.

Funzione membro	Descrizione
vector::assign (STL/CLR)	Sostituisce tutti gli elementi.
vector::at (STL/CLR)	Accede a un elemento in una posizione specificata.
vector::back (STL/CLR)	Accede all'ultimo.
vector::begin (STL/CLR)	Definisce l'inizio della sequenza controllata.
vector::capacity (STL/CLR)	Restituisce la dimensione dello spazio di memorizzazione allocato per il contenitore.
vector::clear (STL/CLR)	Rimuove tutti gli elementi.
vector::empty (STL/CLR)	Consente di verificare se non sono presenti elementi.
vector::end (STL/CLR)	Definisce la fine della sequenza controllata.
vector::erase (STL/CLR)	Rimuove gli elementi alle posizioni specificate.
vector::front (STL/CLR)	Accede al primo elemento.
vector::insert (STL/CLR)	Aggiunge elementi a una posizione specificata.
vector::pop_back (STL/CLR)	Rimuove l'ultimo elemento.
vector::push_back (STL/CLR)	Aggiunge un nuovo ultimo elemento.
vector::rbegin (STL/CLR)	Definisce l'inizio della sequenza inversa controllata.
vector::rend (STL/CLR)	Definisce la fine della sequenza inversa controllata.
vector::reserve (STL/CLR)	Fornisce una capacità minima di crescita del contenitore.
vector::resize (STL/CLR)	Modifica il numero di elementi.
vector::size (STL/CLR)	Conta il numero di elementi.
vector::swap (STL/CLR)	Scambia il contenuto di due contenitori.
vector::to_array (STL/CLR)	Copia la sequenza selezionata una nuova matrice.
vector::vector (STL/CLR)	Costruisce un oggetto contenitore.

Proprietà	Descrizione
vector::back_item (STL/CLR)	Accede all'ultimo.
vector::front_item (STL/CLR)	Accede al primo elemento.

Operatore	Descrizione
vector::operator= (STL/CLR)	Sostituisce la sequenza selezionata.
vector::operator[] (STL/CLR)	Accede a un elemento in una posizione specificata.
operator!= (vector) (STL/CLR)	Determina se un oggetto di vector non equivale a un altro oggetto di vector.
operator< (vector) (STL/CLR)	Determina se un oggetto di vector è inferiore a un altro oggetto di vector.
operator<= (vector) (STL/CLR)	Determina se un oggetto di vector è minore o uguale a un altro oggetto di vector.
operator== (vector) (STL/CLR)	Determina se un oggetto di vector equivale a un altro oggetto di vector.
operator> (vector) (STL/CLR)	Determina se un oggetto di vector è maggiore di un altro oggetto di vector.
operator>= (vector) (STL/CLR)	Determina se un oggetto di vector è maggiore o uguale a un altro oggetto di vector.

Interfacce

Interfaccia	Descrizione
ICloneable	Duplicare un oggetto.
IEnumerable	Sequenza degli elementi.
ICollection	Gestire il gruppo di elementi.
IEnumerable	Sequenza dagli elementi tipizzati.
ICollection	Gestire il gruppo di elementi tipizzati.
IList	Gestire il gruppo ordinato di elementi tipizzati.
IVectorValue<>	Gestire il contenitore generico.

Note

L'oggetto alloca e libera la memoria per la sequenza che controlla da una matrice archiviati gli elementi di Value, che aumenta su richiesta. La crescita si verifica in modo che il costo di aggiungere un nuovo elemento viene ammortizzato tempo costante. Ovvero i costi di aggiunta di elementi alla fine non aumenta, in media, poiché la lunghezza della sequenza selezionata ottiene più grande. Pertanto, un vettore è un buon candidato per il contenitore sottostante per classe modello stack (STL/CLR).

vector supporta gli iteratori di accesso casuale, è possibile fare riferimento a un elemento fornito direttamente la posizione numerica, contante da zero al primo elemento (precedente), a vector::size (STL/CLR)() - 1 per l'ultimo elemento (indietro. Significa anche che un vettore è un buon candidato per il contenitore sottostante per classe modello priority_queue (STL/CLR).

Un iteratore di vettore memorizzare l'handle al relativo oggetto collegato vettoriali, con la polarizzazione dell'elemento che definisce. È possibile utilizzare gli iteratori solo con i relativi oggetti contenitore collegati. La polarizzazione di un elemento vettoriale è la stessa della posizione.

L'inserimento o deselezionare items può modificare il valore dell'elemento archiviato in un percorso specificato, pertanto il valore definito da un iteratore può anche essere modificato. (Il contenitore può essere necessario copiare elementi verso l'alto o verso il basso per creare un foro prima di accodamento o per riempire un foro dopo un erase). Tuttavia, un iteratore di vettore rimane valido a condizione che la polarizzazione sia nell'intervallo [0, vector::size (STL/CLR)()]. Inoltre, un iteratore rimane valido dereferencable -- è possibile utilizzarlo per accedere e modificare il valore dell'elemento che definisce -- a condizione che la polarizzazione non sia uguale a size().

Clearing or rimozione di un elemento chiama il distruttore per il valore archiviato. Eliminare il contenitore di cancellare tutti gli elementi. Pertanto, un contenitore del cui tipo di elemento è una classe di riferimento garantisce che nessun elemento sopravviva il contenitore. Nota, tuttavia, che un contenitore handles fa not eliminato i relativi elementi.