Share via


list::list (STL/CLR)

Constructs a container object.

    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);

Parameters

  • count
    Number of elements to insert.

  • first
    Beginning of range to insert.

  • last
    End of range to insert.

  • right
    Object or range to insert.

  • val
    Value of the element to insert.

Remarks

The constructor:

list();

initializes the controlled sequence with no elements. You use it to specify an empty initial controlled sequence.

The constructor:

list(list<Value>% right);

initializes the controlled sequence with the sequence [right.list::begin (STL/CLR)(), right.list::end (STL/CLR)()). You use it to specify an initial controlled sequence that is a copy of the sequence controlled by the list object right.

The constructor:

list(list<Value>^ right);

initializes the controlled sequence with the sequence [right->list::begin (STL/CLR)(), right->list::end (STL/CLR)()). 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.

The constructor:

explicit list(size_type count);

initializes the controlled sequence with count elements each with value value_type(). You use it to fill the container with elements all having the default value.

The constructor:

list(size_type count, value_type val);

initializes the controlled sequence with count elements each with value val. You use it to fill the container with elements all having the same value.

The constructor:

template<typename InIt>

list(InIt first, InIt last);

initializes the controlled sequence with the sequence [first, last). You use it to make the controlled sequence a copy of another sequence.

The constructor:

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

initializes the controlled sequence with the sequence designated by the enumerator right. You use it to make the controlled sequence a copy of another sequence described by an enumerator.

Example

// 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

Requirements

Header: <cliext/list>

Namespace: cliext

See Also

Reference

list (STL/CLR)

list::assign (STL/CLR)

list::generic_container (STL/CLR)

list::operator= (STL/CLR)