Класс System::Collections::Generic::List

List class

List forward declaration.

template<typename T>class List : public virtual System::Object,
                                 public System::Collections::Generic::IList<T>

Параметр	Описание
T	Тип элемента.

Nested classes

Class Enumerator

Методы

Метод	Описание
_add_range(std::initializer_list<T>)	Специфично для C++.
Add(const T&) override	Добавляет элемент в конец списка.
AddInitializer(int, const T *)	Добавляет элементы в список; используется при переводе инициализаторов.
AddRange(IEnumerablePtr)	Добавляет все элементы из коллекции (или из самого себя) в конец текущего списка.
AsReadOnly()	Получает только для чтения ссылку на эту коллекцию.
begin()	Получает итератор к первому элементу коллекции.
begin() const	Получает итератор к первому элементу константно-квалифицированной коллекции.
BinarySearch(const T&) const	Ищет элемент в отсортированном списке.
BinarySearch(const T&, const SharedPtr<System::Collections::Generic::IComparer<T>>&) const	Ищет элемент в отсортированном списке.
BinarySearch(int, int, const T&, const SharedPtr<System::Collections::Generic::IComparer<T>>&) const	Ищет элемент в отсортированном списке.
cbegin() const	Получает итератор к первому константно-квалифицированному элементу коллекции.
cend() const	Получает итератор для несуществующего константно-квалифицированного элемента за пределами коллекции.
Clear() override	Удаляет все элементы.
Contains(const T&) const override	Проверяет, присутствует ли элемент в списке.
ConvertAll(Converter<T, OutputType>)	Создаёт список элементов, преобразованных в другой тип.
CopyTo(System::ArrayPtr<T>, int) override	Копирует элементы списка в существующие элементы массива.
CopyTo(const System::ArrayPtr<T>&)	Копирует все элементы в существующие элементы массива.
CopyTo(int, const System::ArrayPtr<T>&, int, int)	Копирует элементы, начиная с указанного индекса, в существующие элементы массива.
crbegin() const	Получает обратный итератор к последнему элементу коллекции с const‑квалификатором (первый в обратном порядке).
crend() const	Получает обратный итератор для несуществующего элемента с const‑квалификатором перед началом коллекции.
data()	Функция доступа к базовой структуре данных.
data() const	Функция доступа к базовой структуре данных.
end()	Получает итератор для несуществующего элемента за пределами коллекции.
end() const	Получает итератор для несуществующего элемента за пределами константно-квалифицированной коллекции.
Exists(System::Predicate<T>)	Проверяет, существует ли элемент, соответствующий определённому предикату, в списке.
Find(System::Predicate<T>)	Ищет элемент, соответствующий определённому предикату.
FindAll(System::Predicate<T>)	Ищет элементы, соответствующие определённому предикату.
FindIndex(System::Predicate<T>)	Ищет элемент, соответствующий определённому предикату.
FindIndex(int, System::Predicate<T>)	Ищет элемент, соответствующий определённому предикату.
FindIndex(int, int, System::Predicate<T>)	Ищет элемент, соответствующий определённому предикату.
FindLast(System::Predicate<T>)	Ищет последний элемент, соответствующий определённому предикату.
ForEach(System::Action<T>)	Применяет действие ко всем элементам списка.
get_Capacity() const	Получает текущую ёмкость списка.
get_Count() const override	Получает количество элементов в текущем списке.
GetEnumerator() override	Получает перечислитель для перебора элементов списка.
GetRange(int, int)	Создаёт срез списка.
idx_get(int) const override	Получает элемент в определённой позиции.
idx_set(int, T) override	Устанавливает элемент в конкретной позиции.
IndexOf(const T&) const override	Получает первый индекс конкретного элемента.
IndexOf(const T&, int) const	Ищет конкретный элемент в списке.
Insert(int, const T&) override	Вставляет элемент в указанную позицию.
InsertRange(int, IEnumerablePtr)	Вставляет диапазон данных в определённую позицию.
LastIndexOf(const T&) const	Ищет указанный объект и возвращает нулевой индекс последнего вхождения во всём списке.
LastIndexOf(const T&, int32_t) const	Ищет указанный объект и возвращает нулевой индекс последнего вхождения в диапазоне элементов в List, который простирается от первого элемента до указанного индекса.
LastIndexOf(const T&, int32_t, int32_t) const	Ищет указанный объект и возвращает нулевой индекс последнего вхождения в диапазоне элементов в List, который содержит указанное количество элементов и заканчивается на указанном индексе.
List()	Создаёт пустой список.
List(int)	Создаёт список с предопределённой ёмкостью.
List(IEnumerablePtr)	Конструктор копирования.
operator[](int)	Функция доступа.
operator[](int) const	Функция доступа.
rbegin()	Получает обратный итератор к последнему элементу коллекции (первый в обратном порядке).
rbegin() const	Получает обратный итератор к последнему элементу const‑квалифицированной коллекции (первый в обратном порядке).
Remove(const T&) override	Удаляет первое вхождение конкретного элемента из списка.
RemoveAll(Predicate<T>)	Удаляет все элементы, соответствующие заданному предикату.
RemoveAt(int) override	Удаляет элемент в указанной позиции.
RemoveRange(int, int)	Удаляет срез списка.
rend()	Получает обратный итератор для несуществующего элемента перед началом коллекции.
rend() const	Получает обратный итератор для несуществующего элемента перед началом const‑квалифицированной коллекции.
Reverse()	Изменяет порядок элементов во всём списке на обратный.
Reverse(int, int)	Изменяет порядок элементов в срезе списка на обратный.
set_Capacity(int)	Устанавливает ёмкость списка.
Sort(const SharedPtr<System::Collections::Generic::IComparer<T>>&)	Сортирует элементы в списке.
Sort()	Сортирует элементы в списке, используя компаратор по умолчанию.
Sort(int, int, SharedPtr<System::Collections::Generic::IComparer<T>>)	Сортирует элементы в срезе списка.
Sort(Comparison<T>, bool)	Сортирует элементы в списке.
ToArray() const	Преобразует список в массив.
TrimExcess()	Устанавливает ёмкость списка, соответствующую её размеру.
TrueForAll(System::Predicate<T>)	Определяет, соответствует ли каждый элемент в коллекции условиям, определённым заданным предикатом.
virtualizeBeginConstIterator() const override	Получает реализацию константного итератора begin для текущего контейнера.
virtualizeBeginIterator() override	Получает реализацию итератора begin для текущего контейнера.
virtualizeEndConstIterator() const override	Получает реализацию константного итератора end для текущего контейнера.
virtualizeEndIterator() override	Получает реализацию итератора end для текущего контейнера.

Typedefs

Определение типа	Описание
BaseType	Тип интерфейса.
const_iterator	Тип константного итератора.
const_reverse_iterator	Тип константного обратного итератора.
IEnumerablePtr	Контейнер, содержащий элементы одного и того же типа.
IEnumeratorPtr	Тип Enumerator.
iterator	Тип итератора.
reverse_iterator	Тип обратного итератора.
ValueType	Этот тип.
vector_t	Информация RTTI.

Примечания

List - wrapper around std::vector to be used in translated code. Requires operator == to be impemented for element type. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

#include <system/collections/list.h>
#include <system/smart_ptr.h>

using namespace System;
using namespace System::Collections::Generic;

int main()
{
  // Создайте первый список.
  auto list1 = MakeObject<List<int>>();

  // Заполните первый список.
  list1->Add(3);
  list1->Add(1);
  list1->Add(-5);
  list1->Add(8);

  // Отсортируйте первый список.
  // Элементы первого списка будут: {-5, 1, 3, 8}
  list1->Sort();

  // Удалите элемент с индексом 2.
  // Элементы первого списка будут: {-5, 1, 8}
  list1->RemoveAt(2);

  // Вставьте элемент в позицию 1.
  // Элементы первого списка будут: {-5, 15, 1, 8}
  list1->Insert(1, 15);

  // Создайте второй список.
  auto list2 = MakeObject<List<int>>();

  // Заполните второй список.
  list2->Add(10);
  list2->Add(20);
  list2->Add(30);

  // Добавьте элементы из второго списка к первому.
  list1->AddRange(list2);

  // Выведите элементы первого списка.
  for (const auto item: list1)
  {
    std::cout << item << ' ';
  }

  return 0;
}
/*
This code example produces the following output:
-5 15 1 8 10 20 30
*/

См. также

System::Collections::Generic::LinkedListNode класс System::Collections::Generic::ListExt класс