extent Class (C++ AMP)

Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. Värdena i vektorn sorteras från de viktigaste till minst signifikanta.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
Objektets extent rangordning.

Requirements

Header: amp.h

Namespace: Concurrency

Members

Public Constructors

Name Description
extent Constructor Initierar en ny instans av klassen extent.

Public Methods

Name Description
contains Verifierar att det angivna extent objektet har den angivna rangordningen.
size Returnerar den totala linjära storleken på omfattningen (i elementenheter).
tile Skapar ett tiled_extent objekt med de panelstorlekar som anges av angivna dimensioner.

Public Operators

Name Description
operator- Returnerar ett nytt extent objekt som skapas genom att subtrahera elementen index från motsvarande extent element.
operator-- Minskar varje element i extent objektet.
operator%= Beräknar modulus (rest) för varje element i objektet när elementet extent divideras med ett tal.
operator*= Multiplicerar varje element i objektet med extent ett tal.
operator/= Delar varje element i objektet med extent ett tal.
extent::operator[] Returnerar elementet som finns i det angivna indexet.
operator+ Returnerar ett nytt extent objekt som skapas genom att lägga till motsvarande index element och extent element.
operator++ Ökar varje element i extent objektet.
operator+= Lägger till det angivna talet i varje element i extent objektet.
operator= Kopierar innehållet i ett annat extent objekt till det här objektet.
operator-= Subtraherar det angivna talet från varje element i extent objektet.

Public Constants

Name Description
rank Constant Hämtar objektets extent rangordning.

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
Värdet index som ska testas.

Return Value

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

extent

Initierar en ny instans av klassen 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
En matris med _Rank heltal som används för att skapa det nya extent objektet.

_I
Längden på omfattningen.

_I0
Längden på den viktigaste dimensionen.

_I1
Längden på den näst viktigaste dimensionen.

_I2
Längden på den minst betydande dimensionen.

_Other
Ett extent objekt som det nya extent objektet baseras på.

Remarks

Standardkonstruktorn initierar ett extent objekt som har en rangordning på tre.

Om en matris används för att konstruera ett extent objekt måste matrisens längd matcha objektets extent rangordning.

operator%=

Beräknar modulus (rest) för varje element i när elementet extent divideras med ett tal.

Syntax

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

Parameters

_Rhs
Talet som ska hitta modulus för.

Return Value

Objektet extent.

operator*=

Multiplicerar varje element i objektet med extent det angivna talet.

Syntax

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

Parameters

_Rhs
Talet som ska multipliceras.

Return Value

Objektet extent.

operator+

Returnerar ett nytt extent objekt som skapats genom att lägga till motsvarande index element och extent element.

Syntax

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

Parameters

_Rhs
Objektet index som innehåller de element som ska läggas till.

Return Value

Det nya extent objektet.

operator++

Ökar varje element i extent objektet.

Syntax

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

Return Value

För prefixoperatorn extent objektet (*this). För suffixoperatorn, ett nytt extent objekt.

operator+=

Lägger till det angivna talet i varje element i extent objektet.

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
Talet, indexet eller omfattningen som ska läggas till.

Return Value

Det resulterande extent objektet.

operator-

Skapar ett nytt extent objekt genom att subtrahera varje element i det angivna index objektet från motsvarande element i det här extent objektet.

Syntax

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

Parameters

_Rhs
Objektet index som innehåller elementen som ska subtraheras.

Return Value

Det nya extent objektet.

operator--

Minskar varje element i objektet extent .

Syntax

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

Return Value

För prefixoperatorn extent objektet (*this). För suffixoperatorn, ett nytt extent objekt.

operator/=

Delar upp varje element i objektet med extent det angivna talet.

Syntax

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

Parameters

_Rhs
Talet som ska divideras med.

Return Value

Objektet extent.

operator-=

Subtraherar det angivna talet från varje element i extent objektet.

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
Talet som ska subtraheras.

Return Value

Det resulterande extent objektet.

operator=

Kopierar innehållet i ett annat extent objekt till det här objektet.

Syntax

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

Parameters

_Other
Objektet extent som ska kopieras från.

Return Value

En referens till det här extent objektet.

extent::operator []

Returnerar elementet som finns i det angivna indexet.

Syntax

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

Parameters

_Index
Ett heltal från 0 genom rangordningen minus 1.

Return Value

Elementet som finns i det angivna indexet.

rank

Lagrar objektets extent rangordning.

Syntax

static const int rank = _Rank;

size

Returnerar objektets totala linjära storlek extent (i elementenheter).

Syntax

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

tile

Skapar ett tiled_extent objekt med angivna paneldimensioner.

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
Den viktigaste komponenten i den tillagda omfattningen.

_Dim1
Den näst viktigaste komponenten i den tiled omfattningen.

_Dim2
Den minst betydande komponenten i den tillagda omfattningen.

See also

Namnområde för samtidighet (C++ AMP)