extent, classe (C++ AMP)
Représente un vecteur de valeurs entières N qui spécifient les limites d’un espace n dimensionnel ayant une origine de 0. Les valeurs du vecteur sont classées de la plus importante à la moins significative.
Syntaxe
template <int _Rank>
class extent;
Paramètres
_Rang
Rang de l’objet extent
.
Spécifications
En-tête : amp.h
Espace de noms : Concurrency
Membres
Constructeurs publics
Nom | Description |
---|---|
Constructeur d’étendue | Initialise une nouvelle instance de la classe extent . |
Méthodes publiques
Nom | Description |
---|---|
contains | Vérifie que l’objet spécifié extent a le rang spécifié. |
size | Retourne la taille linéaire totale de l’étendue (en unités d’éléments). |
Tuile | Produit un tiled_extent objet avec les étendues de vignette fournies par les dimensions spécifiées. |
Opérateurs publics
Nom | Description |
---|---|
operator- | Retourne un nouvel extent objet créé en soustrayant les index éléments des éléments correspondants extent . |
operator-- | Décrémente chaque élément de l’objet extent . |
operator%= | Calcule le module (reste) de chaque élément de l’objet extent lorsque cet élément est divisé par un nombre. |
operator*= | Multiplie chaque élément de l’objet extent par un nombre. |
operator/= | Divise chaque élément de l’objet extent par un nombre. |
extent ::operator[] | Retourne l’élément qui se trouve à l’index spécifié. |
operator+ | Retourne un nouvel extent objet créé en ajoutant les éléments et extent les éléments correspondantsindex . |
operator++ | Incrémente chaque élément de l’objet extent . |
operator+= | Ajoute le nombre spécifié à chaque élément de l’objet extent . |
operator= | Copie le contenu d’un autre extent objet dans celui-ci. |
operator-= | Soustrait le nombre spécifié de chaque élément de l’objet extent . |
Constantes publiques
Nom | Description |
---|---|
constante de classement | Obtient le rang de l’objet extent . |
Hiérarchie d'héritage
extent
contains
Indique si la valeur d’index spécifiée est contenue dans l’objetextent
.
Syntaxe
bool contains(const index<rank>& _Index) const restrict(amp,cpu);
Paramètres
_Index
Valeur index
à tester.
Valeur de retour
true
si la valeur d’index spécifiée est contenue dans l’objet extent
; sinon, false
.
extent
Initialise une nouvelle instance de la classe extent
.
Syntaxe
extent() restrict(amp,cpu);
extent(const extent<_Rank>& _Other) restrict(amp,cpu);
explicit extent(int _I) restrict(amp,cpu);
extent(int _I0, int _I1) restrict(amp,cpu);
extent(int _I0, int _I1, int _I2) restrict(amp,cpu);
explicit extent(const int _Array[_Rank])restrict(amp,cpu);
Paramètres
_Array
Tableau d’entiers _Rank
utilisés pour créer l’objet extent
.
_I
Longueur de l’étendue.
_I0
Longueur de la dimension la plus importante.
_I1
Longueur de la dimension la plus importante à côté.
_I2
Longueur de la dimension la moins significative.
_Autres
Objet extent
sur lequel le nouvel extent
objet est basé.
Notes
Le constructeur par défaut initialise un extent
objet qui a le rang de trois.
Si un tableau est utilisé pour construire un extent
objet, la longueur du tableau doit correspondre au rang de l’objet extent
.
operator%=
Calcule le module (reste) de chaque élément dans le extent
moment où cet élément est divisé par un nombre.
Syntaxe
extent<_Rank>& operator%=(int _Rhs) restrict(cpu, direct3d);
Paramètres
_Rhs
Nombre à rechercher le modulus de.
Valeur de retour
Objet extent
.
operator*=
Multiplie chaque élément de l’objet extent
par le nombre spécifié.
Syntaxe
extent<_Rank>& operator*=(int _Rhs) restrict(amp,cpu);
Paramètres
_Rhs
Nombre à multiplier.
Valeur de retour
Objet extent
.
operator+
Retourne un nouvel extent
objet créé en ajoutant les éléments et extent
les éléments correspondantsindex
.
Syntaxe
extent<_Rank> operator+(const index<_Rank>& _Rhs) restrict(amp,cpu);
Paramètres
_Rhs
Objet index
qui contient les éléments à ajouter.
Valeur de retour
Nouvel objet extent
.
operator++
Incrémente chaque élément de l’objet extent
.
Syntaxe
extent<_Rank>& operator++() restrict(amp,cpu);
extent<_Rank> operator++(int)restrict(amp,cpu);
Valeur de retour
Pour l’opérateur de préfixe, l’objet extent
(*this
). Pour l’opérateur de suffixe, un nouvel extent
objet.
operator+=
Ajoute le nombre spécifié à chaque élément de l’objet extent
.
Syntaxe
extent<_Rank>& operator+=(const extent<_Rank>& _Rhs) restrict(amp,cpu);
extent<_Rank>& operator+=(const index<_Rank>& _Rhs) restrict(amp,cpu);
extent<_Rank>& operator+=(int _Rhs) restrict(amp,cpu);
Paramètres
_Rhs
Nombre, index ou extension à ajouter.
Valeur de retour
Objet extent
obtenu.
operator-
Crée un extent
objet en soustrayant chaque élément de l’objet spécifié index
de l’élément correspondant dans cet extent
objet.
Syntaxe
extent<_Rank> operator-(const index<_Rank>& _Rhs) restrict(amp,cpu);
Paramètres
_Rhs
Objet index
qui contient les éléments à soustraire.
Valeur de retour
Nouvel objet extent
.
operator--
Décrémente chaque élément de l’objet extent
.
Syntaxe
extent<_Rank>& operator--() restrict(amp,cpu);
extent<_Rank> operator--(int)restrict(amp,cpu);
Valeur de retour
Pour l’opérateur de préfixe, l’objet extent
(*this
). Pour l’opérateur de suffixe, un nouvel extent
objet.
operator/=
Divise chaque élément de l’objet extent
par le nombre spécifié.
Syntaxe
extent<_Rank>& operator/=(int _Rhs) restrict(amp,cpu);
Paramètres
_Rhs
Nombre à diviser.
Valeur de retour
Objet extent
.
operator-=
Soustrait le nombre spécifié de chaque élément de l’objet extent
.
Syntaxe
extent<_Rank>& operator-=(const extent<_Rank>& _Rhs) restrict(amp,cpu);
extent<_Rank>& operator-=(const index<_Rank>& _Rhs) restrict(amp,cpu);
extent<_Rank>& operator-=(int _Rhs) restrict(amp,cpu);
Paramètres
_Rhs
Nombre à soustraire.
Valeur de retour
Objet extent
obtenu.
opérateur =
Copie le contenu d’un autre extent
objet dans celui-ci.
Syntaxe
extent<_Rank>& operator=(const extent<_Rank>& _Other) restrict(amp,cpu);
Paramètres
_Autres
Objet extent
à copier.
Valeur de retour
Référence à cet extent
objet.
extent ::operator []
Retourne l’élément qui se trouve à l’index spécifié.
Syntaxe
int operator[](unsigned int _Index) const restrict(amp,cpu);
int& operator[](unsigned int _Index) restrict(amp,cpu);
Paramètres
_Index
Entier compris entre 0 et le rang moins 1.
Valeur de retour
Élément qui se trouve à l’index spécifié.
rank
Stocke le rang de l’objet extent
.
Syntaxe
static const int rank = _Rank;
size
Retourne la taille linéaire totale de l’objet extent
(en unités d’éléments).
Syntaxe
unsigned int size() const restrict(amp,cpu);
tile
Produit un objet tiled_extent avec les dimensions de vignette spécifiées.
template <int _Dim0>
tiled_extent<_Dim0> tile() const ;
template <int _Dim0, int _Dim1>
tiled_extent<_Dim0, _Dim1> tile() const ;
template <int _Dim0, int _Dim1, int _Dim2>
tiled_extent<_Dim0, _Dim1, _Dim2> tile() const ;
Paramètres
_Dim0
Composant le plus significatif de l’étendue en mosaïque.
_Dim1
Composant suivant à la plus importante de l’étendue en mosaïque.
_Dim2
Composant le moins significatif de l’étendue en mosaïque.
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour