Partager via


Platform::WriteOnlyArray (classe)

Représente un tableau unidimensionnel utilisé comme paramètre d'entrée lorsque l'appelant transmet un tableau à remplir pour la méthode.

Cette classe ref est déclarée comme privée dans vccorlib.h. Par conséquent, elle n'est pas émise dans les métadonnées et est uniquement consommable à partir de C++. Cette classe est prévue uniquement pour être utilisée comme paramètre d'entrée qui accepte un tableau que l'appelant a alloué. Elle n'est pas constructible à partir du code utilisateur. Il permet à la méthode C++ d'écrire directement dans ce tableau, un modèle appelé modèle FillArray . Pour plus d’informations, consultez Array et WriteOnlyArray.

Syntaxe

private ref class WriteOnlyArray<T, 1>

Membres

Méthodes publiques

Ces méthodes offrent une accessibilité interne, c'est-à-dire qu'elles ne sont accessibles que dans l'application ou le composant C++.

Nom Description
WriteOnlyArray ::begin Itérateur qui pointe vers le premier élément du tableau.
WriteOnlyArray ::D ata Pointeur vers le tampon de données.
WriteOnlyArray ::end Itérateur qui pointe vers un élément au-delà du dernier élément du tableau.
WriteOnlyArray ::FastPass Indique si le tableau peut utiliser le mécanisme FastPass, qui est une optimisation exécutée en toute transparence par le système. Ne l’utilisez pas dans votre code
WriteOnlyArray ::Length Retourne le nombre d'éléments du tableau.
WriteOnlyArray ::set Définit l'élément spécifié sur la valeur spécifiée.

Hiérarchie d'héritage

WriteOnlyArray

Spécifications

Option du compilateur : /ZW

Métadonnées : platform.winmd

Espace de noms : Platform

WriteOnlyArray::begin, méthode

Retourne un pointeur désignant le premier élément du tableau.

Syntaxe

T* begin() const;

Valeur de retour

Pointeur désignant le premier élément du tableau.

Notes

Cet itérateur peut être utilisé avec les algorithmes STL tels que std::sort pour exécuter des opérations sur les élément du tableau.

WriteOnlyArray::Data, propriété

Pointeur vers le tampon de données.

Syntaxe

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

Valeur de retour

Un pointeur vers les octets bruts de tableau.

WriteOnlyArray::end, méthode

Retourne un pointeur sur un point suivant au-delà du dernier élément du tableau.

Syntaxe

T* end() const;

Valeur de retour

Itérateur de pointeur sur un point suivant au-delà du dernier élément du tableau.

Notes

Cet itérateur peut être utilisé avec les algorithmes STL pour exécuter des opérations telles que std::sort sur les éléments de tableau.

WriteOnlyArray::FastPass, propriété

Indique si l'optimisation interne FastPass peut être exécutée. Non destiné à être utilisé par le code utilisateur.

Syntaxe

property bool FastPass{
   bool get() const;
}

Valeur de retour

Valeur booléenne qui indique si le tableau est FastPass.

WriteOnlyArray::get, méthode

Retourne l'élément à l'index spécifié.

Syntaxe

T& get(unsigned int indexArg) const;

Paramètres

indexArg
Index à utiliser.

Valeur de retour

WriteOnlyArray::Length, propriété

Retourne le nombre d'éléments du tableau alloué par l'appelant.

Syntaxe

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

Valeur de retour

Nombre d’éléments dans le tableau.

WriteOnlyArray::set, fonction

Définit la valeur spécifiée à l'index spécifié dans le tableau.

Syntaxe

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

Paramètres

indexArg
Index de l'élément à définir.

valueArg
Valeur à définir à indexArg.

Valeur de retour

Référence à l'élément qui vient d'être défini.

Notes

Pour plus d’informations sur l’interprétation de la valeur HRESULT, consultez Structure des codes d’erreur COM.

Voir aussi

Espace de noms de plateforme
Création de composants Windows Runtime en C++