winrt：：vector_base 結構範本 (C++/WinRT)

  • 發行項

基類，您可以從中衍生來實作自己的自訂不可觀察的一般用途集合。 如需詳細資訊和程式碼範例，請參閱 使用 C++/WinRT 的集合。

語法

template <typename D, typename T>
struct vector_base : vector_view_base<D, T, winrt::impl::collection_version>

範本參數

typename D 您的衍生類型名稱。

typename Tvector_base中的專案類型。

規格需求

最低支援的 SDK：Windows SDK 10.0.17763.0 版 (Windows 10 版本 1809)

命名空間： winrt

標頭： %WindowsSdkDir%IncludeWindowsTargetPlatformVersion <> \cppwinrt\winrt\base. (h 預設包含)

成員函數

函式 描述
vector_base：：Append 函式 將專案附加至 vector_base 物件的結尾。
vector_base：：Clear 函式 從 vector_base 物件中移除所有元素。
vector_base：：First 函式 擷取 IIterator ，代表 vector_base 物件中的第一個專案。
vector_base：：GetAt 函式 擷取 vector_base 物件中 指定索引處的專案。
vector_base：：GetMany 函式 從指定索引開始，擷取 vector_base 物件中的專案集合。
vector_base：：GetView 函式 擷取 vector_base 物件的不可變檢視。
vector_base：：IndexOf 函式 擷取 vector_base 物件中指定專案的索引。
vector_base：：InsertAt 函式 在 vector_base 物件中指定的索引處插入專案。
vector_base：：RemoveAt 函式 移除 vector_base 物件中 指定索引處的專案。
vector_base：：RemoveAtEnd 函式 從 vector_base 物件中移除最後一個專案。
vector_base：：ReplaceAll 函式 以指定的專案取代 vector_base 物件中的所有專案。
vector_base：：SetAt 函式 在 vector_base 物件中，設定位於指定索引處的專案值。
vector_base：：Size 函式 擷取 vector_base 物件中的專案數目。

迭代器

vector_base是一個範圍，該範圍是由內部可用函式所定義， (每個函式都會擷取與標準語言功能相容的反覆運算器) 。 因此，您可以使用範圍型 for 語句列舉vector_base物件中的專案。

您也可以從vector_base：：First函式擷取IIterator，並使用該函式逐一查看vector_base物件中的專案。

...
#include <iostream>
using namespace winrt;
using namespace Windows::Foundation::Collections;
...
struct MyVector :
    implements<MyVector, IVector<float>, IVectorView<float>, IIterable<float>>,
    winrt::vector_base<MyVector, float>
{
    auto& get_container() const noexcept
    {
        return m_values;
    }

    auto& get_container() noexcept
    {
        return m_values;
    }

private:
    std::vector<float> m_values{ 0.1f, 0.2f, 0.3f };
};
...
IVector<float> coll{ winrt::make<MyVector>() };

for (auto const& el : coll)
{
    std::wcout << el << std::endl;
}

IIterator<float> it{ coll.First() };
while (it.HasCurrent())
{
    std::wcout << it.Current() << std::endl;
    it.MoveNext();
}

vector_base：：Append 函式

將專案附加至 vector_base 物件的結尾。

語法

void Append(T const& value);

參數

value 要附加的專案。

vector_base：：Clear 函式

從 vector_base 物件中移除所有元素。

語法

void Clear() noexcept;

vector_base：：First 函式

擷取 IIterator ，代表 vector_base 物件中的第一個專案。

語法

auto First();

傳回值

IIterator，代表vector_base物件中的第一個專案。

vector_base：：GetAt 函式

擷取 vector_base 物件中 指定索引處的專案。

語法

T GetAt(uint32_t const index) const;

參數

index 以零起始的專案索引。

傳回值

vector_base 物件中 指定索引處的專案。

vector_base：：GetMany 函式

從指定索引開始，擷取 vector_base 物件中的專案集合。

語法

uint32_t GetMany(uint32_t const startIndex, array_view<T> values) const;

參數

startIndex 要從開始之以零起始的專案索引。

values 要複製專案的 array_view 。

傳回值

值，表示擷取的專案數目。

vector_base：：GetView 函式

擷取 vector_base 物件的不可變檢視。

語法

winrt::Windows::Foundation::Collections::IVectorView<T> GetView() const noexcept;

傳回值

IVectorView，其中包含vector_base的不可變檢視。

vector_base：：IndexOf 函式

擷取 vector_base 物件中指定專案的索引。

語法

bool IndexOf(T const& value, uint32_t& index) const noexcept;

參數

value 要尋找 的 vector_base 物件中的 專案。

index 如果找到專案，則為專案以零起始的索引，否則為 vector_base 物件中的元素數目。

傳回值

true 如果找到專案，則為 ，否則 false 為 。

vector_base：：InsertAt 函式

在 vector_base 物件中指定的索引處插入專案。

語法

void InsertAt(uint32_t const index, T const& value);

參數

index 要插入專案之以零起始的索引。

value 要插入的專案。

vector_base：：RemoveAt 函式

移除 vector_base 物件中 指定索引處的專案。

語法

void RemoveAt(uint32_t const index);

參數

index 要移除之專案之以零起始的索引。

vector_base：：RemoveAtEnd 函式

從 vector_base 物件中移除最後一個專案。

語法

void RemoveAtEnd();

vector_base：：ReplaceAll 函式

以指定的專案取代 vector_base 物件中的所有專案。

語法

void ReplaceAll(array_view<T const> value);

參數

value 包含新專案的 array_view 。

vector_base：：SetAt 函式

在 vector_base 物件中，設定位於指定索引處的專案值。

語法

void SetAt(uint32_t const index, T const& value);

參數

index 要設定其值的專案之以零起始的索引。

value 要設定的專案值。

vector_base：：Size 函式

擷取 vector_base 物件中的專案數目。

語法

uint32_t Size() const noexcept;

傳回值

值，表示 vector_base 物件中的專案數目。

另請參閱