list (STL/CLR)

Článek
06/10/2015

Třída šablony popisuje objekt, který ovládá různé délky posloupnost prvků, která má obousměrný přístup.Použití kontejneru list ke správě pořadí prvků jako obousměrné propojený seznam uzlů, každý ukládání jednoho prvku.

V popisu níže GValue je stejný jako Value Pokud je typ odkazu, v takovém případě je 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>
    { ..... };

Parametry

Value
Typ prvek v kontrolovaných sekvenci.

Členy

Definice typu	Popis
list::const_iterator (STL/CLR)	Typ konstantního iterátoru řízené sekvence.
list::const_reference (STL/CLR)	Typ konstantního odkazu na prvek.
list::const_reverse_iterator (STL/CLR)	Typ konstantní zpětného iterátor pro řízené sekvenci.
list::difference_type (STL/CLR)	Typ vzdálenosti se znaménkem mezi dvěma prvky.
list::generic_container (STL/CLR)	Typ obecné rozhraní pro kontejner.
list::generic_iterator (STL/CLR)	Typ iterátor pro obecné rozhraní pro kontejner.
list::generic_reverse_iterator (STL/CLR)	Typ zpětného iterátor pro obecné rozhraní pro kontejner.
list::generic_value (STL/CLR)	Typ elementu pro obecné rozhraní pro kontejner.
list::iterator (STL/CLR)	Typ iterátoru řízené sekvence.
list::reference (STL/CLR)	Typ odkazu na prvek.
list::reverse_iterator (STL/CLR)	Typ zpětného iterátor pro řízené sekvenci.
list::size_type (STL/CLR)	Typ vzdálenosti se znaménkem mezi dvěma prvky.
list::value_type (STL/CLR)	Typ prvku.

Členská funkce	Popis
list::assign (STL/CLR)	Nahradí všechny prvky.
list::back (STL/CLR)	Přistupuje k poslední prvek.
list::begin (STL/CLR)	Označí začátek řízené sekvenci.
list::clear (STL/CLR)	Odebere všechny prvky.
list::empty (STL/CLR)	Zkoušky zda jsou žádné prvky obsahují.
list::end (STL/CLR)	Označí konci řízené sekvence.
list::erase (STL/CLR)	Odebere prvky v určených polohách.
list::front (STL/CLR)	Přistupuje k první prvek.
list::insert (STL/CLR)	Přidá prvky na určené pozici.
list::list (STL/CLR)	Vytvoří objekt kontejneru.
list::merge (STL/CLR)	Sloučí dva objednané řízené sekvence.
list::pop_back (STL/CLR)	Odstraní poslední prvek.
list::pop_front (STL/CLR)	Odebere první prvek.
list::push_back (STL/CLR)	Přidá nový poslední prvek.
list::push_front (STL/CLR)	Přidá nový první prvek.
list::rbegin (STL/CLR)	Označí začátek řízené obrácené pořadí.
list::remove (STL/CLR)	Odstraní prvek se zadanou hodnotou.
list::remove_if (STL/CLR)	Odebere prvky, které jsou určené zkoušce.
list::rend (STL/CLR)	Označí konci obrácené řízené sekvence.
list::resize (STL/CLR)	Změní počet prvků.
list::reverse (STL/CLR)	Obrátí pořadí řízené.
list::size (STL/CLR)	Vrátí počet prvků.
list::sort (STL/CLR)	Objednávky řízené sekvenci.
list::splice (STL/CLR)	Restitches vazeb mezi uzly.
list::swap (STL/CLR)	Zamění obsah dvou kontejnerů.
list::to_array (STL/CLR)	Řízené sekvenci se zkopíruje do nového pole.
list::unique (STL/CLR)	Odebere sousedící prvky, které projdou stanoveným zkušebním.

Property	Popis
list::back_item (STL/CLR)	Přistupuje k poslední prvek.
list::front_item (STL/CLR)	Přistupuje k první prvek.

Operátor	Popis
list::operator= (STL/CLR)	Nahradí řízené sekvenci.
operator!= (list) – operátor (STL/CLR)	Určuje, zda list objekt není rovno druhé list objektu.
operator< (list) – operátor (STL/CLR)	Určuje, zda list objekt je menší než jiný list objektu.
operator<= (list) – operátor (STL/CLR)	Určuje, zda list objekt je menší než nebo rovno druhé list objektu.
operator== (list) – operátor (STL/CLR)	Určuje, zda list objekt je rovno druhé list objektu.
operator> (list) – operátor (STL/CLR)	Určuje, zda list je větší než jiný objekt list objektu.
operator>= (list) – operátor (STL/CLR)	Určuje, zda list objekt je větší než nebo rovno druhé list objektu.

Rozhraní

Rozhraní	Popis
ICloneable	Duplicitní objekt.
IEnumerable	Úsek mezi prvky.
ICollection	Udržujte skupiny prvků.
IEnumerable	Úsek přes zadaný prvky.
ICollection	Udržujte skupiny typových prvků.
IList<hodnoty>	Udržujte obecný kontejner.

Poznámky

Objekt přiděluje a uvolňuje úložiště pro sekvence, které ovládá jako jednotlivé uzly v seznamu obousměrné propojení.Prvky se uspořádá změnou propojení mezi uzly nikdy zkopírováním obsahu z jednoho uzlu do druhého.To znamená, že můžete vložit a odebrat prvky volně bez narušení zbývající prvky.Seznam je tedy vhodný pro podkladové kontejneru pro šablonu třídy queue (STL/CLR) nebo třídu šablony stack (STL/CLR).

A list objekt podporuje obousměrné iterátory, což znamená, že jste se přesunuli do sousedící prvky uvedené iterace, který určuje prvek v kontrolovaných sekvenci.Speciální hlavního uzlu odpovídá iterátor vrácené list::end (STL/CLR)().Tento iterační dosáhnout poslední prvek v kontrolovaných sekvenci, lze snížit, pokud je k dispozici.Můžete zvýšit seznam iterátor pro dosažení hlavního uzlu a bude pak porovnat rovná end().Ale nelze přistoupit přes ukazatel vrácené iterace end().

Všimněte si, že nemůže odkazovat na prvek seznamu přímo uvedeny číselné pozice – která vyžaduje iterační náhodný přístup.Tak je seznam not použitelné jako podkladové kontejneru pro šablonu třídy priority_queue (STL/CLR).

Seznam iterátor uloží popisovač přidružený seznam uzlu, který zase obsahuje úchyt na jeho přidružené kontejnerové.U iterátorů lze použít pouze jejich přidružené kontejnerové objekty.Iterace seznamu zůstává v platnosti tak dlouho, dokud je přidružen seznam některých jeho přidružený seznam uzlu.Navíc platný iterátor je dereferencable – slouží k přístupu nebo změnit hodnotu prvku jmenuje--tak dlouho, dokud není rovno end().

Mazání nebo odebrání prvku volání destruktoru jeho uložené hodnoty.Zničení kontejneru vymaže všechny prvky.Kontejner, jehož typ prvku ref class tedy zajišťuje, že žádné prvky outlive kontejneru.Uvědomte si však, že kontejner úchyty se not zničit jeho prvků.