Класс 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++