Platform::WriteOnlyArray 类

项目
10/19/2023

表示一个一维数组，当调用方为要填充的方法传递数组时，可将此一维数组用作输入参数。

此 ref 类在 vccorlib.h 中声明为私有；因此，它不是通过元数据发出的，只能通过 C++ 使用它。此类仅用作输入参数，用于接收调用方分配的数组。此类无法通过用户代码构造。它允许 C++ 方法直接写入到该数组中，这种模式称为“FillArray” 模式。有关详细信息，请参阅 Array 和 WriteOnlyArray。

语法

private ref class WriteOnlyArray<T, 1>

成员

公共方法

这些方法具有内部可访问性，即，只能在 C++ 应用或组件中访问这些方法。

名称	描述
WriteOnlyArray::begin	指向数组中第一个元素的迭代器。
WriteOnlyArray::Data	指向数据缓冲区的指针。
WriteOnlyArray::end	指向数组中最后一个元素的下一位置的迭代器。
WriteOnlyArray::FastPass	指示数组能否使用 FastPass 机制，此机制是系统透明执行的优化。请勿在你的代码中使用此项
WriteOnlyArray::Length	返回数组中的元素数目。
WriteOnlyArray::set	将指定元素设置为指定值。

继承层次结构

WriteOnlyArray

要求

编译器选项： /ZW

元数据： Platform.winmd

命名空间： Platform

WriteOnlyArray::begin 方法

返回一个指向数组中第一个元素的指针。

语法

T* begin() const;

返回值

指向数组中第一个元素的指针。

注解

此迭代器可与 STL 算法（如 std::sort）一起使用以操作数组中的元素。

WriteOnlyArray::Data 属性

指向数据缓冲区的指针。

语法

property T* Data{
   T* get() const;
}

返回值

指向原始数组字节的指针。

WriteOnlyArray::end 方法

返回一个指向数组中最后一个元素的下一位置的指针。

语法

T* end() const;

返回值

指向数组中最后一个元素的下一位置的指针迭代器。

备注

此迭代器可与 STL 算法（如 std::sort）一起使用以对数组元素执行操作。

WriteOnlyArray::FastPass 属性

指示能否执行内部 FastPass 优化。不用于用户代码。

语法

property bool FastPass{
   bool get() const;
}

返回值

指示数组是否为 FastPass 的布尔值。

WriteOnlyArray::get 方法

返回指定索引处的元素。

语法

T& get(unsigned int indexArg) const;

参数

indexArg
要使用的索引。

返回值

WriteOnlyArray::Length 属性

返回调用方分配的数组中的元素数目。

语法

property unsigned int Length{
   unsigned int get() const;
}

返回值

数组中的元素数。

WriteOnlyArray::set 函数

在数组中指定索引处设置指定值。

语法

T& set(
   unsigned int indexArg,
   T valueArg);

参数

indexArg
要设置的元素的索引。

valueArg
要在 indexArg 设置的值。

返回值

对刚刚设置的元素的引用。

备注

有关如何解释 HRESULT 值的详细信息，请参阅 COM 错误代码结构。

另请参阅

Platform 命名空间
 使用 C++ 创建 Windows 运行时组件

通过