extent (Clase) (C++ AMP)
Representa un vector de valores enteros de N que especifican los límites de un espacio de N dimensiones que tiene un origen de 0. Los valores del vector se ordenan desde el más al menos significativo.
Sintaxis
template <int _Rank>
class extent;
Parámetros
_Rank
La clasificación del objeto extent.
Requisitos
Encabezado: amp.h
Espacio de nombres: simultaneidad
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| Constructor de extensión | Inicializa una nueva instancia de la clase extent. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| 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. |
Operadores públicos
| Nombre | Descripción |
|---|---|
| operator- | Devuelve un nuevo objeto extent que se crea restando los elementos de los index elementos correspondientes extent. |
| operador-- | 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. |
Constantes públicas
| Nombre | Descripción |
|---|---|
| rank (Constante) | Obtiene la clasificación del objeto extent. |
Jerarquía de herencia
extent
contains
Indica si el valor de índice especificado está incluido en el objeto extent.
Sintaxis
bool contains(const index<rank>& _Index) const restrict(amp,cpu);
Parámetros
_Index
Valor index que se va a probar.
Valor devuelto
true si el valor de índice especificado está contenido en el objetoextent; de lo contrario, es false.
extent
Inicializa una nueva instancia de la clase extent.
Sintaxis
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);
Parámetros
_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.
Comentarios
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.
Sintaxis
extent<_Rank>& operator%=(int _Rhs) restrict(cpu, direct3d);
Parámetros
_Rhs
Número para buscar el módulo de.
Valor devuelto
Objeto extent.
operator*=
Multiplica cada elemento del objeto extent por el número especificado.
Sintaxis
extent<_Rank>& operator*=(int _Rhs) restrict(amp,cpu);
Parámetros
_Rhs
Número por el que se multiplica.
Valor devuelto
Objeto extent.
operator+
Devuelve un nuevo objeto extent creado agregando los elementos index y extent correspondientes.
Sintaxis
extent<_Rank> operator+(const index<_Rank>& _Rhs) restrict(amp,cpu);
Parámetros
_Rhs
El objeto index que contiene los elementos que se van a agregar.
Valor devuelto
El nuevo objeto extent.
operator++
Incrementa cada elemento del objeto extent.
Sintaxis
extent<_Rank>& operator++() restrict(amp,cpu);
extent<_Rank> operator++(int)restrict(amp,cpu);
Valor devuelto
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.
Sintaxis
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);
Parámetros
_Rhs
Número, índice o extensión que se va a agregar.
Valor devuelto
El objeto extent resultante.
operator-
Crea un nuevo objeto extent restando cada elemento del objeto especificado index del elemento correspondiente de este objeto extent.
Sintaxis
extent<_Rank> operator-(const index<_Rank>& _Rhs) restrict(amp,cpu);
Parámetros
_Rhs
El objeto index que contiene los elementos que se van a sustraer.
Valor devuelto
El nuevo objeto extent.
operador--
Disminuye cada elemento del objeto extent.
Sintaxis
extent<_Rank>& operator--() restrict(amp,cpu);
extent<_Rank> operator--(int)restrict(amp,cpu);
Valor devuelto
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.
Sintaxis
extent<_Rank>& operator/=(int _Rhs) restrict(amp,cpu);
Parámetros
_Rhs
Número entre el que se va a dividir.
Valor devuelto
Objeto extent.
operator-=
Resta el número especificado de cada elemento del objeto extent.
Sintaxis
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);
Parámetros
_Rhs
Número que se resta.
Valor devuelto
El objeto extent resultante.
operator=
Copia el contenido de otro objeto extent a este.
Sintaxis
extent<_Rank>& operator=(const extent<_Rank>& _Other) restrict(amp,cpu);
Parámetros
_Other
El objeto extent desde el que se va a copiar.
Valor devuelto
La referencia a este objeto extent.
extent::operator []
Devuelve el elemento que se encuentra en el índice especificado.
Sintaxis
int operator[](unsigned int _Index) const restrict(amp,cpu);
int& operator[](unsigned int _Index) restrict(amp,cpu);
Parámetros
_Index
Entero comprendido entre 0 y la clasificación menos 1.
Valor devuelto
El elemento que se encuentra en el índice especificado.
rank
Almacena la clasificación del objeto extent.
Sintaxis
static const int rank = _Rank;
size
Devuelve el tamaño lineal total del objeto extent (en unidades de elementos).
Sintaxis
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 ;
Parámetros
_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.