extent-Klasse (C++ AMP)

Stellt einen Vektor von N-Ganzzahlwerten dar, die die Grenzen eines N-dimensionalen Raums angeben, der einen Ursprung von 0 hat. Die Werte im Vektor sind vom wichtigsten zum am wenigsten wichtigen Wert sortiert.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
Der Rang des extent-Objekts.

Requirements

Kopfzeile: amp.h

Namespace: Gleichzeitigkeit

Members

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Operatoren

Öffentliche Konstanten

Vererbungshierarchie

extent

contains

Gibt an, ob der angegebene Indexwert im extent Objekt enthalten ist.

Syntax

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

Parameters

_Index
Der zu testende index-Wert.

Rückgabewert

true wenn der angegebene Indexwert im extent Objekt enthalten ist; andernfalls false.

extent

Initialisiert eine neue Instanz der extent-Klasse.

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
Ein Array mit ganzen _Rank-Zahlen, mit dem das neue extent-Objekt erstellt wird.

_I
Die Länge des Bereichs.

_I0
Die Länge der wichtigsten Dimension.

_I1
Die Länge der zweitwichtigsten Dimension.

_I2
Die Länge der unwichtigsten Dimension.

_Other
Ein extent-Objekt, auf dem das neue extent-Objekt basiert.

Remarks

Der Standardkonstruktor initialisiert ein extent Objekt mit einer Rangfolge von drei.

Wenn ein Array verwendet wird, um ein extent-Objekt zu erstellen, muss die Länge des Arrays mit dem Rang des extent-Objekts übereinstimmen.

operator%=

Berechnet den Modulus (Rest) jedes Elements, extent wenn das Element durch eine Zahl dividiert wird.

Syntax

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

Parameters

_Rhs
Die Zahl, deren Modulus gefunden werden soll.

Rückgabewert

Das extent-Objekt.

operator*=

Multipliziert jedes Element im extent Objekt mit der angegebenen Zahl.

Syntax

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

Parameters

_Rhs
Die zu multiplizierende Zahl.

Rückgabewert

Das extent-Objekt.

operator+

Gibt ein neues extent-Objekt zurück, das durch Hinzufügen der entsprechenden index- und extent-Elemente erstellt wird.

Syntax

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

Parameters

_Rhs
Das index-Objekt, das die hinzuzufügenden Elemente enthält.

Rückgabewert

Das neue extent-Objekt.

operator++

Inkrementiert jedes Element des extent-Objekts.

Syntax

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

Rückgabewert

Für den Präfixoperator das extent-Objekt (*this). Für den Suffixoperator ein neues extent-Objekt.

operator+=

Fügt die angegebene Zahl jedem Element des extent-Objekts hinzu.

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
Die Zahl, der Index oder das Ausmaß, das hinzugefügt werden soll.

Rückgabewert

Das resultierende extent-Objekt.

operator-

Erstellt ein neues extent-Objekt durch Subtrahieren der einzelnen Elemente im angegebenen index-Objekt vom entsprechenden Element in diesem extent-Objekt.

Syntax

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

Parameters

_Rhs
Das index-Objekt, das die zu subtrahierenden Elemente enthält.

Rückgabewert

Das neue extent-Objekt.

operator--

Verringert jedes Element im extent Objekt.

Syntax

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

Rückgabewert

Für den Präfixoperator das extent-Objekt (*this). Für den Suffixoperator ein neues extent-Objekt.

operator/=

Dividiert jedes Element im extent Objekt durch die angegebene Zahl.

Syntax

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

Parameters

_Rhs
Die Zahl, durch die dividiert wird.

Rückgabewert

Das extent-Objekt.

operator-=

Subtrahiert die angegebene Anzahl von jedem Element des extent-Objekts.

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
Die zu subtrahierende Zahl.

Rückgabewert

Das resultierende extent-Objekt.

operator=

Kopiert den Inhalt eines anderen extent-Objekts in dieses Objekt.

Syntax

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

Parameters

_Other
Das extent-Objekt, aus dem kopiert werden soll.

Rückgabewert

Ein Verweis auf das extent-Objekt.

extent::operator []

Gibt das Element am angegebenen Index zurück.

Syntax

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

Parameters

_Index
Eine ganze Zahl von 0 bis Rang minus 1.

Rückgabewert

Das Element am angegebenen Index.

rank

Speichert den Rang des extent-Objekts.

Syntax

static const int rank = _Rank;

size

Gibt die lineare Gesamtgröße des extent Objekts (in Elementeinheiten) zurück.

Syntax

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

tile

Erzeugt ein tiled_extent -Objekt mit den angegebenen Kachelabmessungen.

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
Die bedeutendste Komponente des gekachelten Bereichs.

_Dim1
Die zweitwichtigste Komponente des gekachelten Bereichs.

_Dim2
Die am wenigsten signifikante Komponente des gekachelten Ausdehnungsbereichs.

Siehe auch

Concurrency-Namespace (C++ AMP)