list (STL/CLR)

Článek
06/07/2013

Popisuje šablony třídy objektu, který řídí různé délky posloupnost prvků, která má obousměrný přístup.Použití kontejneru list spravovat pořadí prvků jako obousměrné propojeného seznamu uzlů, každý jeden prvek ukládání.

V popisu níže GValue je stejný jako Value , není tento 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 prvku řízené sekvence.

Členy

Definice typu	Description
list::const_iterator (STL/CLR)	Typ konstantní iterační řízené posloupnosti.
list::const_reference (STL/CLR)	Typ konstantní odkaz na element.
list::const_reverse_iterator (STL/CLR)	Typ konstantní zpětného iterační řízené posloupnosti.
list::difference_type (STL/CLR)	Typ podepsané vzdálenost mezi dvěma prvky.
list::generic_container (STL/CLR)	Typ kontejneru obecné rozhraní.
list::generic_iterator (STL/CLR)	Typ iterace obecné rozhraní pro kontejner.
list::generic_reverse_iterator (STL/CLR)	Typ zpětného iterační obecné rozhraní pro kontejner.
list::generic_value (STL/CLR)	Typ prvku obecné rozhraní kontejneru.
list::iterator (STL/CLR)	Typ iterace řízené posloupnosti.
list::Reference (STL/CLR)	Typ odkazu na prvek.
list::reverse_iterator (STL/CLR)	Typ zpětného iterační řízené posloupnosti.
list::size_type (STL/CLR)	Typ podepsané vzdálenost mezi dvěma prvky.
list::value_type (STL/CLR)	Typ prvku.

Členská funkce	Description
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é sekvence.
list::clear (STL/CLR)	Odebere všechny prvky.
list::empty (STL/CLR)	Zkoušky, zda jsou žádné prvky prezentovat.
list::end (STL/CLR)	Označí konec ří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)	Konstrukce objektu kontejneru.
list::merge (STL/CLR)	Sloučí dva objednané řízené sekvence.
list::pop_back (STL/CLR)	Odstraní poslední prvek.
list::pop_front (STL/CLR)	První prvek odebere.
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 určené zkoušce.
list::rend (STL/CLR)	Označí konec obrácené pořadí řízené.
list::resize (STL/CLR)	Změní počet prvků.
list::reverse (STL/CLR)	Obrátí řízené sekvence.
list::size (STL/CLR)	Vrátí počet prvků.
list::sort (STL/CLR)	Řízené posloupnost příkazů.
list::splice (STL/CLR)	Restitches propojení mezi uzly.
list::swap (STL/CLR)	Zamění obsah dva kontejnery.
list::to_array (STL/CLR)	Řízené sekvence se zkopíruje do nového pole.
list::unique (STL/CLR)	Odebere zadaný zkoušce sousedící prvky.

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

Operátor	Description
list::operator= (STL/CLR)	Nahradí řízené sekvence.
operator!= (list) (STL/CLR)	Určuje, zda list objektu není rovna jiné list objektu.
operator< (list) (STL/CLR)	Určuje, zda list objektu je menší než jiné list objektu.
operator<= (list) (STL/CLR)	Určuje, zda list objekt je menší nebo rovna jiné list objektu.
operator== (list) (STL/CLR)	Určuje, zda list je rovna jiného objektu list objektu.
operator> (list) (STL/CLR)	Určuje, zda list je větší než jiný objekt list objektu.
operator>= (list) (STL/CLR)	Určuje, zda list objekt je větší než nebo rovna hodnotě jiného list objektu.

Rozhraní

Rozhraní	Description
ICloneable	Duplikujte objekt.
IEnumerable	Úsek mezi prvky.
ICollection	Zachovat skupiny prvků.
IEnumerable<T>	Pořadové prostřednictvím typové prvky.
ICollection<T>	Zachovat skupiny zadané prvků.
Objekty IList <Value>	Udržují generic kontejneru.

Poznámky

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

A list objekt podporuje obousměrný u iterátorů, což znamená, že můžete na sousedící prvky uvedené iterace, který určuje prvek řízené postupně krok.Zvláštní hlavního uzlu odpovídá iterační vrácené list::end (STL/CLR)().Tento iterační dosáhnout poslední prvek v pořadí řízené lze snížit přítomen.Můžete zvýšit iterace seznamu k dosažení hlavního uzlu a potom bude porovnávat rovno end().Ale nelze zrušit reference struktury iterace vrácené end().

Všimněte si, že nemůže odkazovat na prvek seznamu přímo dané číselné pozice--vyžadující iterační náhodný přístup.Seznam je not použitelné jako základní kontejner pro šablonu třídy priority_queue (STL/CLR).

Iterace seznamu uloží popisovač do uzlu přidružený seznam jeho zase uloží popisovač jeho přidružené kontejneru.U iterátorů lze použít pouze jejich přidružené kontejneru objektů.Iterace seznamu zůstává platné tak dlouho, dokud se jeho přidružený seznam uzel je přidružena k seznamu některé.Kromě toho je platný iterační dereferencable – slouží k přístupu nebo změnit hodnotu prvku jmenuje--tak dlouho, dokud není rovno end().

Mazání nebo odebrání prvku volá jeho uložená hodnota se objekt.Zničení kontejneru vymaže všechny prvky.Kontejner, jehož typ prvku je třída ref tedy zajišťuje, že outlive žádné prvky kontejneru.Upozorňujeme však, že kontejner úchyty nemá not zničit jeho prvky.