Класс Platform::WriteOnlyArray
Представляет одномерный массив, который используется в качестве входного параметра, когда вызывающая сторона передает массив в метод для заполнения.
Этот класс ссылок объявлен в vccorlib.h как закрытый; следовательно, он не передается в метаданные и использовать его можно только из С++. Этот класс предназначен для использования только в качестве входного параметра, который получает массив, выделенный вызывающим объектом. Его невозможно построить из пользовательского кода. Оно позволяет методу C++ осуществлять запись непосредственно в этот массив — шаблон, известный как FillArray . Дополнительные сведения см. в разделе Array и WriteOnlyArray.
Синтаксис
private ref class WriteOnlyArray<T, 1>
Участники
Открытые методы
Эти методы имеют внутреннюю доступность, то есть доступны только в компоненте или приложении С++.
| Имя | Описание |
|---|---|
| WriteOnlyArray::begin | Итератор, который указывает на первый элемент массива. |
| WriteOnlyArray::D ata | Указатель на буфер данных. |
| 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".
См. также
Пространство имен платформы
Создание компонентов среды выполнения Windows на C++