extent-Klasse (C++ AMP)

Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. 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

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
Der zu testende index-Wert.

Return Value

true if the specified index value is contained in the extent object; otherwise, 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 Wertebereichs.

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

Return Value

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.

Return Value

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.

Return Value

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

Return Value

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 der Wertebereich, die bzw. der hinzugefügt werden soll.

Return Value

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.

Return Value

Das neue extent-Objekt.

operator--

Erhöht jedes Element im extent Objekt.

Syntax

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

Return Value

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.

Return Value

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.

Return Value

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.

Return Value

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 durch den Rang minus 1.

Return Value

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 wichtigste Komponente des unterteilten Wertebereichs.

_Dim1
Die zweitwichtigste Komponente des unterteilten Wertebereichs.

_Dim2
Die unwichtigste Komponente des unterteilten Wertebereichs.

See also

Concurrency-Namespace (C++ AMP)