Share via


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

truesi 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

Concurrency, espace de noms (C++ AMP)