list (STL/CLR)

Articolo
06/10/2015

La classe modello descrive un oggetto che comandi di una sequenza variare lunghezza di elementi che ha accesso bidirezionale. Utilizzare il contenitore list per gestire una sequenza di elementi come elenco collegato bidirezionale di nodi, ogni un elemento archiviando.

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 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 un iteratore costante della sequenza controllata.
list::const_reference (STL/CLR)	Il tipo di un 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 una distanza con segno tra due elementi.
list::generic_container (STL/CLR)	Il tipo dell'interfaccia generica del contenitore.
list::generic_iterator (STL/CLR)	Il tipo di iteratore per l'interfaccia generica del contenitore.
list::generic_reverse_iterator (STL/CLR)	Il tipo di iteratore inverso per l'interfaccia generica del contenitore.
list::generic_value (STL/CLR)	Il tipo di elemento dell'interfaccia generica del contenitore.
list::iterator (STL/CLR)	Il tipo di un iteratore della sequenza controllata.
list::reference (STL/CLR)	Il tipo di un 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 una distanza con segno tra due elementi.
list::value_type (STL/CLR)	Il tipo di un elemento.

Funzione membro	Descrizione
list::assign (STL/CLR)	Sostituisce tutti gli elementi.
list::back (STL/CLR)	Accede all'ultimo.
list::begin (STL/CLR)	Definisce l'inizio della sequenza controllata.
list::clear (STL/CLR)	Rimuove tutti gli elementi.
list::empty (STL/CLR)	Consente di verificare se non sono presenti elementi.
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 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)	L'inversione della sequenza selezionata.
list::size (STL/CLR)	Conta il numero di elementi.
list::sort (STL/CLR)	Ordina la sequenza controllata.
list::splice (STL/CLR)	Raggruppa i collegamenti tra i nodi.
list::swap (STL/CLR)	Scambia il contenuto di due contenitori.
list::to_array (STL/CLR)	Copia la sequenza selezionata 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.
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 equivale 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	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.
IListValue<>	Gestire il contenitore generico.

Note

L'oggetto alloca e libera la memoria per la sequenza che controlla mentre i singoli nodi in un collegamento bidirezionale l'elenco. Ridisporre gli elementi cambiando i collegamenti tra i nodi, mai copiando il contenuto di un nodo a un altro. Ciò significa che è possibile inserire liberamente e rimuovere elementi senza pregiudicare gli elementi rimanenti. Pertanto, un elenco è un buon candidato per il contenitore sottostante per 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 l'ultimo elemento della sequenza selezionata, se presente. È possibile incrementare un iteratore di elenco per ottenere il nodo head quindi confronterà il segno di uguale a end(). Ma non è possibile dereferenziare l'iteratore restituito da end().

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

Un iteratore di elenco memorizzare l'handle al nodo dell'elenco collegato, che a sua volta memorizzare l'handle al relativo contenitore collegato. È possibile utilizzare gli iteratori solo con i relativi oggetti contenitore collegati. Un iteratore di elenco rimane valido a condizione che il relativo nodo collegato 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().

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.