Класс Platform::Collections::VectorView
Представляет доступное только для чтения представление упорядоченной коллекции объектов, в которой возможен доступ к каждому отдельному объекту по его индексу. Тип каждого объекта в коллекции задается параметром шаблона.
Синтаксис
template <typename T, typename E>
ref class VectorView sealed;
Параметры
T
Тип элементов, содержащихся в объекте VectorView .
E
Определяет бинарный предикат для проверки равенства со значениями типа T. Значение по умолчанию — std::equal_to<T>.
Замечания
Класс VectorView реализует интерфейс Windows::Foundation::Collections::IVectorView<T> и поддержку итераторов стандартной библиотеки шаблонов.
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| VectorView::VectorView | Инициализирует новый экземпляр класса VectorView. |
Открытые методы
| Имя | Описание |
|---|---|
| VectorView::First | Возвращает итератор, указывающий первый элемент объекта VectorView. |
| VectorView::GetAt | Извлекает элемент текущего VectorView, указанный заданным индексом. |
| VectorView::GetMany | Извлекает последовательность элементов из текущего объекта VectorView, начиная с указанного индекса. |
| VectorView::IndexOf | Выполняет поиск указанного элемента в текущем объекте VectorView и возвращает его индекс, если он найден. |
| VectorView::Size | Возвращает количество элементов в текущем объекте VectorView. |
Иерархия наследования
VectorView
Требования
Заголовок: collection.h
Пространство имен: Platform::Collections
Метод VectorView::First
Возвращает итератор, указывающий первый элемент объекта VectorView.
Синтаксис
virtual Windows::Foundation::Collections::IIterator<T>^
First();
Возвращаемое значение
Итератор, указывающий первый элемент объекта VectorView.
Замечания
Удобный способ хранения итератора, возвращаемого First(), — назначить возвращаемое значение переменной, объявленной с ключевым словом вычета auto типов. Например, auto x = myVectorView->First();.
Метод VectorView::GetAt
Извлекает элемент текущего VectorView, указанный заданным индексом.
Синтаксис
T GetAt(
UInt32 index
);
Параметры
index
Целое значение без знака, отсчитываемое от нуля, которое указывает определенный элемент в объекте VectorView.
Возвращаемое значение
Элемент, заданный параметром index. Тип элемента указывается параметром шаблона VectorView, T.
Метод VectorView::GetMany
Извлекает последовательность элементов из текущего объекта VectorView, начиная с указанного индекса.
Синтаксис
virtual unsigned int GetMany(
unsigned int startIndex,
::Platform::WriteOnlyArray<T>^ dest
);
Параметры
startIndex
Отсчитываемый от нуля индекс начала элементов для извлечения.
dest
Когда эта операция завершается, массив элементов начинается с элемента, заданного startIndex, и заканчивается последним элементом объекта VectorView.
Возвращаемое значение
Количество извлеченных элементов.
Метод VectorView::IndexOf
Выполняет поиск указанного элемента в текущем объекте VectorView и возвращает его индекс, если он найден.
Синтаксис
virtual bool IndexOf(
T value,
unsigned int* index
);
Параметры
значение
Элемент, который нужно найти.
index
Отсчитываемый от нуля индекс элемента, если параметр value найден; в противном случае — 0.
Параметр индекса равен 0, если элемент является первым элементом VectorView элемента или элемент не найден. Если возвращаемое значение равно true, элемент найден и является первым элементом; в противном случае элемент не найден.
Возвращаемое значение
true Значение falseв противном случае .
Метод VectorView::Size
Возвращает количество элементов в текущем объекте VectorView.
Синтаксис
virtual property unsigned int Size;
Возвращаемое значение
Количество элементов в текущем объекте VectorView.
Конструктор VectorView::VectorView
Инициализирует новый экземпляр класса VectorView.
Синтаксис
VectorView();
explicit VectorView(
UInt32 size
);
VectorView(
UInt32 size,
T value
);
explicit VectorView(
const ::std::vector<T>& v
);
explicit VectorView(
::std::vector<T>&& v
);
VectorView(
const T * ptr,
UInt32 size
);
template <
size_t N
>
explicit VectorView(
const T (&arr)[N]
);
template <
size_t N
>
explicit VectorView(
const ::std::array<T,
N>& a
);
explicit VectorView(
const ::Platform::Array<T>^ arr
);
template <
typename InIt
>
VectorView(
InItfirst,
InItlast
);
VectorView(
std::initializer_list<T> il
);
Параметры
InIt
Тип коллекции объектов, используемой для инициализации текущего объекта VectorView.
il
Std ::initializer_list , элементы которого будут использоваться для инициализации VectorView.
N
Количество элементов в коллекции объектов, используемой для инициализации текущего объекта VectorView.
size
Количество элементов в объекте VectorView.
значение
Значение, используемое для инициализации каждого элемента в текущем объекте VectorView.
v
Lvalues и Rvalues to a std::vector , который используется для инициализации текущего VectorView.
ptr
Указатель на объект std::vector, используемый для инициализации текущего объекта VectorView.
arr
Объект Platform::Array, используемый для инициализации текущего VectorView.
a
Объект std::array, используемый для инициализации текущего VectorView.
first
Первый элемент в последовательности объектов, используемых для инициализации текущего объекта VectorView. Тип first передается с помощью идеальной пересылки. Дополнительные сведения см. в статье Декларатор ссылки Rvalue: &&.
last
Последний элемент в последовательности объектов, используемых для инициализации текущего объекта VectorView. Тип last передается с помощью идеальной пересылки. Дополнительные сведения см. в статье Декларатор ссылки Rvalue: &&.
См. также
Пространство имен платформы
Создание компонентов среды выполнения Windows на C++