Share via

extent (Clase) (C++ AMP)

  • Artículo

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.

Consulte también

Espacio de nombres de simultaneidad (C++ AMP)