Share via


extent Class (C++ AMP)

Vertegenwoordigt een vector van N gehele getallen die de grenzen van een N-dimensionale ruimte opgeven die een oorsprong heeft van 0. De waarden in de vector worden geordend van het belangrijkst naar het minst significant.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
De rang van het extent object.

Requirements

Koptekst: amp.h

Naamruimte: Gelijktijdigheid

Members

Openbare constructors

Name Description
extent Constructor Initialiseert een nieuw exemplaar van de klasse extent.

Openbare methoden

Name Description
contains Controleert of het opgegeven extent object de opgegeven rang heeft.
size Retourneert de totale lineaire grootte van de omvang (in eenheden van elementen).
Tegel Produceert een tiled_extent object met de tegelomvang die is opgegeven door de opgegeven dimensies.

Openbare operators

Name Description
operator- Retourneert een nieuw extent object dat wordt gemaakt door de index elementen af te trekken van de bijbehorende extent elementen.
Operator-- Hiermee wordt elk element van het extent object verminderd.
operator%= Berekent de modulus (rest) van elk element in het extent object wanneer dat element wordt gedeeld door een getal.
operator*= Vermenigvuldigt elk element van het extent object met een getal.
operator/= Verdeelt elk element van het extent object door een getal.
extent::operator[] Retourneert het element dat op de opgegeven index staat.
operator+ Retourneert een nieuw extent object dat wordt gemaakt door de bijbehorende index elementen toe extent te voegen.
operator++ Hiermee wordt elk element van het extent object verhoogd.
operator+= Hiermee wordt het opgegeven getal toegevoegd aan elk element van het extent object.
operator= Hiermee kopieert u de inhoud van een ander extent object naar dit object.
operator-= Hiermee wordt het opgegeven getal afgetrokken van elk element van het extent object.

Openbare constanten

Name Description
rangconstante Hiermee haalt u de rang van het extent object op.

Overnamehiƫrarchie

extent

contains

Geeft aan of de opgegeven indexwaarde zich in het extent object bevindt.

Syntax

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

Parameters

_Index
De index waarde die moet worden getest.

Retourwaarde

true als de opgegeven indexwaarde is opgenomen in het extent object; anders false.

extent

Initialiseert een nieuw exemplaar van de klasse 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
Een matrix met _Rank gehele getallen die wordt gebruikt om het nieuwe extent object te maken.

_I
De lengte van de omvang.

_I0
De lengte van de belangrijkste dimensie.

_I1
De lengte van de op een na meest significante dimensie.

_I2
De lengte van de minst significante dimensie.

_Other
Een extent object waarop het nieuwe extent object is gebaseerd.

Remarks

De standaardconstructor initialiseert een extent object met een rang van drie.

Als een matrix wordt gebruikt om een extent object te maken, moet de lengte van de matrix overeenkomen met de positie van het extent object.

operator%=

Berekent de modulus (rest) van elk element in het extent moment dat dat element wordt gedeeld door een getal.

Syntax

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

Parameters

_Rhs
Het getal om de modulus van te vinden.

Retourwaarde

Het extent-object.

operator*=

Vermenigvuldigt elk element in het extent object met het opgegeven getal.

Syntax

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

Parameters

_Rhs
Het getal dat moet worden vermenigvuldigd.

Retourwaarde

Het extent-object.

operator+

Retourneert een nieuw extent object dat is gemaakt door de bijbehorende index elementen toe extent te voegen.

Syntax

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

Parameters

_Rhs
Het index object dat de elementen bevat die moeten worden toegevoegd.

Retourwaarde

Het nieuwe extent object.

operator++

Hiermee wordt elk element van het extent object verhoogd.

Syntax

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

Retourwaarde

Voor de prefixoperator, het extent-object (*this). Voor de operator voor achtervoegsel, een nieuw extent object.

operator+=

Hiermee wordt het opgegeven getal toegevoegd aan elk element van het extent object.

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
Het getal, de index of de omvang die u wilt toevoegen.

Retourwaarde

Het resulterende extent object.

Operator-

Hiermee maakt u een nieuw extent object door elk element in het opgegeven index object af te trekken van het bijbehorende element in dit extent object.

Syntax

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

Parameters

_Rhs
Het index object dat de elementen bevat die moeten worden afgetrokken.

Retourwaarde

Het nieuwe extent object.

operator--

Hiermee wordt elk element in het extent object gedegraded.

Syntax

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

Retourwaarde

Voor de voorvoegseloperator, het extent-object (*this). Voor de suffixoperator een nieuw extent object.

operator/=

Verdeelt elk element in het extent object door het opgegeven getal.

Syntax

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

Parameters

_Rhs
Het getal dat moet worden gedeeld door.

Retourwaarde

Het extent-object.

operator-=

Hiermee wordt het opgegeven getal afgetrokken van elk element van het extent object.

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
Het te aftrekken getal.

Retourwaarde

Het resulterende extent object.

operator=

Hiermee kopieert u de inhoud van een ander extent object naar dit object.

Syntax

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

Parameters

_Other
Het extent object waaruit moet worden gekopieerd.

Retourwaarde

Een verwijzing naar dit extent-object.

extent::operator []

Retourneert het element dat op de opgegeven index staat.

Syntax

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

Parameters

_Index
Een geheel getal van 0 tot en met de rang minus 1.

Retourwaarde

Het element dat zich op de opgegeven index bevindt.

rank

Slaat de positie van het extent object op.

Syntax

static const int rank = _Rank;

size

Retourneert de totale lineaire grootte van het extent object (in eenheden van elementen).

Syntax

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

tile

Produceert een tiled_extent object met de opgegeven tegeldimensies.

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
Het belangrijkste element van de betegelde uitgestrektheid.

_Dim1
Het een-na-belangrijkste onderdeel van het tegelsbereik.

_Dim2
Het minst significante onderdeel van de betegelde omvang.

Zie ook

Concurrency-naamruimte (C++ AMP)