list (STL/CLR)

Artículo
06/07/2013

La clase de plantilla describe un objeto que controla una secuencia de la variar-longitud de elementos con acceso bidireccional.Utiliza el contenedor list para administrar una secuencia de elementos como una lista vinculada bidireccional de nodos, cada un elemento que almacena.

En la descripción siguiente, GValue es igual que Value a menos que este último es un tipo de referencia, en este caso es 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>
    { ..... };

Parámetros

Valor
Tipo de un elemento de la secuencia controlada.

Members

Definición de tipo	Descripción
list::const_iterator (STL/CLR)	El tipo de un iterador constante para la secuencia controlada.
list::const_reference (STL/CLR)	El tipo de una referencia constante a un elemento.
list::const_reverse_iterator (STL/CLR)	El tipo de un iterador inverso constante para la secuencia controlada.
list::difference_type (STL/CLR)	El tipo de una distancia firmados entre dos elementos.
list::generic_container (STL/CLR)	El tipo de interfaz genérica para el contenedor.
list::generic_iterator (STL/CLR)	El tipo de un iterador para la interfaz genérica para el contenedor.
list::generic_reverse_iterator (STL/CLR)	El tipo de un iterador inverso para la interfaz genérica para el contenedor.
list::generic_value (STL/CLR)	El tipo de un elemento de la interfaz genérica para el contenedor.
list::iterator (STL/CLR)	El tipo de un iterador para la secuencia controlada.
list::reference (STL/CLR)	El tipo de una referencia a un elemento.
list::reverse_iterator (STL/CLR)	El tipo de un iterador inverso para la secuencia controlada.
list::size_type (STL/CLR)	El tipo de una distancia firmados entre dos elementos.
list::value_type (STL/CLR)	El tipo de un elemento.

Función miembro	Descripción
list::assign (STL/CLR)	Reemplaza todos los elementos.
list::back (STL/CLR)	Tiene acceso al último elemento.
list::begin (STL/CLR)	Designa el principio de la secuencia controlada.
list::clear (STL/CLR)	Quita todos los elementos.
list::empty (STL/CLR)	Comprueba si no hay elementos presentes.
list::end (STL/CLR)	Designa el final de la secuencia controlada.
list::erase (STL/CLR)	Quita los elementos en las posiciones especificadas.
list::front (STL/CLR)	Tiene acceso al primer elemento.
list::insert (STL/CLR)	Agrega elementos en una posición especificada.
list::list (STL/CLR)	Construye un objeto contenedor.
list::merge (STL/CLR)	Combina dos secuencias controladas ordenadas.
list::pop_back (STL/CLR)	Quita el último elemento.
list::pop_front (STL/CLR)	Quita el primer elemento.
list::push_back (STL/CLR)	Agrega un nuevo elemento pasado.
list::push_front (STL/CLR)	Agrega un nuevo primero.
list::rbegin (STL/CLR)	Designa el principio de la secuencia controlada inversa.
list::remove (STL/CLR)	Quita un elemento con un valor especificado.
list::remove_if (STL/CLR)	Quita los elementos que pasan una prueba especificada.
list::rend (STL/CLR)	Designa el final de la secuencia controlada inversa.
list::resize (STL/CLR)	Cambia el número de elementos.
list::reverse (STL/CLR)	Invierte la secuencia controlada.
list::size (STL/CLR)	Cuenta el número de elementos.
list::sort (STL/CLR)	Ordena la secuencia controlada.
list::splice (STL/CLR)	Vínculos de Restitches entre nodos.
list::swap (STL/CLR)	Intercambia el contenido de dos contenedores.
list::to_array (STL/CLR)	Copia la secuencia controlada a una nueva matriz.
list::unique (STL/CLR)	Quita los elementos adyacentes que pasan una prueba especificada.

Propiedad.	Descripción
list::back_item (STL/CLR)	Tiene acceso al último elemento.
list::front_item (STL/CLR)	Tiene acceso al primer elemento.

Operador	Descripción
list::operator= (STL/CLR)	Reemplaza la secuencia controlada.
operator!= (list) (STL/CLR)	Determina si un objeto de list no es igual a otro objeto de list .
operator< (list) (STL/CLR)	Determina si un objeto de list es menor que otro objeto de list .
operator<= (list) (STL/CLR)	Determina si un objeto de list menor o igual que otro objeto de list .
operator== (list) (STL/CLR)	Determina si un objeto de list es igual a otro objeto de list .
operator> (list) (STL/CLR)	Determina si un objeto de list es mayor que otro objeto de list .
operator>= (list) (STL/CLR)	Determina si un objeto de list mayor o igual que otro objeto de list .

Interfaces

Interfaz	Descripción
ICloneable	Dupliquen un objeto.
IEnumerable	Secuencia a través de los elementos.
ICollection	Mantenga el grupo de elementos.
IEnumerable<T>	Secuencia mediante elementos escritos.
ICollection<T>	Mantenga el grupo de elementos escritos.
IList<Valor>	Mantenga el contenedor genérico.

Comentarios

El objeto asigna y libera el almacenamiento de la secuencia que controla mientras los nodos individuales en una lista bidireccional de vínculo.Reorganiza elementos modificando los vínculos entre los nodos, nunca copiando el contenido de un nodo a otro.Eso significa que puede insertar y quitar elementos libremente sin elementos restantes que modifican.Así, una lista es una buena candidata al contenedor subyacente para la clase de plantilla queue (STL/CLR) o clase de plantilla stack (STL/CLR).

Un objeto de list admite iteradores bidireccionales, que significa que se puede pasar a los elementos adyacentes dado un iterador que señale un elemento de la secuencia controlada.Un nodo principal especial corresponde al iterador devuelto por list::end (STL/CLR)().Puede reducir este iterador para lograr el último elemento de la secuencia controlada, si existe.Puede incrementar un iterador de la lista para lograr el nodo principal, y a continuación comparará el igual a end().Pero no puede desreferenciar el iterador devuelto por end().

Observe que no puede hacer referencia a un elemento de la lista determinado directamente su posición numérica -- esto requiere un iterador de acceso aleatorio.Una lista es tan not utilizable como el contenedor subyacente para la clase de plantilla priority_queue (STL/CLR).

Un iterador de la lista almacena un identificador al nodo asociado de la lista, que a su vez almacena un identificador para el contenedor asociado.Puede usar iteradores únicamente con los objetos contenedores asociado.Un iterador de la lista sigue siendo válido siempre y cuando el nodo asociado de la lista está asociado con alguna lista.Por otra parte, un iterador válido es dereferencable -- puede utilizarlo para obtener acceso o modificar el valor del elemento que señala -- siempre y cuando no es igual a end().

Borrar o quitar un elemento denomina destructor por el valor almacenado.Destruyendo el contenedor borra todos los elementos.Así, un contenedor cuyo tipo de elemento es una clase de referencia se asegura que ningún elemento sobrevivan al contenedor.La nota, sin embargo, que un contenedor de identificadores hace not destruye sus elementos.