list (STL/CLR)list (STL/CLR)

Klasa szablonu opisuje obiekt, który kontroluje różnej długości sekwencje elementów, które mają dostęp dwukierunkowy.The template class describes an object that controls a varying-length sequence of elements that has bidirectional access. Kontener służy list do zarządzania sekwencją elementów jako dwukierunkową listą węzłów, z których każdy ma przechowywać jeden element.You use the container list to manage a sequence of elements as a bidirectional linked list of nodes, each storing one element.

W poniższym opisie GValue jest taka sama jak wartość , chyba że ostatni jest typem ref, w takim przypadku jest to Value^ .In the description below, GValue is the same as Value unless the latter is a ref type, in which case it is Value^.

SkładniaSyntax

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>
    { ..... };

ParametryParameters

WartośćValue
Typ elementu w kontrolowanej sekwencji.The type of an element in the controlled sequence.

WymaganiaRequirements

Nagłówek:<cliext/list>Header: <cliext/list>

Przestrzeń nazw: cliextNamespace: cliext

DeklaracjeDeclarations

Definicja typuType Definition OpisDescription
list::const_iterator (STL/CLR)list::const_iterator (STL/CLR) Typ iteratora stałego dla kontrolowanej sekwencji.The type of a constant iterator for the controlled sequence.
list::const_reference (STL/CLR)list::const_reference (STL/CLR) Typ stałego odwołania do elementu.The type of a constant reference to an element.
list::const_reverse_iterator (STL/CLR)list::const_reverse_iterator (STL/CLR) Typ iteratora stałego zwrotnego dla kontrolowanej sekwencji.The type of a constant reverse iterator for the controlled sequence.
list::difference_type (STL/CLR)list::difference_type (STL/CLR) Typ odległości ze znakiem między dwoma elementami.The type of a signed distance between two elements.
list::generic_container (STL/CLR)list::generic_container (STL/CLR) Typ interfejsu generycznego dla kontenera.The type of the generic interface for the container.
list::generic_iterator (STL/CLR)list::generic_iterator (STL/CLR) Typ iteratora dla interfejsu generycznego dla kontenera.The type of an iterator for the generic interface for the container.
list::generic_reverse_iterator (STL/CLR)list::generic_reverse_iterator (STL/CLR) Typ iteratora odwrotnego dla interfejsu generycznego dla kontenera.The type of a reverse iterator for the generic interface for the container.
list::generic_value (STL/CLR)list::generic_value (STL/CLR) Typ elementu dla interfejsu generycznego dla kontenera.The type of an element for the generic interface for the container.
list::iterator (STL/CLR)list::iterator (STL/CLR) Typ iteratora dla kontrolowanej sekwencji.The type of an iterator for the controlled sequence.
list::reference (STL/CLR)list::reference (STL/CLR) Typ odwołania do elementu.The type of a reference to an element.
list::reverse_iterator (STL/CLR)list::reverse_iterator (STL/CLR) Typ iteratora odwrotnego dla kontrolowanej sekwencji.The type of a reverse iterator for the controlled sequence.
list::size_type (STL/CLR)list::size_type (STL/CLR) Typ odległości ze znakiem między dwoma elementami.The type of a signed distance between two elements.
list::value_type (STL/CLR)list::value_type (STL/CLR) Typ elementu.The type of an element.
Funkcja elementów członkowskichMember Function OpisDescription
list::assign (STL/CLR)list::assign (STL/CLR) Zamienia wszystkie elementy.Replaces all elements.
list::back (STL/CLR)list::back (STL/CLR) Uzyskuje dostęp do ostatniego elementu.Accesses the last element.
list::begin (STL/CLR)list::begin (STL/CLR) Określa początek kontrolowanej sekwencji.Designates the beginning of the controlled sequence.
list::clear (STL/CLR)list::clear (STL/CLR) Usuwa wszystkie elementy.Removes all elements.
list::empty (STL/CLR)list::empty (STL/CLR) Sprawdza, czy nie ma żadnych elementów.Tests whether no elements are present.
list::end (STL/CLR)list::end (STL/CLR) Określa koniec kontrolowanej sekwencji.Designates the end of the controlled sequence.
list::erase (STL/CLR)list::erase (STL/CLR) Usuwa elementy z określonych pozycji.Removes elements at specified positions.
list::front (STL/CLR)list::front (STL/CLR) Uzyskuje dostęp do pierwszego elementu.Accesses the first element.
list::insert (STL/CLR)list::insert (STL/CLR) Dodaje elementy w określonej pozycji.Adds elements at a specified position.
list::list (STL/CLR)list::list (STL/CLR) Konstruuje obiekt kontenera.Constructs a container object.
list::merge (STL/CLR)list::merge (STL/CLR) Scala dwie uporządkowane sekwencje kontrolowane.Merges two ordered controlled sequences.
list::pop_back (STL/CLR)list::pop_back (STL/CLR) Usuwa ostatni element.Removes the last element.
list::pop_front (STL/CLR)list::pop_front (STL/CLR) Usuwa pierwszy element.Removes the first element.
list::push_back (STL/CLR)list::push_back (STL/CLR) Dodaje nowy ostatni element.Adds a new last element.
list::push_front (STL/CLR)list::push_front (STL/CLR) Dodaje nowy pierwszy element.Adds a new first element.
list::rbegin (STL/CLR)list::rbegin (STL/CLR) Określa początek odwróconej sekwencji kontrolowanej.Designates the beginning of the reversed controlled sequence.
list::remove (STL/CLR)list::remove (STL/CLR) Usuwa element o określonej wartości.Removes an element with a specified value.
list::remove_if (STL/CLR)list::remove_if (STL/CLR) Usuwa elementy, które przechodzą określony test.Removes elements that pass a specified test.
list::rend (STL/CLR)list::rend (STL/CLR) Określa koniec odwróconej kontrolowanej sekwencji.Designates the end of the reversed controlled sequence.
list::resize (STL/CLR)list::resize (STL/CLR) Zmienia liczbę elementów.Changes the number of elements.
list::reverse (STL/CLR)list::reverse (STL/CLR) Odwraca kontrolowana sekwencję.Reverses the controlled sequence.
list::size (STL/CLR)list::size (STL/CLR) Liczy liczbę elementów.Counts the number of elements.
list::sort (STL/CLR)list::sort (STL/CLR) Zamówienie kontrolowanej sekwencji.Orders the controlled sequence.
list::splice (STL/CLR)list::splice (STL/CLR) Łączy linki między węzłami.Restitches links between nodes.
list::swap (STL/CLR)list::swap (STL/CLR) Zamienia zawartości dwóch kontenerów.Swaps the contents of two containers.
list::to_array (STL/CLR)list::to_array (STL/CLR) Kopiuje przekontrolowaną sekwencję do nowej tablicy.Copies the controlled sequence to a new array.
list::unique (STL/CLR)list::unique (STL/CLR) Usuwa przylegające elementy, które przechodzą do określonego testu.Removes adjacent elements that pass a specified test.
WłaściwośćProperty OpisDescription
list::back_item (STL/CLR)list::back_item (STL/CLR) Uzyskuje dostęp do ostatniego elementu.Accesses the last element.
list::front_item (STL/CLR)list::front_item (STL/CLR) Uzyskuje dostęp do pierwszego elementu.Accesses the first element.
OperatorOperator OpisDescription
list::operator= (STL/CLR)list::operator= (STL/CLR) Zastępuje kontrolowaną sekwencję.Replaces the controlled sequence.
operator!= (list) (STL/CLR)operator!= (list) (STL/CLR) Określa, czy list obiekt nie jest równy innemu list obiektowi.Determines if a list object is not equal to another list object.
< operatora (lista) (STL/CLR)operator< (list) (STL/CLR) Określa, czy list obiekt jest mniejszy niż inny list obiekt.Determines if a list object is less than another list object.
operator<= (list) (STL/CLR)operator<= (list) (STL/CLR) Określa, czy list obiekt jest mniejszy niż lub równy innemu list obiektowi.Determines if a list object is less than or equal to another list object.
operator = = (lista) (STL/CLR)operator== (list) (STL/CLR) Określa, czy list obiekt jest równy innemu list obiektowi.Determines if a list object is equal to another list object.
> operatora (lista) (STL/CLR)operator> (list) (STL/CLR) Określa, czy list obiekt jest większy niż inny list obiekt.Determines if a list object is greater than another list object.
operator>= (list) (STL/CLR)operator>= (list) (STL/CLR) Określa, czy list obiekt jest większy lub równy innemu list obiektowi.Determines if a list object is greater than or equal to another list object.

InterfejsyInterfaces

InterfejsInterface OpisDescription
ICloneable Duplikowanie obiektu.Duplicate an object.
IEnumerable Sekwencja przez elementy.Sequence through elements.
ICollection Obsługa grupy elementów.Maintain group of elements.
IEnumerable<T> Sekwencja przez wpisane elementy.Sequence through typed elements.
ICollection<T> Obsługuj grupę wpisanych elementów.Maintain group of typed elements.
IList<Value>IList<Value> Obsługa kontenera ogólnego.Maintain generic container.

UwagiRemarks

Obiekt przydziela i zwalnia magazyn dla sekwencji, która kontroluje jako pojedyncze węzły na liście łączy dwukierunkowych.The object allocates and frees storage for the sequence it controls as individual nodes in a bidirectional link list. Organizuje ona elementy przez zmianę linków między węzłami, nigdy przez skopiowanie zawartości jednego węzła do drugiego.It rearranges elements by altering the links between nodes, never by copying the contents of one node to another. Oznacza to, że można wstawiać i usuwać elementy swobodnie bez zakłócania pozostałych elementów.That means you can insert and remove elements freely without disturbing remaining elements. W ten sposób lista jest dobrym kandydatem dla bazowego kontenera dla kolejki klas szablonu (STL/CLR) lub stosu klas szablonu (STL/CLR).Thus, a list is a good candidate for the underlying container for template class queue (STL/CLR) or template class stack (STL/CLR).

listObiekt obsługuje Iteratory dwukierunkowe, co oznacza, że można przechodzić do sąsiadujących elementów przy użyciu iteratora, który wyznacza element w kontrolowanej sekwencji.A list object supports bidirectional iterators, which means you can step to adjacent elements given an iterator that designates an element in the controlled sequence. Specjalny węzeł główny odpowiada iteratorowi zwróconemu przez listę:: end (STL/CLR) () .A special head node corresponds to the iterator returned by list::end (STL/CLR)(). Można zmniejszyć ten iterator, aby dotrzeć do ostatniego elementu w kontrolowanej sekwencji, jeśli jest obecny.You can decrement this iterator to reach the last element in the controlled sequence, if present. Można zwiększyć iterator listy, aby dotrzeć do węzła głównego, a następnie będzie on porównywany z równą end() .You can increment a list iterator to reach the head node, and it will then compare equal to end(). Ale nie można usunąć odwołania do iteratora zwróconego przez end() .But you cannot dereference the iterator returned by end().

Należy zauważyć, że nie można odwołać się do elementu listy bezpośrednio przy użyciu jego pozycji liczbowej — który wymaga iteratora dostępu swobodnego.Note that you cannot refer to a list element directly given its numerical position -- that requires a random-access iterator. Dlatego nie można użyć listy jako bazowego kontenera dla klasy szablonu priority_queue (STL/CLR).So a list is not usable as the underlying container for template class priority_queue (STL/CLR).

Iterator listy przechowuje uchwyt do skojarzonego z nim węzła listy, który z kolei przechowuje dojście do skojarzonego kontenera.A list iterator stores a handle to its associated list node, which in turn stores a handle to its associated container. Iteratorów można używać tylko ze skojarzonymi obiektami kontenera.You can use iterators only with their associated container objects. Iterator listy pozostaje prawidłowy, dopóki jego skojarzony węzeł listy jest skojarzony z niepewną listą.A list iterator remains valid so long as its associated list node is associated with some list. Ponadto prawidłowy iterator jest dereferencable — można go użyć w celu uzyskania dostępu do lub zmiany wartości elementu, który wyznacza, tak długo, jak nie jest równa end() .Moreover, a valid iterator is dereferencable -- you can use it to access or alter the element value it designates -- so long as it is not equal to end().

Wymazywanie lub usuwanie elementu wywołuje destruktor dla jego przechowywanej wartości.Erasing or removing an element calls the destructor for its stored value. Niszczenie kontenera powoduje wymazanie wszystkich elementów.Destroying the container erases all elements. W tym celu kontener, którego typem elementu jest Klasa ref, zapewnia, że żadne elementy nie wyprowadzą kontenera.Thus, a container whose element type is a ref class ensures that no elements outlive the container. Należy jednak zauważyć, że kontener dojść nie niszczy swoich elementów.Note, however, that a container of handles does not destroy its elements.

Elementy członkowskieMembers

list:: Assign (STL/CLR)list::assign (STL/CLR)

Zamienia wszystkie elementy.Replaces all elements.

SkładniaSyntax

void assign(size_type count, value_type val);
template<typename InIt>
    void assign(InIt first, InIt last);
void assign(System::Collections::Generic::IEnumerable<Value>^ right);

ParametryParameters

liczbącount
Liczba elementów do wstawienia.Number of elements to insert.

pierwszegofirst
Początek zakresu do wstawienia.Beginning of range to insert.

ostatniegolast
Koniec zakresu do wstawienia.End of range to insert.

Kliknijright
Wyliczenie do wstawienia.Enumeration to insert.

użyteval
Wartość elementu do wstawienia.Value of the element to insert.

UwagiRemarks

Pierwsza funkcja członkowska zastępuje kontrolowana sekwencję z powtórzeniem elementów Count wartości Val.The first member function replaces the controlled sequence with a repetition of count elements of value val. Służy do wypełniania kontenera wszystkimi elementami o tej samej wartości.You use it to fill the container with elements all having the same value.

Jeśli InIt jest typu Integer, druga funkcja członkowska zachowuje się tak samo jak assign((size_type)first, (value_type)last) .If InIt is an integer type, the second member function behaves the same as assign((size_type)first, (value_type)last). W przeciwnym razie zastępuje kontrolowaną sekwencję sekwencją [ first , last ).Otherwise, it replaces the controlled sequence with the sequence [first, last). Jest on używany do sterowania sekwencją, która kopiuje kolejną sekwencję.You use it to make the controlled sequence a copy another sequence.

Trzecia funkcja członkowska zastępuje kontrolowaną sekwencję sekwencją wyznaczonej przez moduł wyliczający w prawo.The third member function replaces the controlled sequence with the sequence designated by the enumerator right. Jest on używany do naliczania kontrolowanej sekwencji kopii sekwencji opisanej przez moduł wyliczający.You use it to make the controlled sequence a copy of a sequence described by an enumerator.

PrzykładExample

// cliext_list_assign.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // assign a repetition of values
    cliext::list<wchar_t> c2;
    c2.assign(6, L'x');
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign an iterator range
    cliext::list<wchar_t>::iterator it = c1.end();
    c2.assign(c1.begin(), --it);
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign an enumeration
    c2.assign(   // NOTE: cast is not needed
        (System::Collections::Generic::IEnumerable<wchar_t>^)%c1);
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
x x x x x x
a b
a b c

list:: Back (STL/CLR)list::back (STL/CLR)

Uzyskuje dostęp do ostatniego elementu.Accesses the last element.

SkładniaSyntax

reference back();

UwagiRemarks

Funkcja członkowska zwraca odwołanie do ostatniego elementu kontrolowanej sekwencji, które nie może być puste.The member function returns a reference to the last element of the controlled sequence, which must be non-empty. Jest on używany do uzyskiwania dostępu do ostatniego elementu, gdy wiadomo, że już istnieje.You use it to access the last element, when you know it exists.

PrzykładExample

// cliext_list_back.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect last item
    System::Console::WriteLine("back() = {0}", c1.back());

    // alter last item and reinspect
    c1.back() = L'x';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
back() = c
a b x

list:: back_item (STL/CLR)list::back_item (STL/CLR)

Uzyskuje dostęp do ostatniego elementu.Accesses the last element.

SkładniaSyntax

property value_type back_item;

UwagiRemarks

Właściwość uzyskuje dostęp do ostatniego elementu kontrolowanej sekwencji, który nie może być pusty.The property accesses the last element of the controlled sequence, which must be non-empty. Jest on używany do odczytywania lub zapisywania ostatniego elementu, gdy wiadomo, że już istnieje.You use it to read or write the last element, when you know it exists.

PrzykładExample

// cliext_list_back_item.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect last item
    System::Console::WriteLine("back_item = {0}", c1.back_item);

    // alter last item and reinspect
    c1.back_item = L'x';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
back_item = c
a b x

list:: begin (STL/CLR)list::begin (STL/CLR)

Określa początek kontrolowanej sekwencji.Designates the beginning of the controlled sequence.

SkładniaSyntax

iterator begin();

UwagiRemarks

Funkcja członkowska zwraca iterator dostępu swobodnego, który wyznacza pierwszy element kontrolowanej sekwencji lub tuż poza końcem pustej sekwencji.The member function returns a random-access iterator that designates the first element of the controlled sequence, or just beyond the end of an empty sequence. Służy do uzyskania iteratora, który wyznacza current początek kontrolowanej sekwencji, ale jego stan może ulec zmianie w przypadku zmiany długości kontrolowanej sekwencji.You use it to obtain an iterator that designates the current beginning of the controlled sequence, but its status can change if the length of the controlled sequence changes.

PrzykładExample

// cliext_list_begin.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first two items
    cliext::list<wchar_t>::iterator it = c1.begin();
    System::Console::WriteLine("*begin() = {0}", *it);
    System::Console::WriteLine("*++begin() = {0}", *++it);

    // alter first two items and reinspect
    *--it = L'x';
    *++it = L'y';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
*begin() = a
*++begin() = b
x y c

list:: Clear (STL/CLR)list::clear (STL/CLR)

Usuwa wszystkie elementy.Removes all elements.

SkładniaSyntax

void clear();

UwagiRemarks

Funkcja członkowska skutecznie wywołuje listę :: Erase (STL/CLR) ( list:: begin (STL/CLR) (), list:: end (STL/CLR) ()) .The member function effectively calls list::erase (STL/CLR)( list::begin (STL/CLR)(), list::end (STL/CLR)()). Jest on używany do upewnienia się, że kontrolowana sekwencja jest pusta.You use it to ensure that the controlled sequence is empty.

PrzykładExample

// cliext_list_clear.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // clear the container and reinspect
    c1.clear();
    System::Console::WriteLine("size() = {0}", c1.size());

    // add elements and clear again
    c1.push_back(L'a');
    c1.push_back(L'b');

    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    c1.clear();
    System::Console::WriteLine("size() = {0}", c1.size());
    return (0);
    }
a b c
size() = 0
a b
size() = 0

list:: const_iterator (STL/CLR)list::const_iterator (STL/CLR)

Typ iteratora stałego dla kontrolowanej sekwencji.The type of a constant iterator for the controlled sequence.

SkładniaSyntax

typedef T2 const_iterator;

UwagiRemarks

Typ opisuje obiekt nieokreślonego typu T2 , który może być używany jako iterator stałego dostępu swobodnego dla kontrolowanej sekwencji.The type describes an object of unspecified type T2 that can serve as a constant random-access iterator for the controlled sequence.

PrzykładExample

// cliext_list_const_iterator.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    cliext::list<wchar_t>::const_iterator cit = c1.begin();
    for (; cit != c1.end(); ++cit)
        System::Console::Write("{0} ", *cit);
    System::Console::WriteLine();
    return (0);
    }
a b c

list:: const_reference (STL/CLR)list::const_reference (STL/CLR)

Typ stałego odwołania do elementu.The type of a constant reference to an element.

SkładniaSyntax

typedef value_type% const_reference;

UwagiRemarks

Typ opisuje stałe odwołanie do elementu.The type describes a constant reference to an element.

PrzykładExample

// cliext_list_const_reference.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    cliext::list<wchar_t>::const_iterator cit = c1.begin();
    for (; cit != c1.end(); ++cit)
        {   // get a const reference to an element
        cliext::list<wchar_t>::const_reference cref = *cit;
        System::Console::Write("{0} ", cref);
        }
    System::Console::WriteLine();
    return (0);
    }
a b c

list:: const_reverse_iterator (STL/CLR)list::const_reverse_iterator (STL/CLR)

Typ iteratora stałego zwrotnego dla kontrolowanej sekwencji.The type of a constant reverse iterator for the controlled sequence..

SkładniaSyntax

typedef T4 const_reverse_iterator;

UwagiRemarks

Typ opisuje obiekt nieokreślonego typu T4 , który może być używany jako ciągły iterator odwrotny dla kontrolowanej sekwencji.The type describes an object of unspecified type T4 that can serve as a constant reverse iterator for the controlled sequence.

PrzykładExample

// cliext_list_const_reverse_iterator.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c" reversed
    cliext::list<wchar_t>::const_reverse_iterator crit = c1.rbegin();
    cliext::list<wchar_t>::const_reverse_iterator crend = c1.rend();
    for (; crit != crend; ++crit)
        System::Console::Write("{0} ", *crit);
    System::Console::WriteLine();
    return (0);
    }
c b a

list::d ifference_type (STL/CLR)list::difference_type (STL/CLR)

Typy podpisanej odległości między dwoma elementami.The types of a signed distance between two elements.

SkładniaSyntax

typedef int difference_type;

UwagiRemarks

Typ opisuje liczbę elementów ze znakiem.The type describes a signed element count.

PrzykładExample

// cliext_list_difference_type.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // compute positive difference
    cliext::list<wchar_t>::difference_type diff = 0;
    for (cliext::list<wchar_t>::iterator it = c1.begin();
        it != c1.end(); ++it) ++diff;
    System::Console::WriteLine("end()-begin() = {0}", diff);

    // compute negative difference
    diff = 0;
    for (cliext::list<wchar_t>::iterator it = c1.end();
        it != c1.begin(); --it) --diff;
    System::Console::WriteLine("begin()-end() = {0}", diff);
    return (0);
    }
a b c
end()-begin() = 3
begin()-end() = -3

list:: empty (STL/CLR)list::empty (STL/CLR)

Sprawdza, czy nie ma żadnych elementów.Tests whether no elements are present.

SkładniaSyntax

bool empty();

UwagiRemarks

Funkcja członkowska zwraca wartość true dla pustej kontrolowanej sekwencji.The member function returns true for an empty controlled sequence. Jest równoważne z listą:: size (STL/CLR) () == 0 .It is equivalent to list::size (STL/CLR)() == 0. Służy do sprawdzania, czy lista jest pusta.You use it to test whether the list is empty.

PrzykładExample

// cliext_list_empty.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    System::Console::WriteLine("size() = {0}", c1.size());
    System::Console::WriteLine("empty() = {0}", c1.empty());

    // clear the container and reinspect
    c1.clear();
    System::Console::WriteLine("size() = {0}", c1.size());
    System::Console::WriteLine("empty() = {0}", c1.empty());
    return (0);
    }
a b c
size() = 3
empty() = False
size() = 0
empty() = True

list:: end (STL/CLR)list::end (STL/CLR)

Określa koniec kontrolowanej sekwencji.Designates the end of the controlled sequence.

SkładniaSyntax

iterator end();

UwagiRemarks

Funkcja członkowska zwraca iterator dostępu swobodnego, który wskazuje tuż poza końcem kontrolowanej sekwencji.The member function returns a random-access iterator that points just beyond the end of the controlled sequence. Służy do uzyskania iteratora, który wyznacza koniec kontrolowanej sekwencji; jego stan nie zmienia się w przypadku zmiany długości kontrolowanej sekwencji.You use it to obtain an iterator that designates the end of the controlled sequence; its status doesn not change if the length of the controlled sequence changes.

PrzykładExample

// cliext_list_end.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect last two items
    cliext::list<wchar_t>::iterator it = c1.end();
    --it;
    System::Console::WriteLine("*-- --end() = {0}", *--it);
    System::Console::WriteLine("*--end() = {0}", *++it);

    // alter first two items and reinspect
    *--it = L'x';
    *++it = L'y';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
*-- --end() = b
*--end() = c
a x y

list:: Erase (STL/CLR)list::erase (STL/CLR)

Usuwa elementy z określonych pozycji.Removes elements at specified positions.

SkładniaSyntax

iterator erase(iterator where);
iterator erase(iterator first, iterator last);

ParametryParameters

pierwszegofirst
Początek zakresu do wymazania.Beginning of range to erase.

ostatniegolast
Koniec zakresu do wymazania.End of range to erase.

miejscuwhere
Element do wymazania.Element to erase.

UwagiRemarks

Pierwsza funkcja członkowska usuwa element kontrolowanej sekwencji wskazywanej przez WHERE.The first member function removes the element of the controlled sequence pointed to by where. Służy do usuwania pojedynczego elementu.You use it to remove a single element.

Druga funkcja członkowska usuwa elementy z kontrolowanej sekwencji z zakresu [ first , last ).The second member function removes the elements of the controlled sequence in the range [first, last). Jest on używany do usuwania elementów sąsiadujących lub więcej.You use it to remove zero or more contiguous elements.

Obie funkcje członkowskie zwracają iterator, który wyznacza pierwszy element po usunięciu elementów, lub listę:: end (STL/CLR) , () Jeśli taki element nie istnieje.Both member functions return an iterator that designates the first element remaining beyond any elements removed, or list::end (STL/CLR)() if no such element exists.

Podczas wymazywania elementów liczba kopii elementów jest liniowa w liczbie elementów między końcem wymazywania a bliskością końca sekwencji.When erasing elements, the number of element copies is linear in the number of elements between the end of the erasure and the nearer end of the sequence. (Podczas wymazywania jednego lub większej liczby elementów na końcu sekwencji nie są kopiowane żadne elementy).(When erasing one or more elements at either end of the sequence, no element copies occur.)

PrzykładExample

// cliext_list_erase.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // erase an element and reinspect
    System::Console::WriteLine("erase(begin()) = {0}",
        *c1.erase(c1.begin()));

    // add elements and display " b c d e"
    c1.push_back(L'd');
    c1.push_back(L'e');
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // erase all but end
    cliext::list<wchar_t>::iterator it = c1.end();
    System::Console::WriteLine("erase(begin(), end()-1) = {0}",
        *c1.erase(c1.begin(), --it));
    System::Console::WriteLine("size() = {0}", c1.size());
    return (0);
    }
a b c
erase(begin()) = b
b c d e
erase(begin(), end()-1) = e
size() = 1

list:: front (STL/CLR)list::front (STL/CLR)

Uzyskuje dostęp do pierwszego elementu.Accesses the first element.

SkładniaSyntax

reference front();

UwagiRemarks

Funkcja członkowska zwraca odwołanie do pierwszego elementu kontrolowanej sekwencji, które nie może być puste.The member function returns a reference to the first element of the controlled sequence, which must be non-empty. Jest on używany do odczytywania lub zapisywania pierwszego elementu, gdy wiadomo, że już istnieje.You use it to read or write the first element, when you know it exists.

PrzykładExample

// cliext_list_front.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first item
    System::Console::WriteLine("front() = {0}", c1.front());

    // alter first item and reinspect
    c1.front() = L'x';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
front() = a
x b c

list:: front_item (STL/CLR)list::front_item (STL/CLR)

Uzyskuje dostęp do pierwszego elementu.Accesses the first element.

SkładniaSyntax

property value_type front_item;

UwagiRemarks

Właściwość uzyskuje dostęp do pierwszego elementu kontrolowanej sekwencji, która nie może być pusta.The property accesses the first element of the controlled sequence, which must be non-empty. Jest on używany do odczytywania lub zapisywania pierwszego elementu, gdy wiadomo, że już istnieje.You use it to read or write the first element, when you know it exists.

PrzykładExample

// cliext_list_front_item.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first item
    System::Console::WriteLine("front_item = {0}", c1.front_item);

    // alter first item and reinspect
    c1.front_item = L'x';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
front_item = a
x b c

list:: generic_container (STL/CLR)list::generic_container (STL/CLR)

Typ interfejsu generycznego dla kontenera.The type of the generic interface for the container.

SkładniaSyntax

typedef Microsoft::VisualC::StlClr::
    IList<generic_value>
    generic_container;

UwagiRemarks

Typ opisuje ogólny interfejs dla tej klasy kontenera szablonu.The type describes the generic interface for this template container class.

PrzykładExample

// cliext_list_generic_container.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct a generic container
    cliext::list<wchar_t>::generic_container^ gc1 = %c1;
    for each (wchar_t elem in gc1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // modify generic and display original
    gc1->insert(gc1->end(), L'd');
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // modify original and display generic
    c1.push_back(L'e');

    System::Collections::IEnumerator^ enum1 =
        gc1->GetEnumerator();
    while (enum1->MoveNext())
        System::Console::Write("{0} ", enum1->Current);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b c
a b c d
a b c d e

list:: generic_iterator (STL/CLR)list::generic_iterator (STL/CLR)

Typ iteratora do użycia z interfejsem ogólnym dla kontenera.The type of an iterator for use with the generic interface for the container.

SkładniaSyntax

typedef Microsoft::VisualC::StlClr::Generic::
    ContainerBidirectionalIterator<generic_value>
    generic_iterator;

UwagiRemarks

Typ opisuje iterator ogólny, który może być używany z interfejsem ogólnym dla tej klasy kontenera szablonu.The type describes a generic iterator that can be used with the generic interface for this template container class.

PrzykładExample

// cliext_list_generic_iterator.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct a generic container
    cliext::list<wchar_t>::generic_container^ gc1 = %c1;
    for each (wchar_t elem in gc1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // modify generic and display original
    cliext::list<wchar_t>::generic_iterator gcit = gc1->begin();
    cliext::list<wchar_t>::generic_value gcval = *gcit;
    *++gcit = gcval;
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b c
a a c

list:: generic_reverse_iterator (STL/CLR)list::generic_reverse_iterator (STL/CLR)

Typ iteratora odwrotnego do użycia z interfejsem ogólnym dla kontenera.The type of a reverse iterator for use with the generic interface for the container.

SkładniaSyntax

typedef Microsoft::VisualC::StlClr::Generic::
    ReverseBidirectionalIterator<generic_value> generic_reverse_iterator;

UwagiRemarks

Typ opisuje ogólny iterator odwrotny, który może być używany z ogólnym interfejsem klasy kontenera tego szablonu.The type describes a generic reverse iterator that can be used with the generic interface for this template container class.

PrzykładExample

// cliext_list_generic_reverse_iterator.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct a generic container
    cliext::list<wchar_t>::generic_container^ gc1 = %c1;
    for each (wchar_t elem in gc1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // modify generic and display original
    cliext::list<wchar_t>::generic_reverse_iterator gcit = gc1->rbegin();
    cliext::list<wchar_t>::generic_value gcval = *gcit;
    *++gcit = gcval;
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b c
a c c

list:: generic_value (STL/CLR)list::generic_value (STL/CLR)

Typ elementu do użycia z interfejsem ogólnym dla kontenera.The type of an element for use with the generic interface for the container.

SkładniaSyntax

typedef GValue generic_value;

UwagiRemarks

Typ opisuje obiekt typu GValue , który opisuje wartość przechowywanego elementu do użycia z interfejsem ogólnym dla tej klasy kontenera szablonu.The type describes an object of type GValue that describes the stored element value for use with the generic interface for this template container class.

PrzykładExample

// cliext_list_generic_value.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct a generic container
    cliext::list<wchar_t>::generic_container^ gc1 = %c1;
    for each (wchar_t elem in gc1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // modify generic and display original
    cliext::list<wchar_t>::generic_iterator gcit = gc1->begin();
    cliext::list<wchar_t>::generic_value gcval = *gcit;
    *++gcit = gcval;
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b c
a a c

list:: Insert (STL/CLR)list::insert (STL/CLR)

Dodaje elementy w określonej pozycji.Adds elements at a specified position.

SkładniaSyntax

iterator insert(iterator where, value_type val);
void insert(iterator where, size_type count, value_type val);
template<typename InIt>
    void insert(iterator where, InIt first, InIt last);
void insert(iterator where,
    System::Collections::Generic::IEnumerable<Value>^ right);

ParametryParameters

liczbącount
Liczba elementów do wstawienia.Number of elements to insert.

pierwszegofirst
Początek zakresu do wstawienia.Beginning of range to insert.

ostatniegolast
Koniec zakresu do wstawienia.End of range to insert.

Kliknijright
Wyliczenie do wstawienia.Enumeration to insert.

użyteval
Wartość elementu do wstawienia.Value of the element to insert.

miejscuwhere
Gdzie w kontenerze należy wstawić przed.Where in container to insert before.

UwagiRemarks

Każda funkcja członkowska wstawia przed elementem wskazywanym przez WHERE w kontrolowanej sekwencji sekwencję określoną przez pozostałe operandy.Each of the member functions inserts, before the element pointed to by where in the controlled sequence, a sequence specified by the remaining operands.

Pierwsza funkcja członkowska wstawia element z wartością Val i zwraca iterator, który wyznacza nowo wstawiony element.The first member function inserts an element with value val and returns an iterator that designates the newly inserted element. Służy do wstawiania pojedynczego elementu przed miejscem wyznaczonym przez iterator.You use it to insert a single element before a place designated by an iterator.

Druga funkcja członkowska wstawia powtarzające się elementy Count wartości Val.The second member function inserts a repetition of count elements of value val. Służy do wstawiania elementów ciągłych lub innych, które są kopiami tej samej wartości.You use it to insert zero or more contiguous elements which are all copies of the same value.

Jeśli InIt jest typu Integer, trzecia funkcja członkowska zachowuje się tak samo jak insert(where, (size_type)first, (value_type)last) .If InIt is an integer type, the third member function behaves the same as insert(where, (size_type)first, (value_type)last). W przeciwnym razie wstawia sekwencję [ first , last ).Otherwise, it inserts the sequence [first, last). Służy do wstawiania elementów sąsiadujących, które zostały skopiowane z innej sekwencji.You use it to insert zero or more contiguous elements copied from another sequence.

Czwarta funkcja członkowska wstawia sekwencję wydaną po prawej stronie.The fourth member function inserts the sequence designated by the right. Służy do wstawiania sekwencji opisanej przez moduł wyliczający.You use it to insert a sequence described by an enumerator.

Podczas wstawiania pojedynczego elementu liczba kopii elementów jest liniowa w liczbie elementów między punktem wstawiania i bliską końcem sekwencji.When inserting a single element, the number of element copies is linear in the number of elements between the insertion point and the nearer end of the sequence. (Podczas wstawiania co najmniej jednego elementu na końcu sekwencji nie ma żadnych kopii elementów). Jeśli InIt jest iteratorem wejściowym, trzecia funkcja składa efektywnie wykonuje pojedynczy Wstaw dla każdego elementu w sekwencji.(When inserting one or more elements at either end of the sequence, no element copies occur.) If InIt is an input iterator, the third member function effectively performs a single insertion for each element in the sequence. W przeciwnym razie, podczas wstawiania N elementów liczba kopii elementów jest liniowa N oraz liczba elementów między punktem wstawiania a bliskością końca sekwencji.Otherwise, when inserting N elements, the number of element copies is linear in N plus the number of elements between the insertion point and the nearer end of the sequence.

PrzykładExample

// cliext_list_insert.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // insert a single value using iterator
    cliext::list<wchar_t>::iterator it = c1.begin();
    System::Console::WriteLine("insert(begin()+1, L'x') = {0}",
        *c1.insert(++it, L'x'));
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // insert a repetition of values
    cliext::list<wchar_t> c2;
    c2.insert(c2.begin(), 2, L'y');
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // insert an iterator range
    it = c1.end();
    c2.insert(c2.end(), c1.begin(), --it);
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // insert an enumeration
    c2.insert(c2.begin(),   // NOTE: cast is not needed
        (System::Collections::Generic::IEnumerable<wchar_t>^)%c1);
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // insert a single value using index
    it = c2.begin();
    ++it, ++it, ++it;
    c2.insert(it, L'z');
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    return (0);
    }
a b c
insert(begin()+1, L'x') = x
a x b c
y y
y y a x b
a x b c y y a x b

list:: iterator (STL/CLR)list::iterator (STL/CLR)

Typ iteratora dla kontrolowanej sekwencji.The type of an iterator for the controlled sequence.

SkładniaSyntax

typedef T1 iterator;

UwagiRemarks

Typ opisuje obiekt nieokreślonego typu T1 , który może być używany jako Iterator dostępu swobodnego dla kontrolowanej sekwencji.The type describes an object of unspecified type T1 that can serve as a random-access iterator for the controlled sequence.

PrzykładExample

// cliext_list_iterator.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    cliext::list<wchar_t>::iterator it = c1.begin();
    for (; it != c1.end(); ++it)
        System::Console::Write("{0} ", *it);
    System::Console::WriteLine();

    // alter first element and redisplay
    it = c1.begin();
    *it = L'x';
    for (; it != c1.end(); ++it)
        System::Console::Write("{0} ", *it);
    System::Console::WriteLine();
    return (0);
    }
a b c
x b c

list:: list (STL/CLR)list::list (STL/CLR)

Konstruuje obiekt kontenera.Constructs a container object.

SkładniaSyntax

list();
list(list<Value>% right);
list(list<Value>^ right);
explicit list(size_type count);
list(size_type count, value_type val);
template<typename InIt>
    list(InIt first, InIt last);
list(System::Collections::Generic::IEnumerable<Value>^ right);

ParametryParameters

liczbącount
Liczba elementów do wstawienia.Number of elements to insert.

pierwszegofirst
Początek zakresu do wstawienia.Beginning of range to insert.

ostatniegolast
Koniec zakresu do wstawienia.End of range to insert.

Kliknijright
Obiekt lub zakres do wstawienia.Object or range to insert.

użyteval
Wartość elementu do wstawienia.Value of the element to insert.

UwagiRemarks

Konstruktor:The constructor:

list();

Inicjuje kontrolowaną sekwencję bez elementów.initializes the controlled sequence with no elements. Służy do określenia pustej kontrolowanej sekwencji.You use it to specify an empty initial controlled sequence.

Konstruktor:The constructor:

list(list<Value>% right);

Inicjuje kontrolowaną sekwencję z sekwencją [ right.begin() , right.end() ).initializes the controlled sequence with the sequence [right.begin(), right.end()). Służy do określenia początkowej kontrolowanej sekwencji, która jest kopią sekwencji kontrolowanej przez obiekt listy w prawo.You use it to specify an initial controlled sequence that is a copy of the sequence controlled by the list object right.

Konstruktor:The constructor:

list(list<Value>^ right);

Inicjuje kontrolowaną sekwencję z sekwencją [ right->begin() , right->end() ).initializes the controlled sequence with the sequence [right->begin(), right->end()). Służy do określenia początkowej kontrolowanej sekwencji, która jest kopią sekwencji kontrolowanej przez obiekt listy, którego uchwyt jest prawidłowy.You use it to specify an initial controlled sequence that is a copy of the sequence controlled by the list object whose handle is right.

Konstruktor:The constructor:

explicit list(size_type count);

Inicjuje kontrolowaną sekwencję z elementami Count każda z wartością value_type() .initializes the controlled sequence with count elements each with value value_type(). Służy do wypełniania kontenera wszystkimi elementami o wartości domyślnej.You use it to fill the container with elements all having the default value.

Konstruktor:The constructor:

list(size_type count, value_type val);

Inicjuje kontrolowaną sekwencję z elementami Count każda o wartości Val.initializes the controlled sequence with count elements each with value val. Służy do wypełniania kontenera wszystkimi elementami o tej samej wartości.You use it to fill the container with elements all having the same value.

Konstruktor:The constructor:

template<typename InIt>

list(InIt first, InIt last);

Inicjuje kontrolowaną sekwencję z sekwencją [ first , last ).initializes the controlled sequence with the sequence [first, last). Jest on używany do Przekształć sekwencję na kopię innej sekwencji.You use it to make the controlled sequence a copy of another sequence.

Konstruktor:The constructor:

list(System::Collections::Generic::IEnumerable<Value>^ right);

Inicjuje kontrolowaną sekwencję z sekwencją wyznaczonej przez moduł wyliczający w prawo.initializes the controlled sequence with the sequence designated by the enumerator right. Jest on używany do naliczania kontrolowanej sekwencji kopii kolejnej sekwencji opisanej przez moduł wyliczający.You use it to make the controlled sequence a copy of another sequence described by an enumerator.

PrzykładExample

// cliext_list_construct.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
// construct an empty container
    cliext::list<wchar_t> c1;
    System::Console::WriteLine("size() = {0}", c1.size());

    // construct with a repetition of default values
    cliext::list<wchar_t> c2(3);
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", (int)elem);
    System::Console::WriteLine();

    // construct with a repetition of values
    cliext::list<wchar_t> c3(6, L'x');
    for each (wchar_t elem in c3)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct with an iterator range
    cliext::list<wchar_t>::iterator it = c3.end();
    cliext::list<wchar_t> c4(c3.begin(), --it);
    for each (wchar_t elem in c4)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct with an enumeration
    cliext::list<wchar_t> c5(   // NOTE: cast is not needed
        (System::Collections::Generic::IEnumerable<wchar_t>^)%c3);
    for each (wchar_t elem in c5)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct by copying another container
    cliext::list<wchar_t> c7(c3);
    for each (wchar_t elem in c7)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct by copying a container handle
    cliext::list<wchar_t> c8(%c3);
    for each (wchar_t elem in c8)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    return (0);
    }
size() = 0
0 0 0
x x x x x x
x x x x x
x x x x x x
x x x x x x
x x x x x x

list:: merge (STL/CLR)list::merge (STL/CLR)

Scala dwie uporządkowane sekwencje kontrolowane.Merges two ordered controlled sequences.

SkładniaSyntax

void merge(list<Value>% right);
template<typename Pred2>
    void merge(list<Value>% right, Pred2 pred);

ParametryParameters

predpred
Funkcja porównująca dla par elementów.Comparer for element pairs.

Kliknijright
Kontener do scalenia.Container to merge in.

UwagiRemarks

Pierwsza funkcja członkowska usuwa wszystkie elementy z sekwencji kontrolowanej przez prawo i wstawia je w kontrolowanej sekwencji.The first member function removes all elements from the sequence controlled by right and insert them in the controlled sequence. Obie sekwencje muszą być wcześniej uporządkowane według operator< --elementy nie mogą zmniejszać wartości podczas wykonywania jednej z tych sekwencji.Both sequences must be previously ordered by operator< -- elements must not decrease in value as you progress through either sequence. Utworzona sekwencja jest również uporządkowana według operator< .The resulting sequence is also ordered by operator<. Ta funkcja członkowska służy do scalania dwóch sekwencji, które zwiększają wartość do sekwencji, która również zwiększa wartość.You use this member function to merge two sequences that increase in value into a sequence that also increases in value.

Druga funkcja członkowska zachowuje się tak samo jak pierwszy, z tą różnicą, że sekwencje są uporządkowane według pred -- pred(X, Y) muszą mieć wartość false dla każdego elementu X , który następuje Y po elemencie w sekwencji.The second member function behaves the same as the first, except that the sequences are ordered by pred -- pred(X, Y) must be false for any element X that follows element Y in the sequence. Służy do scalania dwóch sekwencji uporządkowanych według określonej przez użytkownika funkcji predykatu lub delegata.You use it to merge two sequences ordered by a predicate function or delegate that you specify.

Obie funkcje wykonują stabilne scalanie--żadna para elementów w jednej z oryginalnych sekwencji jest odwrócona w wyniku kontrolowanej sekwencji.Both functions perform a stable merge -- no pair of elements in either of the original controlled sequences is reversed in the resulting controlled sequence. Ponadto, jeśli para elementów X i Y w kontrolowanej sekwencji ma równoważnej kolejności-- !(X < Y) && !(X < Y) --element z oryginalnej kontrolowanej sekwencji pojawia się przed elementem z sekwencji kontrolowanej przez prawo.Also, if a pair of elements X and Y in the resulting controlled sequence has equivalent ordering -- !(X < Y) && !(X < Y) -- an element from the original controlled sequence appears before an element from the sequence controlled by right.

PrzykładExample

// cliext_list_merge.cpp
// compile with: /clr
#include <cliext/list>

typedef cliext::list<wchar_t> Mylist;
int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'c');
    c1.push_back(L'e');

    // display initial contents " a c e"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    cliext::list<wchar_t> c2;
    c2.push_back(L'b');
    c2.push_back(L'd');
    c2.push_back(L'f');

    // display initial contents " b d f"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // merge and display
    cliext::list<wchar_t> c3(c1);
    c3.merge(c2);
    for each (wchar_t elem in c3)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    System::Console::WriteLine("c2.size() = {0}", c2.size());

    // sort descending, merge descending, and redisplay
    c1.sort(cliext::greater<wchar_t>());
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    c3.sort(cliext::greater<wchar_t>());
    for each (wchar_t elem in c3)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    c3.merge(c1, cliext::greater<wchar_t>());
    for each (wchar_t elem in c3)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    System::Console::WriteLine("c1.size() = {0}", c1.size());
    return (0);
    }
a c e
b d f
a b c d e f
c2.size() = 0
e c a
f e d c b a
f e e d c c b a a
c1.size() = 0

list:: operator = (STL/CLR)list::operator= (STL/CLR)

Zastępuje kontrolowaną sekwencję.Replaces the controlled sequence.

SkładniaSyntax

list<Value>% operator=(list<Value>% right);

ParametryParameters

Kliknijright
Kontener do skopiowania.Container to copy.

UwagiRemarks

Operator elementu członkowskiego kopiuje prawo do obiektu, a następnie zwraca *this .The member operator copies right to the object, then returns *this. Służy do zastępowania kontrolowanej sekwencji kopią kontrolowanej sekwencji po prawej stronie.You use it to replace the controlled sequence with a copy of the controlled sequence in right.

PrzykładExample

// cliext_list_operator_as.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2 = c1;
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b c

list::p op_back (STL/CLR)list::pop_back (STL/CLR)

Usuwa ostatni element.Removes the last element.

SkładniaSyntax

void pop_back();

UwagiRemarks

Funkcja członkowska usuwa ostatni element kontrolowanej sekwencji, która nie może być pusta.The member function removes the last element of the controlled sequence, which must be non-empty. Służy do skracania listy o jeden element na odwrocie.You use it to shorten the list by one element at the back.

PrzykładExample

// cliext_list_pop_back.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // pop an element and redisplay
    c1.pop_back();
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b

list::p op_front (STL/CLR)list::pop_front (STL/CLR)

Usuwa pierwszy element.Removes the first element.

SkładniaSyntax

void pop_front();

UwagiRemarks

Funkcja członkowska usuwa pierwszy element kontrolowanej sekwencji, która nie może być pusta.The member function removes the first element of the controlled sequence, which must be non-empty. Służy do skracania listy o jeden element na początku.You use it to shorten the list by one element at the front.

PrzykładExample

// cliext_list_pop_front.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // pop an element and redisplay
    c1.pop_front();
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
b c

list::p ush_back (STL/CLR)list::push_back (STL/CLR)

Dodaje nowy ostatni element.Adds a new last element.

SkładniaSyntax

void push_back(value_type val);

UwagiRemarks

Funkcja członkowska wstawia element z wartością val na końcu kontrolowanej sekwencji.The member function inserts an element with value val at the end of the controlled sequence. Służy do dołączania kolejnego elementu do listy.You use it to append another element to the list.

PrzykładExample

// cliext_list_push_back.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c

list::p ush_front (STL/CLR)list::push_front (STL/CLR)

Dodaje nowy pierwszy element.Adds a new first element.

SkładniaSyntax

void push_front(value_type val);

UwagiRemarks

Funkcja członkowska wstawia element z wartością val na początku kontrolowanej sekwencji.The member function inserts an element with value val at the beginning of the controlled sequence. Jest on używany do nałączania kolejnego elementu do listy.You use it to prepend another element to the list.

PrzykładExample

// cliext_list_push_front.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_front(L'a');
    c1.push_front(L'b');
    c1.push_front(L'c');

    // display contents " c b a"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
c b a

list:: rbegin (STL/CLR)list::rbegin (STL/CLR)

Określa początek odwróconej sekwencji kontrolowanej.Designates the beginning of the reversed controlled sequence.

SkładniaSyntax

reverse_iterator rbegin();

UwagiRemarks

Funkcja członkowska zwraca iterator odwrotny, który wyznacza ostatni element kontrolowanej sekwencji lub tuż poza początkiem pustej sekwencji.The member function returns a reverse iterator that designates the last element of the controlled sequence, or just beyond the beginning of an empty sequence. W związku z tym określa beginning odwrotną sekwencję.Hence, it designates the beginning of the reverse sequence. Służy do uzyskania iteratora, który wyznacza current początek kontrolowanej sekwencji widoczny w kolejności odwrotnej, ale jego stan może ulec zmianie w przypadku zmiany długości kontrolowanej sekwencji.You use it to obtain an iterator that designates the current beginning of the controlled sequence seen in reverse order, but its status can change if the length of the controlled sequence changes.

PrzykładExample

// cliext_list_rbegin.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first two items in reversed sequence
    cliext::list<wchar_t>::reverse_iterator rit = c1.rbegin();
    System::Console::WriteLine("*rbegin() = {0}", *rit);
    System::Console::WriteLine("*++rbegin() = {0}", *++rit);

    // alter first two items and reinspect
    *--rit = L'x';
    *++rit = L'y';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
*rbegin() = c
*++rbegin() = b
a y x

list:: Reference (STL/CLR)list::reference (STL/CLR)

Typ odwołania do elementu.The type of a reference to an element.

SkładniaSyntax

typedef value_type% reference;

UwagiRemarks

Typ opisuje odwołanie do elementu.The type describes a reference to an element.

PrzykładExample

// cliext_list_reference.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    cliext::list<wchar_t>::iterator it = c1.begin();
    for (; it != c1.end(); ++it)
        {   // get a reference to an element
        cliext::list<wchar_t>::reference ref = *it;
        System::Console::Write("{0} ", ref);
        }
    System::Console::WriteLine();

    // modify contents " a b c"
    for (it = c1.begin(); it != c1.end(); ++it)
        {   // get a reference to an element
        cliext::list<wchar_t>::reference ref = *it;

        ref += (wchar_t)(L'A' - L'a');
        System::Console::Write("{0} ", ref);
        }
    System::Console::WriteLine();
    return (0);
    }
a b c
A B C

list:: Remove (STL/CLR)list::remove (STL/CLR)

Usuwa element o określonej wartości.Removes an element with a specified value.

SkładniaSyntax

void remove(value_type val);

ParametryParameters

użyteval
Wartość elementu do usunięcia.Value of the element to remove.

UwagiRemarks

Funkcja członkowska usuwa element w kontrolowanej sekwencji, dla którego ((System::Object^)val)->Equals((System::Object^)x) jest spełniony (jeśli istnieje).The member function removes an element in the controlled sequence for which ((System::Object^)val)->Equals((System::Object^)x) is true (if any). Służy do wymazywania dowolnego elementu z określoną wartością.You use it to erase an arbitrary element with the specified value.

PrzykładExample

// cliext_list_remove.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // fail to remove and redisplay
    c1.remove(L'A');
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // remove and redisplay
    c1.remove(L'b');
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
a b c
a c

list:: remove_if (STL/CLR)list::remove_if (STL/CLR)

Usuwa elementy, które przechodzą określony test.Removes elements that pass a specified test.

SkładniaSyntax

template<typename Pred1>
    void remove_if(Pred1 pred);

ParametryParameters

predpred
Testuj elementy do usunięcia.Test for elements to remove.

UwagiRemarks

Funkcja członkowska usuwa z kontrolowanej sekwencji (wymazuje) każdy element X , dla którego pred(X) ma wartość true.The member function removes from the controlled sequence (erases) every element X for which pred(X) is true. Służy do usuwania wszystkich elementów, które spełniają warunek określony jako funkcja lub delegat.You use it to remove all elements that satisfy a condition you specify as a function or delegate.

PrzykładExample

// cliext_list_remove_if.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'b');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b b b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // fail to remove and redisplay
    c1.remove_if(cliext::binder2nd<cliext::equal_to<wchar_t> >(
        cliext::equal_to<wchar_t>(), L'd'));
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // remove and redisplay
    c1.remove_if(cliext::binder2nd<cliext::not_equal_to<wchar_t> >(
        cliext::not_equal_to<wchar_t>(), L'b'));
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b b b c
a b b b c
b b b

list:: rend (STL/CLR)list::rend (STL/CLR)

Określa koniec odwróconej kontrolowanej sekwencji.Designates the end of the reversed controlled sequence.

SkładniaSyntax

reverse_iterator rend();

UwagiRemarks

Funkcja członkowska zwraca iterator odwrotny, który wskazuje tuż poza początkiem kontrolowanej sekwencji.The member function returns a reverse iterator that points just beyond the beginning of the controlled sequence. W związku z tym określa end odwrotną sekwencję.Hence, it designates the end of the reverse sequence. Służy do uzyskania iteratora, który wyznacza current koniec kontrolowanej sekwencji widoczny w odwrotnej kolejności, ale jego stan może ulec zmianie w przypadku zmiany długości kontrolowanej sekwencji.You use it to obtain an iterator that designates the current end of the controlled sequence seen in reverse order, but its status can change if the length of the controlled sequence changes.

PrzykładExample

// cliext_list_rend.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first two items
    cliext::list<wchar_t>::reverse_iterator rit = c1.rend();
    --rit;
    System::Console::WriteLine("*-- --rend() = {0}", *--rit);
    System::Console::WriteLine("*--rend() = {0}", *++rit);

    // alter first two items and reinspect
    *--rit = L'x';
    *++rit = L'y';
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
*-- --rend() = b
*--rend() = a
y x c

list:: Resize (STL/CLR)list::resize (STL/CLR)

Zmienia liczbę elementów.Changes the number of elements.

SkładniaSyntax

void resize(size_type new_size);
void resize(size_type new_size, value_type val);

ParametryParameters

new_sizenew_size
Nowy rozmiar kontrolowanej sekwencji.New size of the controlled sequence.

użyteval
Wartość elementu dopełnienia.Value of the padding element.

UwagiRemarks

Funkcje składowe zapewniają, że funkcja list:: size (STL/CLR) () odtąd zwraca new_size.The member functions both ensure that list::size (STL/CLR)() henceforth returns new_size. Jeśli ta sekwencja musi być większa, funkcja pierwszej składowej dołącza elementy o wartości value_type() , podczas gdy druga funkcja członkowska dołącza elementy o wartości Val.If it must make the controlled sequence longer, the first member function appends elements with value value_type(), while the second member function appends elements with value val. Aby sekwencja była krótsza, obie funkcje elementów członkowskich skutecznie kasują ostatnią listę elementów:: size (STL/CLR) () - new_size czasy.To make the controlled sequence shorter, both member functions effectively erase the last element list::size (STL/CLR)() - new_size times. Służy do upewnienia się, że kontrolowana sekwencja ma rozmiar new_size, przez przycinanie lub uzupełnienie bieżącej kontrolowanej sekwencji.You use it to ensure that the controlled sequence has size new_size, by either trimming or padding the current controlled sequence.

PrzykładExample

// cliext_list_resize.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
// construct an empty container and pad with default values
    cliext::list<wchar_t> c1;
    System::Console::WriteLine("size() = {0}", c1.size());
    c1.resize(4);
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", (int)elem);
    System::Console::WriteLine();

    // resize to empty
    c1.resize(0);
    System::Console::WriteLine("size() = {0}", c1.size());

    // resize and pad
    c1.resize(5, L'x');
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
size() = 0
0 0 0 0
size() = 0
x x x x x

list:: Reverse (STL/CLR)list::reverse (STL/CLR)

Odwraca kontrolowana sekwencję.Reverses the controlled sequence.

SkładniaSyntax

void reverse();

UwagiRemarks

Funkcja członkowska odwraca kolejność wszystkich elementów w kontrolowanej sekwencji.The member function reverses the order of all elements in the controlled sequence. Służy do odzwierciedlenia listy elementów.You use it to reflect a list of elements.

PrzykładExample

// cliext_list_reverse.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // reverse and redisplay
    c1.reverse();
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
c b a

list:: reverse_iterator (STL/CLR)list::reverse_iterator (STL/CLR)

Typ iteratora odwrotnego dla kontrolowanej sekwencji.The type of a reverse iterator for the controlled sequence.

SkładniaSyntax

typedef T3 reverse_iterator;

UwagiRemarks

Typ opisuje obiekt nieokreślonego typu T3 , który może być używany jako iterator odwrotny dla kontrolowanej sekwencji.The type describes an object of unspecified type T3 that can serve as a reverse iterator for the controlled sequence.

PrzykładExample

// cliext_list_reverse_iterator.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c" reversed
    cliext::list<wchar_t>::reverse_iterator rit = c1.rbegin();
    for (; rit != c1.rend(); ++rit)
        System::Console::Write("{0} ", *rit);
    System::Console::WriteLine();

    // alter first element and redisplay
    rit = c1.rbegin();
    *rit = L'x';
    for (; rit != c1.rend(); ++rit)
        System::Console::Write("{0} ", *rit);
    System::Console::WriteLine();
    return (0);
    }
c b a
x b a

list:: size (STL/CLR)list::size (STL/CLR)

Liczy liczbę elementów.Counts the number of elements.

SkładniaSyntax

size_type size();

UwagiRemarks

Funkcja członkowska zwraca długość kontrolowanej sekwencji.The member function returns the length of the controlled sequence. Służy do określania liczby elementów aktualnie w kontrolowanej sekwencji.You use it to determine the number of elements currently in the controlled sequence. Jeśli dowiesz się, czy sekwencja ma rozmiar różny od zera, zobacz list:: empty (STL/CLR) () .If all you care about is whether the sequence has nonzero size, see list::empty (STL/CLR)().

PrzykładExample

// cliext_list_size.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    System::Console::WriteLine("size() = {0} starting with 3", c1.size());

    // clear the container and reinspect
    c1.clear();
    System::Console::WriteLine("size() = {0} after clearing", c1.size());

    // add elements and clear again
    c1.push_back(L'a');
    c1.push_back(L'b');
    System::Console::WriteLine("size() = {0} after adding 2", c1.size());
    return (0);
    }
a b c
size() = 3 starting with 3
size() = 0 after clearing
size() = 2 after adding 2

list:: size_type (STL/CLR)list::size_type (STL/CLR)

Typ podpisanej odległości między dwoma elementami.The type of a signed distance between two element.

SkładniaSyntax

typedef int size_type;

UwagiRemarks

Typ opisuje nieujemną liczbę elementów.The type describes a non-negative element count.

PrzykładExample

// cliext_list_size_type.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // compute positive difference
    cliext::list<wchar_t>::size_type diff = 0;
    for (cliext::list<wchar_t>::iterator it = c1.begin();
        it != c1.end(); ++it)
        ++diff;
    System::Console::WriteLine("end()-begin() = {0}", diff);
    return (0);
    }
a b c
end()-begin() = 3

list:: sort (STL/CLR)list::sort (STL/CLR)

Zamówienie kontrolowanej sekwencji.Orders the controlled sequence.

SkładniaSyntax

void sort();
template<typename Pred2>
    void sort(Pred2 pred);

ParametryParameters

predpred
Funkcja porównująca dla par elementów.Comparer for element pairs.

UwagiRemarks

Pierwsza funkcja członkowska zmienia elementy w kontrolowanej sekwencji tak, aby były uporządkowane według operator< --elementy nie zmniejszają wartości podczas wykonywania sekwencji.The first member function rearranges the elements in the controlled sequence so that they are ordered by operator< -- elements do not decrease in value as you progress through the sequence. Ta funkcja członkowska służy do sortowania sekwencji w kolejności rosnącej.You use this member function to sort the sequence in increasing order.

Druga funkcja członkowska zachowuje się tak samo jak pierwszy, z tą różnicą, że sekwencja jest uporządkowana przez pred -- pred(X, Y) wartość false dla każdego elementu X , który następuje po elemencie Y w wynikowej sekwencji.The second member function behaves the same as the first, except that the sequence is ordered by pred -- pred(X, Y) is false for any element X that follows element Y in the resultant sequence. Służy do sortowania sekwencji w kolejności określonej przez funkcję predykatu lub delegata.You use it to sort the sequence in an order that you specify by a predicate function or delegate.

Obie funkcje wykonują stabilne sortowanie — żadna para elementów w oryginalnej kontrolowanej sekwencji nie jest odwrócona w wyniku kontrolowanej sekwencji.Both functions perform a stable sort -- no pair of elements in the original controlled sequence is reversed in the resulting controlled sequence.

PrzykładExample

// cliext_list_sort.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // sort descending and redisplay
    c1.sort(cliext::greater<wchar_t>());
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // sort ascending and redisplay
    c1.sort();
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
c b a
a b c

list:: splice (STL/CLR)list::splice (STL/CLR)

Połącz linki między węzłami.Restitch links between nodes.

SkładniaSyntax

void splice(iterator where, list<Value>% right);
void splice(iterator where, list<Value>% right,
    iterator first);
void splice(iterator where, list<Value>% right,
    iterator first, iterator last);

ParametryParameters

pierwszegofirst
Początek zakresu do odłączenia.Beginning of range to splice.

ostatniegolast
Koniec zakresu do odłączenia.End of range to splice.

Kliknijright
Kontener, z którego ma zostać nadana Metoda łączenia.Container to splice from.

miejscuwhere
Gdzie w kontenerze mają być nałączenia przed.Where in container to splice before.

UwagiRemarks

Pierwsza funkcja członkowska wstawia sekwencję sterowaną przez prawo przed elementem w kontrolowanej sekwencji wskazywanym przez WHERE.The first member function inserts the sequence controlled by right before the element in the controlled sequence pointed to by where. Usuwa również wszystkie elementy z prawej strony.It also removes all elements from right. ( %right nie może być równe this ). Służy do łączenia wszystkich jednej listy z inną.(%right must not equal this.) You use it to splice all of one list into another.

Druga funkcja członkowska usuwa element wskazany najpierw w sekwencji kontrolowanej przez prawo i wstawia go przed elementem w kontrolowanej sekwencji wskazywanym przez WHERE.The second member function removes the element pointed to by first in the sequence controlled by right and inserts it before the element in the controlled sequence pointed to by where. (Jeśli where == first || where == ++first, nie nastąpi zmiana.) Służy do łączenia pojedynczego elementu jednej listy w inny.(If where == first || where == ++first, no change occurs.) You use it to splice a single element of one list into another.

Trzecia funkcja członkowska wstawia Podzakres wyznaczone przez [ first , last ) z sekwencji kontrolowanej przez prawo przed elementem w kontrolowanej sekwencji wskazywanym przez WHERE.The third member function inserts the subrange designated by [first, last) from the sequence controlled by right before the element in the controlled sequence pointed to by where. Powoduje również usunięcie oryginalnego podzakresu z sekwencji kontrolowanej przez prawo.It also removes the original subrange from the sequence controlled by right. (Jeśli right == this zakres [ first , last ) nie może zawierać elementu wskazywanego przez WHERE.) Służy do łączenia podsekwencji zero lub więcej elementów z jednej listy do innej.(If right == this, the range [first, last) must not include the element pointed to by where.) You use it to splice a subsequence of zero or more elements from one list into another.

PrzykładExample

// cliext_list_splice.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // splice to a new list
    cliext::list<wchar_t> c2;
    c2.splice(c2.begin(), c1);
    System::Console::WriteLine("c1.size() = {0}", c1.size());
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // return one element
    c1.splice(c1.end(), c2, c2.begin());
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // return remaining elements
    c1.splice(c1.begin(), c2, c2.begin(), c2.end());
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    System::Console::WriteLine("c2.size() = {0}", c2.size());
    return (0);
    }
a b c
c1.size() = 0
a b c
a
b c
b c a
c2.size() = 0

list:: swap (STL/CLR)list::swap (STL/CLR)

Zamienia zawartości dwóch kontenerów.Swaps the contents of two containers.

SkładniaSyntax

void swap(list<Value>% right);

ParametryParameters

Kliknijright
Kontener, za pomocą którego ma zostać zamieniony zawartość.Container to swap contents with.

UwagiRemarks

Funkcja członkowska zamienia kontrolowane sekwencje między *this i po prawej.The member function swaps the controlled sequences between *this and right. Robi to w stałym czasie i nie zgłasza wyjątków.It does so in constant time and it throws no exceptions. Jest ona używana jako Szybka metoda wymiany zawartości dwóch kontenerów.You use it as a quick way to exchange the contents of two containers.

PrzykładExample

// cliext_list_swap.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // construct another container with repetition of values
    cliext::list<wchar_t> c2(5, L'x');
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // swap and redisplay
    c1.swap(c2);
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c
x x x x x
x x x x x
a b c

list:: to_array (STL/CLR)list::to_array (STL/CLR)

Kopiuje przekontrolowaną sekwencję do nowej tablicy.Copies the controlled sequence to a new array.

SkładniaSyntax

cli::array<Value>^ to_array();

UwagiRemarks

Funkcja członkowska zwraca tablicę zawierającą kontrolowaną sekwencję.The member function returns an array containing the controlled sequence. Służy do uzyskania kopii kontrolowanej sekwencji w formularzu tablicowym.You use it to obtain a copy of the controlled sequence in array form.

PrzykładExample

// cliext_list_to_array.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // copy the container and modify it
    cli::array<wchar_t>^ a1 = c1.to_array();

    c1.push_back(L'd');
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // display the earlier array copy
    for each (wchar_t elem in a1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a b c d
a b c

list:: Unique (STL/CLR)list::unique (STL/CLR)

Usuwa przylegające elementy, które przechodzą do określonego testu.Removes adjacent elements that pass a specified test.

SkładniaSyntax

void unique();
template<typename Pred2>
    void unique(Pred2 pred);

ParametryParameters

predpred
Funkcja porównująca dla par elementów.Comparer for element pairs.

UwagiRemarks

Pierwsza funkcja członkowska usuwa z kontrolowanej sekwencji (wymazuje) każdy element, który porównuje równe jego poprzedzającego elementu — Jeśli element X poprzedza element Y i X == Y , funkcja członkowska usunie Y .The first member function removes from the controlled sequence (erases) every element that compares equal to its preceding element -- if element X precedes element Y and X == Y, the member function removes Y. Jest on używany do usuwania wszystkich, ale jednej kopii każdej podsekwencji sąsiadujących elementów porównywanych z równą.You use it to remove all but one copy of every subsequence of adjacent elements that compare equal. Należy zauważyć, że w przypadku uporządkowania kontrolowanej sekwencji, na przykład przez wywołanie list:: sort (STL/CLR) () , funkcja członkowska pozostawia tylko elementy z unikatowymi wartościami.Note that if the controlled sequence is ordered, such as by calling list::sort (STL/CLR)(), the member function leaves only elements with unique values. (W związku z tym nazwa).(Hence the name).

Druga funkcja członkowska zachowuje się tak samo jak pierwszy, z tą różnicą, że usuwa każdy element Y po elemencie, X dla którego pred(X, Y) .The second member function behaves the same as the first, except that it removes each element Y following an element X for which pred(X, Y). Jest on używany do usuwania wszystkich, ale jednej kopii każdej podsekwencji sąsiadujących elementów, które spełniają określone przez Ciebie funkcje predykatu lub delegata.You use it to remove all but one copy of every subsequence of adjacent elements that satisfy a predicate function or delegate that you specify. Należy zauważyć, że w przypadku uporządkowania kontrolowanej sekwencji, na przykład przez wywołanie sort(pred) , funkcja członkowska pozostawia tylko elementy, które nie mają równoważnej kolejności z innymi elementami.Note that if the controlled sequence is ordered, such as by calling sort(pred), the member function leaves only elements that do not have equivalent ordering with any other elements.

PrzykładExample

// cliext_list_unique.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display initial contents " a a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // display contents after unique
    cliext::list<wchar_t> c2(c1);
    c2.unique();
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // display contents after unique(not_equal_to)
    c2 = c1;
    c2.unique(cliext::not_equal_to<wchar_t>());
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();
    return (0);
    }
a a b c
a b c
a a

list:: value_type (STL/CLR)list::value_type (STL/CLR)

Typ elementu.The type of an element.

SkładniaSyntax

typedef Value value_type;

UwagiRemarks

Typ jest synonimem dla wartościparametru szablonu.The type is a synonym for the template parameter Value.

PrzykładExample

// cliext_list_value_type.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c" using value_type
    for (cliext::list<wchar_t>::iterator it = c1.begin();
        it != c1.end(); ++it)
        {   // store element in value_type object
        cliext::list<wchar_t>::value_type val = *it;

        System::Console::Write("{0} ", val);
        }
    System::Console::WriteLine();
    return (0);
    }
a b c

operator! = (lista) (STL/CLR)operator!= (list) (STL/CLR)

Nierówne porównanie.List not equal comparison.

SkładniaSyntax

template<typename Value>
    bool operator!=(list<Value>% left,
        list<Value>% right);

ParametryParameters

lewymleft
Lewy kontener do porównania.Left container to compare.

Kliknijright
Prawy kontener do porównania.Right container to compare.

UwagiRemarks

Funkcja operatora zwraca wartość !(left == right) .The operator function returns !(left == right). Służy do sprawdzania, czy nie jest on uporządkowany tak samo jak w przypadku porównywania dwóch list w element według elementu.You use it to test whether left is not ordered the same as right when the two lists are compared element by element.

PrzykładExample

// cliext_list_operator_ne.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2.push_back(L'a');
    c2.push_back(L'b');
    c2.push_back(L'd');

    // display contents " a b d"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    System::Console::WriteLine("[a b c] != [a b c] is {0}",
        c1 != c1);
    System::Console::WriteLine("[a b c] != [a b d] is {0}",
        c1 != c2);
    return (0);
    }
a b c
a b d
[a b c] != [a b c] is False
[a b c] != [a b d] is True

operator < (list) (STL/CLR)operator< (list) (STL/CLR)

Lista jest mniejsza niż porównanie.List less than comparison.

SkładniaSyntax

template<typename Value>
    bool operator<(list<Value>% left,
        list<Value>% right);

ParametryParameters

lewymleft
Lewy kontener do porównania.Left container to compare.

Kliknijright
Prawy kontener do porównania.Right container to compare.

UwagiRemarks

Funkcja operator zwraca wartość true, jeśli dla najniższej pozycji i !(right[i] < left[i]) ma również wartość true left[i] < right[i] .The operator function returns true if, for the lowest position i for which !(right[i] < left[i]) it is also true that left[i] < right[i]. W przeciwnym razie zwraca jego left->size() < right->size() użycie, aby sprawdzić, czy lewo jest uporządkowane przed prawem , gdy dwie listy są porównywane elementów według elementu.Otherwise, it returns left->size() < right->size() You use it to test whether left is ordered before right when the two lists are compared element by element.

PrzykładExample

// cliext_list_operator_lt.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2.push_back(L'a');
    c2.push_back(L'b');
    c2.push_back(L'd');

    // display contents " a b d"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    System::Console::WriteLine("[a b c] < [a b c] is {0}",
        c1 < c1);
    System::Console::WriteLine("[a b c] < [a b d] is {0}",
        c1 < c2);
    return (0);
    }
a b c
a b d
[a b c] < [a b c] is False
[a b c] < [a b d] is True

operator < = (list) (STL/CLR)operator<= (list) (STL/CLR)

Lista jest mniejsza niż lub równa.List less than or equal comparison.

SkładniaSyntax

template<typename Value>
    bool operator<=(list<Value>% left,
        list<Value>% right);

ParametryParameters

lewymleft
Lewy kontener do porównania.Left container to compare.

Kliknijright
Prawy kontener do porównania.Right container to compare.

UwagiRemarks

Funkcja operatora zwraca wartość !(right < left) .The operator function returns !(right < left). Służy do sprawdzania, czy nie jest on uporządkowany po prawej stronie , gdy dwie listy są porównywane elementów według elementu.You use it to test whether left is not ordered after right when the two lists are compared element by element.

PrzykładExample

// cliext_list_operator_le.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2.push_back(L'a');
    c2.push_back(L'b');
    c2.push_back(L'd');

    // display contents " a b d"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    System::Console::WriteLine("[a b c] <= [a b c] is {0}",
        c1 <= c1);
    System::Console::WriteLine("[a b d] <= [a b c] is {0}",
        c2 <= c1);
    return (0);
    }
a b c
a b d
[a b c] <= [a b c] is True
[a b d] <= [a b c] is False

operator = = (lista) (STL/CLR)operator== (list) (STL/CLR)

Wyświetl równe porównanie.List equal comparison.

SkładniaSyntax

template<typename Value>
    bool operator==(list<Value>% left,
        list<Value>% right);

ParametryParameters

lewymleft
Lewy kontener do porównania.Left container to compare.

Kliknijright
Prawy kontener do porównania.Right container to compare.

UwagiRemarks

Funkcja operator zwraca wartość true tylko wtedy, gdy sekwencje sterowane przez lewo i prawo mają taką samą długość i, dla każdej pozycji i left[i] == right[i] .The operator function returns true only if the sequences controlled by left and right have the same length and, for each position i, left[i] == right[i]. Służy do sprawdzania, czy lewa jest uporządkowana tak samo jak w przypadku porównywania dwóch list elementów według elementu.You use it to test whether left is ordered the same as right when the two lists are compared element by element.

PrzykładExample

// cliext_list_operator_eq.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2.push_back(L'a');
    c2.push_back(L'b');
    c2.push_back(L'd');

    // display contents " a b d"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    System::Console::WriteLine("[a b c] == [a b c] is {0}",
        c1 == c1);
    System::Console::WriteLine("[a b c] == [a b d] is {0}",
        c1 == c2);
    return (0);
    }
a b c
a b d
[a b c] == [a b c] is True
[a b c] == [a b d] is False

operator > (list) (STL/CLR)operator> (list) (STL/CLR)

Lista większa niż porównanie.List greater than comparison.

SkładniaSyntax

template<typename Value>
    bool operator>(list<Value>% left,
        list<Value>% right);

ParametryParameters

lewymleft
Lewy kontener do porównania.Left container to compare.

Kliknijright
Prawy kontener do porównania.Right container to compare.

UwagiRemarks

Funkcja operatora zwraca wartość right < left .The operator function returns right < left. Służy do sprawdzania, czy lewa jest uporządkowana po prawej stronie , gdy dwie listy są porównywane elementów według elementu.You use it to test whether left is ordered after right when the two lists are compared element by element.

PrzykładExample

// cliext_list_operator_gt.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2.push_back(L'a');
    c2.push_back(L'b');
    c2.push_back(L'd');

    // display contents " a b d"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    System::Console::WriteLine("[a b c] > [a b c] is {0}",
        c1 > c1);
    System::Console::WriteLine("[a b d] > [a b c] is {0}",
        c2 > c1);
    return (0);
    }
a b c
a b d
[a b c] > [a b c] is False
[a b d] > [a b c] is True

operator > = (list) (STL/CLR)operator>= (list) (STL/CLR)

Lista jest większa lub równa porównaniu.List greater than or equal comparison.

SkładniaSyntax

template<typename Value>
    bool operator>=(list<Value>% left,
        list<Value>% right);

ParametryParameters

lewymleft
Lewy kontener do porównania.Left container to compare.

Kliknijright
Prawy kontener do porównania.Right container to compare.

UwagiRemarks

Funkcja operatora zwraca wartość !(left < right) .The operator function returns !(left < right). Służy do sprawdzania, czy nie jest on uporządkowany przed prawem , gdy dwie listy są porównywane elementów według elementu.You use it to test whether left is not ordered before right when the two lists are compared element by element.

PrzykładExample

// cliext_list_operator_ge.cpp
// compile with: /clr
#include <cliext/list>

int main()
    {
    cliext::list<wchar_t> c1;
    c1.push_back(L'a');
    c1.push_back(L'b');
    c1.push_back(L'c');

    // display contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // assign to a new container
    cliext::list<wchar_t> c2;
    c2.push_back(L'a');
    c2.push_back(L'b');
    c2.push_back(L'd');

    // display contents " a b d"
    for each (wchar_t elem in c2)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    System::Console::WriteLine("[a b c] >= [a b c] is {0}",
        c1 >= c1);
    System::Console::WriteLine("[a b c] >= [a b d] is {0}",
        c1 >= c2);
    return (0);
    }
a b c
a b d
[a b c] >= [a b c] is True
[a b c] >= [a b d] is False