list (STL/CLR)

Статья
06/07/2013

Класс-шаблон описывает объект, элементы управления менять-длины последовательность элементов, имеющей двунаправленный доступ.Контейнер 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)	Тип подписанного диапазона от 2 элементами.
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)	Тип подписанного диапазона от 2 элементами.
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) шаблона.

Итератор списка хранит маркер в связанный обработчик действия узлу списка, который в свою очередь содержит дескриптор к его связанный контейнер.Итераторы можно использовать только с их соответствующими объект-контейнерами.Итератор списка остается допустимым, пока его связанный узел списка связан с определенным списком.Кроме того, допустимый итератор dereferencable -- его можно использовать для доступа или изменения значения элемента он обозначает -- пока она не равен end().

Стирающ или удаление элемента вызывает деструктор для своего, хранящиеся значения.Разрушать контейнер стирает все элементы.Таким образом, контейнер, тип элементов которого класс ref гарантирует, что элементы не переживают контейнер.Однако следует отметить, not удаляет контейнер маркеров делает его элементы.