list (STL/CLR)

Articolo
06/07/2013

La classe modello vengono descritti un oggetto e controlli di una sequenza variare lunghezza di elementi che ha accesso bidirezionale.Si utilizza il contenitore list per gestire una sequenza di elementi come elenco collegato bidirezionale di nodi, ogni un elemento archiviante.

Nella descrizione di seguito, GValue sono gli stessi di Value a meno che quest'ultimo sia un tipo di riferimento, nel qual caso viene Value^.

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

Parametri

Valore
Tipo di un elemento nella sequenza controllata.

Membri

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

Funzione membro	Descrizione
list::assign (STL/CLR)	Sostituire tutti gli elementi.
list::back (STL/CLR)	Accede all'ultimo elemento.
list::begin (STL/CLR)	Definisce l'inizio della sequenza controllata.
list::clear (STL/CLR)	Rimuove tutti gli elementi.
list::empty (STL/CLR)	Verifica se non sono presenti elementi presenti.
list::end (STL/CLR)	Definisce la fine della sequenza controllata.
list::erase (STL/CLR)	Rimuove gli elementi alle posizioni specificate.
list::front (STL/CLR)	Accede al primo elemento.
list::insert (STL/CLR)	Aggiunge elementi a una posizione specificata.
list::list (STL/CLR)	Costruisce un oggetto contenitore.
list::merge (STL/CLR)	Unisce due sequenze controllate ordinate.
list::pop_back (STL/CLR)	Rimuove l'ultimo elemento.
list::pop_front (STL/CLR)	Rimuove il primo elemento.
list::push_back (STL/CLR)	Aggiunge un nuovo l'ultimo elemento.
list::push_front (STL/CLR)	Aggiunge un nuovo primo elemento.
list::rbegin (STL/CLR)	Definisce l'inizio della sequenza inversa controllata.
list::remove (STL/CLR)	Rimuove un elemento con un valore specificato.
list::remove_if (STL/CLR)	Rimuove gli elementi che superano un determinato test.
list::rend (STL/CLR)	Definisce la fine della sequenza inversa controllata.
list::resize (STL/CLR)	Modifica il numero di elementi.
list::reverse (STL/CLR)	Inverte la sequenza selezionata.
list::size (STL/CLR)	Conta il numero di elementi.
list::sort (STL/CLR)	Ordina la sequenza controllata.
list::splice (STL/CLR)	Collegamenti di Restitches tra i nodi.
list::swap (STL/CLR)	Scambia il contenuto di due contenitori.
list::to_array (STL/CLR)	Copia la sequenza selezionata in una nuova matrice.
list::unique (STL/CLR)	Rimuove elementi adiacenti che superano un test specificato.

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

Operatore	Descrizione
list::operator= (STL/CLR)	Sostituisce la sequenza selezionata.
operator!= (list) (STL/CLR)	Determina se un oggetto di list non è uguale a un altro oggetto di list .
operator< (list) (STL/CLR)	Determina se un oggetto di list è inferiore a un altro oggetto di list .
operator<= (list) (STL/CLR)	Determina se un oggetto di list è minore o uguale a un altro oggetto di list .
operator== (list) (STL/CLR)	Determina se un oggetto di list equivale a un altro oggetto di list .
operator> (list) (STL/CLR)	Determina se un oggetto di list è maggiore di un altro oggetto di list .
operator>= (list) (STL/CLR)	Determina se un oggetto di list è maggiore o uguale a un altro oggetto di list .

Interfacce

Interfaccia	Descrizione
ICloneable	Clonare un oggetto.
IEnumerable	Sequenza degli elementi.
ICollection	gestire il gruppo di elementi.
IEnumerable<T>	Sequenza degli elementi tipizzati.
ICollection<T>	gestire il gruppo di elementi tipizzati.
IList<valore>	gestire il contenitore generico.

Note

L'oggetto alloca e libera la memoria per la sequenza che controlla mentre i singoli nodi in un collegamento bidirezionaleelenco.Consente di ridisporre gli elementi modifica dei collegamenti tra i nodi, mai copiando il contenuto di un nodo a un altro.Ciò significa che è possibile inserire liberamente e rimuovere elementi senza alterare gli elementi rimanenti.Pertanto, un elenco è un buon candidato per il contenitore sottostante per una classe modello queue (STL/CLR) o classe modello stack (STL/CLR).

Un oggetto di list supporta gli iteratori bidirezionali, è possibile avanzare agli elementi adiacenti fornito un iteratore che definisce un elemento nella sequenza selezionata.Un nodo head speciale corrisponde all'iteratore restituito da list::end (STL/CLR)().È possibile diminuire questo iteratore per ottenere ultimo elemento nella sequenza selezionata, se presente.È possibile incrementare un iteratore elenco per ottenere il nodo head quindi confronta uguale a end().Ma non è possibile dereferenziare l'iteratore restituito da end().

Si noti che non è possibile fare riferimento a un elemento di elenco direttamente in base alla posizione numerica -- ciò richiede un iteratore di accesso casuale.Pertanto un elenco è not utilizzabile come elenco sottostante per una classe modello priority_queue (STL/CLR).

Un iteratore di memorizzare l'handle al nodo associato elenco, che a sua volta memorizzare l'handle al relativo contenitore associato.È possibile utilizzare gli iteratori solo con i relativi oggetti contenitore associati.Un iteratore elenco rimane valido a condizione che il relativo nodo associato elenco sia associato a un elenco.inoltre, un iteratore valido è dereferencable -- è possibile utilizzarlo per accedere e modificare il valore dell'elemento che definisce -- a condizione che non sia uguale a end().

Cancellando o la rimozione di un elemento chiama il distruttore per il valore archiviato.Eliminare il contenitore di cancellare tutti gli elementi.Pertanto, un contenitore del tipo di elemento è una classe di riferimento garantisce che nessun elemento terminazione il contenitore.Si noti, tuttavia, che un contenitore di handle fa not elimina i relativi elementi.