通过

list (STL/CLR)

  • 项目

模板类描述对象控件访问双向元素的更改长的序列。 使用容器 list 管理元素序列，当双向链接列表节点，每个存储的元素。

在如下解释， GValue 相同。 Value ，除非后者是 ref 类型，因此，在与 Value^情况下。

template<typename Value>
    ref class list
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        Microsoft::VisualC::StlClr::IList<GValue>
    { ..... };

参数

  • 值
    受控序列中的元素的类型。

成员

类型定义

说明

list::const_iterator (STL/CLR)

常数的迭代器类型的控制序列的。

list::const_reference (STL/CLR)

常量的类型对元素。

list::const_reverse_iterator (STL/CLR)

常数的反向迭代器类型的控制序列的。

list::difference_type (STL/CLR)

带符号距离的类型两个元素间的。

list::generic_container (STL/CLR)

泛型接口的类型的容器。

list::generic_iterator (STL/CLR)

一个迭代的类型泛型接口的容器的。

list::generic_reverse_iterator (STL/CLR)

一个反向迭代器的类型泛型接口的容器的。

list::generic_value (STL/CLR)

一个元素的类型泛型接口的容器的。

list::iterator (STL/CLR)

一个迭代器类型的控制序列的。

list::reference (STL/CLR)

引用的类型的元素。

list::reverse_iterator (STL/CLR)

一个反向迭代器类型的控制序列的。

list::size_type (STL/CLR)

带符号距离的类型两个元素间的。

list::value_type (STL/CLR)

元素的类型。

成员函数

说明

list::assign (STL/CLR)

替换所有元素。

list::back (STL/CLR)

访问最后一个元素。

list::begin (STL/CLR)

指定受控序列的开头。

list::clear (STL/CLR)

移除所有元素。

list::empty (STL/CLR)

测试组件是否不存在。

list::end (STL/CLR)

指定受控序列的末尾。

list::erase (STL/CLR)

移除指定位置处的元素。

list::front (STL/CLR)

访问第一个元素。

list::insert (STL/CLR)

添加元素在指定的位置。

list::list (STL/CLR)

构造容器对象。

list::merge (STL/CLR)

合并两个有序受控序列。

list::pop_back (STL/CLR)

移除最后一个元素。

list::pop_front (STL/CLR)

移除第一个元素。

list::push_back (STL/CLR)

添加新的最后一个元素。

list::push_front (STL/CLR)

添加新的第一个元素。

list::rbegin (STL/CLR)

指定反转的受控序列的开头。

list::remove (STL/CLR)

移除元素与指定的值。

list::remove_if (STL/CLR)

移除通过指定测试的元素。

list::rend (STL/CLR)

指定反转的受控序列的末尾。

list::resize (STL/CLR)

更改元素的数量。

list::reverse (STL/CLR)

反转控件序列。

list::size (STL/CLR)

计算元素的数量。

list::sort (STL/CLR)

对受控序列进行排序。

list::splice (STL/CLR)

节点之间的 Restitches 链接。

list::swap (STL/CLR)

交换两个容器的内容。

list::to_array (STL/CLR)

复制控件序列到新数组。

list::unique (STL/CLR)

移除通过指定测试的相邻元素。

属性

说明

list::back_item (STL/CLR)

访问最后一个元素。

list::front_item (STL/CLR)

访问第一个元素。

运算符

说明

list::operator= (STL/CLR)

替换控件序列。

operator!= (list) (STL/CLR)

确定 list 对象是否与另一 list 对象不相等。

operator< (list) (STL/CLR)

确定 list 对象是否大于另一个 list 对象小于。

operator<= (list) (STL/CLR)

确定 list 对象是否小于或等于另一 list 对象。

operator== (list) (STL/CLR)

确定 list 对象是否与另一 list 对象相等。

operator> (list) (STL/CLR)

确定 list 对象是否大于另一个 list 对象大。

operator>= (list) (STL/CLR)

确定 list 对象是否大于或等于另一 list 对象。

接口

接口

说明

ICloneable

重复的对象。

IEnumerable

顺序排列元素。

ICollection

维护元素组。

IEnumerable<T>

顺序排列类型元素。

ICollection<T>

维护类型元素的组。

IList<值>

维护泛型容器。

备注

对象分配和它所控制该序列中未使用记忆字段，而在一个双向链接单独的节点列表。 它通过修改节点之间的链接重新排列元素，传递复制一个节点内容到另一个。 这表示您可以自由插入和移除元素，而不会干扰的其余元素。 因此，该列表为基础容器的理想候选项模板类 queue (STL/CLR) 或模板类的 stack (STL/CLR)。

list 对象支持双向迭代器，这意味着可以单步执行给定的相邻元素迭代器指定在控件序列的元素。 特定头节点相对应 list::end (STL/CLR)返回的迭代器()。 如果可以减少此迭代器达到控件序列的最后一个元素，。 可以增加列表迭代器达到头节点，，并且与 end()然后将相等。 ，但不能取消引用 end()返回的迭代器。

请注意您不能引用直接给定列表元素其数字位置--它需要一个随机访问迭代器。 因此列表是 not 可用作模板类的 priority_queue (STL/CLR)foundation 容器。

列出迭代器存储的句柄。其关联的列表节点，然后存储的句柄到其关联的容器。 您只能使用迭代器与其关联的容器对象。 ，只要其关联的列表节点与一些列表，该列表迭代器保持有效。 此外，有效的迭代器 dereferencable--可以使用以便为它指定的访问或修改元素值--只要它与 end()不相等。

清除或移除元素调用其存储的值的析构函数。 销毁容器清除所有元素。 因此，元素类型为 ref 类的容器以确保组件不活动得比容器时间。 但是，请注意，容器处理执行 not 销毁其元素。

要求

标题: <cliext/列表>

命名空间: cliext

请参见

参考

deque (STL/CLR)

priority_queue (STL/CLR)

queue (STL/CLR)

stack (STL/CLR)

vector (STL/CLR)

其他资源

STL/CLR库参考