Compartir por

Clase extent (C++ AMP)

Representa un vector de N valores enteros que especifican los límites de un espacio N dimensional que tiene un origen de 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

Encabezado: amp.h

Espacio de nombres: Concurrencia

Members

Constructores públicos

Name Description
constructor de extensión Inicializa una nueva instancia de la clase extent.

Métodos públicos

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.

Operadores públicos

Name Description
operator- Devuelve un nuevo objeto extent que se crea restando los elementos correspondientes de index de los elementos de 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.

Constantes públicas

Name Description
Constante de rango Obtiene la clasificación del objeto extent.

Jerarquía de herencia

extent

contains

Indica si el valor de índice especificado está incluido en el extent objeto .

Syntax

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

Parameters

_Index
Valor index que se va a probar.

Valor devuelto

true si el valor de índice especificado está contenido en el objeto extent; de lo contrario, 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 calcular el módulo de.

Valor devuelto

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 a multiplicar.

Valor devuelto

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.

Valor devuelto

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

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.

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.

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.

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.

Valor devuelto

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

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.

Syntax

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

Parameters

_Rhs
El número por el cual se divide.

Valor devuelto

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
El número a restar.

Valor devuelto

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.

Valor devuelto

Una 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
Un entero comprendido entre 0 y el rango menos 1.

Valor devuelto

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

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

Consulte también

Concurrency Namespace (C++ AMP)

  • Last updated on