vector (STL/CLR)

Article
06/07/2013

La classe de modèle décrit un objet qui contrôle une séquence de la longueur variée d'éléments qui a un accès aléatoire.Vous utilisez le conteneur vector pour gérer une séquence d'éléments comme un bloc contigu de stockage.Le bloc est implémenté comme un tableau qui se développe à la demande.

Dans la description ci-après, GValue est identique qu' Value à moins que ce dernier soit un type référence, auquel cas c'est 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>
    { ..... };

Paramètres

Valeur
Type d'un élément dans la séquence contrôlée.

Membres

Définition de type	Description
vector::const_iterator (STL/CLR)	Le type d'un itérateur constante pour la séquence contrôlée.
vector::const_reference (STL/CLR)	Le type d'une référence à une constante à un élément.
vector::const_reverse_iterator (STL/CLR)	Le type d'un itérateur inverse constante pour la séquence contrôlée.
vector::difference_type (STL/CLR)	Le type d'une distance signée entre deux éléments.
vector::generic_container (STL/CLR)	Le type de l'interface générique pour le conteneur.
vector::generic_iterator (STL/CLR)	Le type d'un itérateur pour l'interface générique pour le conteneur.
vector::generic_reverse_iterator (STL/CLR)	Le type d'un itérateur inverse pour l'interface générique pour le conteneur.
vector::generic_value (STL/CLR)	Le type d'un élément de l'interface générique pour le conteneur.
vector::iterator (STL/CLR)	Le type d'un itérateur pour la séquence contrôlée.
vector::reference (STL/CLR)	Le type d'une référence à un élément.
vector::reverse_iterator (STL/CLR)	Le type d'un itérateur inverse pour la séquence contrôlée.
vector::size_type (STL/CLR)	Le type d'une distance signée entre deux éléments.
vector::value_type (STL/CLR)	Le type d'un élément.

Fonction membre	Description
vector::assign (STL/CLR)	Remplace tous les éléments.
vector::at (STL/CLR)	Accède à un élément à la position spécifiée.
vector::back (STL/CLR)	Accède au dernier élément.
vector::begin (STL/CLR)	Désigne le début de la séquence contrôlée.
vector::capacity (STL/CLR)	Signale la taille de l'espace de stockage alloué pour le conteneur.
vector::clear (STL/CLR)	Supprime tous les éléments.
vector::empty (STL/CLR)	Teste si aucun élément n'est présent.
vector::end (STL/CLR)	Désigne la fin de la séquence contrôlée.
vector::erase (STL/CLR)	Supprime les éléments placés aux positions spécifiées.
vector::front (STL/CLR)	Accède au premier élément.
vector::insert (STL/CLR)	Ajoute des éléments à une position spécifiée.
vector::pop_back (STL/CLR)	Supprime le dernier élément.
vector::push_back (STL/CLR)	Ajoute un nouveau dernier élément.
vector::rbegin (STL/CLR)	Désigne le début de la séquence contrôlée inversée.
vector::rend (STL/CLR)	Désigne la fin de la séquence contrôlée inversée.
vector::reserve (STL/CLR)	Garantit une capacité minimum de croissance pour le conteneur.
vector::resize (STL/CLR)	Change le nombre d'éléments.
vector::size (STL/CLR)	Compte le nombre d'éléments.
vector::swap (STL/CLR)	Échange le contenu de deux conteneurs.
vector::to_array (STL/CLR)	Copie la séquence contrôlée à un nouveau tableau.
vector::vector (STL/CLR)	Construit un objet.

Property	Description
vector::back_item (STL/CLR)	Accède au dernier élément.
vector::front_item (STL/CLR)	Accède au premier élément.

Opérateur	Description
vector::operator= (STL/CLR)	Remplace la séquence contrôlée.
vector::operator[] (STL/CLR)	Accède à un élément à la position spécifiée.
operator!= (vector) (STL/CLR)	Détermine si un objet d' vector n'est pas égal à un autre objet d' vector .
operator< (vector) (STL/CLR)	Détermine si un objet d' vector est inférieure un autre objet d' vector .
operator<= (vector) (STL/CLR)	Détermine si un objet d' vector est inférieur ou égal à un autre objet d' vector .
operator== (vector) (STL/CLR)	Détermine si un objet d' vector équivaut à un autre objet d' vector .
operator> (vector) (STL/CLR)	Détermine si un objet d' vector est supérieur à un autre objet d' vector .
operator>= (vector) (STL/CLR)	Détermine si un objet d' vector est supérieure ou égale à un autre objet d' vector .

Interfaces

Interface	Description
ICloneable	Dupliquez un objet.
IEnumerable	Séquence de parcourir les éléments.
ICollection	Maintenez le groupe d'éléments.
IEnumerable<T>	Séquence par des éléments typés.
ICollection<T>	Maintenez le groupe d'éléments typés.
IList<T>	Maintenez le groupe dimensionné d'éléments typés.
IVector<valeur>	Maintenez le conteneur générique.

Notes

L'objet alloue et libère le stockage pour la séquence qu'elle contrôle via un tableau stocké d'éléments d' Value , qui se développe à la demande.La croissance se produit de manière à réduire le coût d'ajouter un élément en amorti temps fixe.En d'autres termes, le coût d'ajout d'éléments à la fin n'augmente pas, en moyenne, car la longueur de la séquence contrôlée devient plus grande.Ainsi, un vecteur est un bon candidat pour le conteneur sous-jacent pour la classe de modèle stack (STL/CLR).

vector prend en charge des itérateurs d'accès aléatoire, ce qui signifie que vous pouvez faire référence à un élément directement donné sa position numérique, compter de zéro pour le premier élément (avant), à vector::size (STL/CLR)() - 1 pour le dernier élément (back).Cela signifie également qu'un vecteur est un bon candidat pour le conteneur sous-jacent pour la classe de modèle priority_queue (STL/CLR).

Un itérateur vectoriels enregistre un handle à son objet vectoriels associé, avec la écart de l'élément qu'elle désigne.Vous pouvez utiliser des itérateurs uniquement avec leurs objets conteneurs associés.La écart d'un élément vectoriels est la même que sa position.

Insérer ou effacer les éléments peut modifier la valeur d'élément stockée à une position donnée, donc la valeur indiquée par un itérateur peut également être modifiée.(Le conteneur peut devoir copier des éléments vers le haut ou vers le bas pour créer une faille avant une insertion ou pour remplir une faille après un effacer.) Néanmoins, un itérateur vectoriels reste valide tant que son écart soit dans la plage [0,vector::size (STL/CLR)()].De plus, un itérateur valide reste dereferencable -- vous pouvez l'utiliser pour accéder ou modifier sa valeur d'élément qu'il indique -- à condition que son écart ne soit pas égale à size().

Effaçant ou suppression d'un élément appelle le destructeur de sa valeur stockée.Détruire le conteneur efface tous les éléments.Ainsi, un conteneur dont le type d'élément est une classe de référence garantit qu'élément ne survit pas au conteneur.La notez, cependant, un conteneur de handles fait not destroy ses éléments.