Partager via

classe extent (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 .

Exigences

En-tête : amp.h

Espace de noms : Concurrency

Members

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é.
taille Retourne la taille linéaire totale de l’étendue (en unités d’éléments).
tile 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 est situé à l’index spécifié.
operator+ Retourne un nouvel objet extent créé en ajoutant les éléments correspondants index et extent.
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

contient

Indique si la valeur d’index spécifiée est contenue dans l’objet extent .

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.

ampleur

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

_Tableau
Tableau d’entiers _Rank utilisés pour créer l’objet extent .

_Je
Longueur de l’étendue.

_I0
Longueur de la dimension la plus importante.

_I1
Longueur de la dimension juste inférieure à la plus importante.

_I2
Longueur de la dimension la moins significative.

_Autre
Objet extent sur lequel le nouvel extent objet est basé.

Remarques

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
Le nombre dont on veut calculer le module.

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 objet extent créé en ajoutant les éléments index et extent correspondants.

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, indice ou étendue à ajouter.

Valeur de retour

Objet extent obtenu.

opérateur

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 par lequel 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

_Autre
Objet extent à partir duquel copier.

Valeur de retour

Référence à cet extent objet.

extent ::operator []

Retourne l’élément qui est situé à 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é.

classement

Stocke le rang de l’objet extent .

Syntaxe

static const int rank = _Rank;

taille

Retourne la taille linéaire totale de l’objet extent (en unités d’éléments).

Syntaxe

unsigned int size() const restrict(amp,cpu);

tuile

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
Le composant le plus important de l'étendue carrelée.

_Dim1
Composant juste après le plus significatif de l'étendue en tuiles.

_Dim2
La composante la moins significative de l'étendue en tuiles.

Voir également

Espace de noms Concurrency (C++ AMP)

  • Last updated on