set (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 set per gestire una sequenza di elementi come (quasi) è bilanciato la struttura ad albero ordinato di nodi, ogni un elemento archiviante.

Nella descrizione di seguito, GValue sono gli stessi di GKey, che a sua volta è lo stesso di Key a meno che quest'ultimo sia un tipo di riferimento, nel qual caso viene Key^.

template<typename Key>
    ref class set
        :   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::ITree<Gkey, GValue>
    { ..... };

Parametri

Chiave
Tipo del componente chiave di un elemento nella sequenza controllata.

Membri

Definizione del tipo	Descrizione
set::const_iterator (STL/CLR)	Il tipo di iteratore costante per la sequenza selezionata.
set::const_reference (STL/CLR)	Il tipo di riferimento costante a un elemento.
set::const_reverse_iterator (STL/CLR)	Il tipo di iteratore inverso costante per la sequenza selezionata.
set::difference_type (STL/CLR)	Il tipo di distanza (possibilmente con segno) tra due elementi.
set::generic_container (STL/CLR)	Il tipo dell'interfaccia generica per il contenitore.
set::generic_iterator (STL/CLR)	il tipo di iteratore per l'interfaccia generica per il contenitore.
set::generic_reverse_iterator (STL/CLR)	il tipo di iteratore inverso per l'interfaccia generica per il contenitore.
set::generic_value (STL/CLR)	il tipo di elemento per l'interfaccia generica per il contenitore.
set::iterator (STL/CLR)	Il tipo di iteratore per la sequenza selezionata.
set::key_compare (STL/CLR)	Il delegato dell'ordine per due chiavi.
set::key_type (STL/CLR)	Il tipo di chiave di ordinamento.
set::reference (STL/CLR)	Il tipo di riferimento a un elemento.
set::reverse_iterator (STL/CLR)	Il tipo di iteratore inverso per la sequenza selezionata.
set::size_type (STL/CLR)	Il tipo di distanza (non negativa) di un oggetto tra due elementi.
set::value_compare (STL/CLR)	Il delegato dell'ordine per due valori dell'elemento.
set::value_type (STL/CLR)	Il tipo di elemento.

Funzione membro	Descrizione
set::begin (STL/CLR)	Definisce l'inizio della sequenza controllata.
set::clear (STL/CLR)	Rimuove tutti gli elementi.
set::count (STL/CLR)	Conta gli elementi che soddisfano una chiave specificata.
set::empty (STL/CLR)	Verifica se non sono presenti elementi presenti.
set::end (STL/CLR)	Definisce la fine della sequenza controllata.
set::equal_range (STL/CLR)	I trova variano che corrisponde a una chiave specificata.
set::erase (STL/CLR)	Rimuove gli elementi alle posizioni specificate.
set::find (STL/CLR)	Viene trovato un elemento che corrisponde alla chiave specificata.
set::insert (STL/CLR)	Aggiunge gli elementi.
set::key_comp (STL/CLR)	Copia il delegato dell'ordine per due chiavi.
set::lower_bound (STL/CLR)	Rileva l'inizio dell'intervallo che corrisponde a una chiave specificata.
set::make_value (STL/CLR)	Costruisce un oggetto di valore.
set::rbegin (STL/CLR)	Definisce l'inizio della sequenza inversa controllata.
set::rend (STL/CLR)	Definisce la fine della sequenza inversa controllata.
set::set (STL/CLR)	Costruisce un oggetto contenitore.
set::size (STL/CLR)	Conta il numero di elementi.
set::swap (STL/CLR)	Scambia il contenuto di due contenitori.
set::to_array (STL/CLR)	Copia la sequenza selezionata in una nuova matrice.
set::upper_bound (STL/CLR)	Fine di individuare di temporizzazione che corrisponde a una chiave specificata.
set::value_comp (STL/CLR)	Copia il delegato dell'ordine per due valori dell'elemento.

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

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.
ITree<chiave, valore>	gestire il contenitore generico.

Note

L'oggetto alloca e libera la memoria per la sequenza che controlla come singoli nodi.Inserisce gli elementi in un oggetto (quasi) non è bilanciato la struttura ad albero che lo mantiene ordinato 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.

l'oggetto ordina la sequenza che controlla chiamando un oggetto delegato archiviato di tipo set::key_compare (STL/CLR).È possibile specificare l'oggetto delegato archiviato quando si costruisce il set; se non si specifica oggetto delegato, l'impostazione predefinita è il confronto operator<(key_type, key_type).È possibile accedere a questo oggetto archiviato chiamando la funzione membro set::key_comp (STL/CLR)().

Tale oggetto delegato necessario imporre un ordine debole rigido le chiavi di tipo set::key_type (STL/CLR).Ciò significa, per due chiavi X e Y:

key_comp()(X, Y) restituisce lo stesso risultato booleano a ogni chiamata.

Se key_comp()(X, Y) è true, quindi key_comp()(Y, X) deve essere false.

Se key_comp()(X, Y) è true, quindi X sarebbe ordinato prima di Y.

Se !key_comp()(X, Y) && !key_comp()(Y, X) è true, quindi X e Y causate da avere ordine equivalente.

Per qualsiasi elemento X che precede Y nella sequenza selezionata, key_comp()(Y, X) è false.(Per l'oggetto delegato predefinito, chiavi non diminuiscono mai il valore.) A differenza della classe modello set (STL/CLR), un oggetto di classe modello set non richiede che le chiavi per tutti gli elementi siano univoche.(Due o più tasti possono avere ordine equivalente.)

Ogni elemento viene utilizzato sia ey che valore.La sequenza viene rappresentata in una modalità che consente la ricerca, l'inserimento e la rimozione di un elemento arbitrario attraverso una serie di operazioni proporzionali al logaritmo del numero di elementi della sequenza (tempo logaritmico).Inoltre, inserendo un elemento non invalida iteratori e la rimozione di un elemento invalida solo gli iteratori che puntano all'elemento rimosso.

Un set 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 set::end (STL/CLR)().È possibile diminuire questo iteratore per ottenere ultimo elemento nella sequenza selezionata, se presente.È possibile incrementare un iteratore stabilito 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 impostato direttamente in base alla posizione numerica -- ciò richiede un iteratore di accesso casuale.

Un iteratore stabilito memorizzare l'handle al nodo stabilito associato, che a sua volta memorizzare l'handle al relativo contenitore associato.È possibile utilizzare gli iteratori solo con i relativi oggetti contenitore associati.Un iteratore stabilito rimane valido a condizione che il relativo nodo stabilito associato sia associato a un determinato set.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.