Compartir vía


extent (Clase) (C++ AMP)

Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. Los valores del vector se ordenan desde el más al menos significativo.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
La clasificación del objeto extent.

Requirements

Header: amp.h

Namespace: Concurrency

Members

Public Constructors

Name Description
extent Constructor Inicializa una nueva instancia de la clase extent.

Public Methods

Name Description
contains Comprueba que el objeto especificado extent tiene el rango especificado.
size Devuelve el tamaño lineal total de la extensión (en unidades de elementos).
tile Genera un tiled_extent objeto con las extensiones de mosaico dadas por las dimensiones especificadas.

Public Operators

Name Description
operator- Devuelve un nuevo objeto extent que se crea restando los elementos de los index elementos correspondientes extent.
operator-- Disminuye cada elemento del objeto extent.
operator%= Calcula el módulo (resto) de cada elemento del objeto extent cuando ese elemento se divide entre un número.
operator*= Multiplica cada elemento del objeto extent por un número.
operator/= Divide cada elemento del objeto extent entre un número.
extent::operator[] Devuelve el elemento que se encuentra en el índice especificado.
operator+ Devuelve un nuevo objeto extent que se crea agregando los elementos index y extent correspondientes.
operator++ Incrementa cada elemento del objeto extent.
operator+= Suma el número especificado a cada elemento del objeto extent.
operator= Copia el contenido de otro objeto extent a este.
operator-= Resta el número especificado de cada elemento del objeto extent.

Public Constants

Name Description
rank Constant Obtiene la clasificación del objeto extent.

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
Valor index que se va a probar.

Return Value

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

extent

Inicializa una nueva instancia de la clase 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
Matriz de _Rank enteros que se usa para crear el nuevo objeto extent.

_I
La longitud de la extensión.

_I0
Longitud de la dimensión más significativa.

_I1
Longitud de la dimensión siguiente a la más significativa.

_I2
Longitud de la dimensión menos significativa.

_Other
Objeto extent en el que el nuevo objeto extent está basado.

Remarks

El constructor predeterminado inicializa un objeto extent que tiene una clasificación de tres.

Si se usa una matriz para construir un objeto extent, la longitud de la matriz debe coincidir con el rango del objeto extent.

operator%=

Calcula el módulo (resto) de cada elemento del extent cuando ese elemento se divide entre un número.

Syntax

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

Parameters

_Rhs
Número para buscar el módulo de.

Return Value

Objeto extent.

operator*=

Multiplica cada elemento del objeto extent por el número especificado.

Syntax

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

Parameters

_Rhs
Número por el que se multiplica.

Return Value

Objeto extent.

operator+

Devuelve un nuevo objeto extent creado agregando los elementos index y extent correspondientes.

Syntax

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

Parameters

_Rhs
El objeto index que contiene los elementos que se van a agregar.

Return Value

El nuevo objeto extent.

operator++

Incrementa cada elemento del objeto extent.

Syntax

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

Return Value

Para el operador de prefijo, el objeto extent (*this). Para el operador de sufijo, un nuevo objeto extent.

operator+=

Suma el número especificado a cada elemento del objeto 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
Número, índice o extensión que se va a agregar.

Return Value

El objeto extent resultante.

operator-

Crea un nuevo objeto extent restando cada elemento del objeto especificado index del elemento correspondiente de este objeto extent.

Syntax

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

Parameters

_Rhs
El objeto index que contiene los elementos que se van a sustraer.

Return Value

El nuevo objeto extent.

operator--

Disminuye cada elemento del objeto extent.

Syntax

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

Return Value

Para el operador de prefijo, el objeto extent (*this). Para el operador de sufijo, un nuevo objeto extent.

operator/=

Divide cada elemento del objeto extent por el número especificado.

Syntax

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

Parameters

_Rhs
Número entre el que se va a dividir.

Return Value

Objeto extent.

operator-=

Resta el número especificado de cada elemento del objeto 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
Número que se resta.

Return Value

El objeto extent resultante.

operator=

Copia el contenido de otro objeto extent a este.

Syntax

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

Parameters

_Other
El objeto extent desde el que se va a copiar.

Return Value

La referencia a este objeto extent.

extent::operator []

Devuelve el elemento que se encuentra en el índice especificado.

Syntax

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

Parameters

_Index
Entero comprendido entre 0 y la clasificación menos 1.

Return Value

El elemento que se encuentra en el índice especificado.

rank

Almacena la clasificación del objeto extent.

Syntax

static const int rank = _Rank;

size

Devuelve el tamaño lineal total del objeto extent (en unidades de elementos).

Syntax

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

tile

Genera un objeto tiled_extent con las dimensiones de mosaico especificadas.

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
El componente más significativo de la extensión del mosaico.

_Dim1
El siguiente componente más importante de la extensión del mosaico.

_Dim2
El componente menos significativo de la extensión del mosaico.

See also

Espacio de nombres de simultaneidad (C++ AMP)