extent, classe (C++ AMP)

Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. Les valeurs du vecteur sont classées de la plus importante à la moins significative.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
Rang de l’objet extent .

Requirements

Header: amp.h

Namespace: Concurrency

Members

Public Constructors

Public Methods

Public Operators

Public Constants

Inheritance Hierarchy

extent

contains

Indicates whether the specified index value is contained within the extent object.

Syntax

bool contains(const index<rank>& _Index) const restrict(amp,cpu);

Parameters

_Index
Valeur index à tester.

Return Value

true if the specified index value is contained in the extent object; otherwise, false.

extent

Initialise une nouvelle instance de la classe extent.

Syntax

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);

Parameters

_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.

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

Remarks

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.

Syntax

extent<_Rank>& operator%=(int _Rhs) restrict(cpu, direct3d);

Parameters

_Rhs
Nombre à rechercher le modulus de.

Return Value

Objet extent.

operator*=

Multiplie chaque élément de l’objet extent par le nombre spécifié.

Syntax

extent<_Rank>& operator*=(int _Rhs) restrict(amp,cpu);

Parameters

_Rhs
Nombre à multiplier.

Return Value

Objet extent.

operator+

Retourne un nouvel extent objet créé en ajoutant les éléments et index les éléments correspondantsextent.

Syntax

extent<_Rank> operator+(const index<_Rank>& _Rhs) restrict(amp,cpu);

Parameters

_Rhs
Objet index qui contient les éléments à ajouter.

Return Value

Nouvel objet extent.

operator++

Incrémente chaque élément de l’objet extent .

Syntax

extent<_Rank>& operator++() restrict(amp,cpu);
extent<_Rank> operator++(int)restrict(amp,cpu);

Return Value

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 .

Syntax

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);

Parameters

_Rhs
Nombre, index ou extension à ajouter.

Return Value

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.

Syntax

extent<_Rank> operator-(const index<_Rank>& _Rhs) restrict(amp,cpu);

Parameters

_Rhs
Objet index qui contient les éléments à soustraire.

Return Value

Nouvel objet extent.

operator--

Décrémente chaque élément de l’objet extent .

Syntax

extent<_Rank>& operator--() restrict(amp,cpu);
extent<_Rank> operator--(int)restrict(amp,cpu);

Return Value

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é.

Syntax

extent<_Rank>& operator/=(int _Rhs) restrict(amp,cpu);

Parameters

_Rhs
Nombre à diviser.

Return Value

Objet extent.

operator-=

Soustrait le nombre spécifié de chaque élément de l’objet extent .

Syntax

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);

Parameters

_Rhs
Nombre à soustraire.

Return Value

Objet extent obtenu.

operator=

Copie le contenu d’un autre extent objet dans celui-ci.

Syntax

extent<_Rank>& operator=(const extent<_Rank>& _Other) restrict(amp,cpu);

Parameters

_Other
Objet extent à copier.

Return Value

Référence à cet extent objet.

extent::operator []

Retourne l’élément qui se trouve à l’index spécifié.

Syntax

int operator[](unsigned int _Index) const restrict(amp,cpu);
int& operator[](unsigned int _Index) restrict(amp,cpu);

Parameters

_Index
Entier compris entre 0 et le rang moins 1.

Return Value

Élément qui se trouve à l’index spécifié.

rank

Stocke le rang de l’objet extent .

Syntax

static const int rank = _Rank;

size

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

Syntax

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 ;

Parameters

_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.

See also

Concurrency, espace de noms (C++ AMP)