extent (Clase) (C++ AMP)extent Class (C++ AMP)

Representa un vector de valores enteros de n que especifican los límites de un espacio de ndimensiones que tiene un origen de 0.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 del más significativo al menos significativo.The values in the vector are ordered from most significant to least significant.

SintaxisSyntax

template <int _Rank>
class extent;

ParámetrosParameters

_Rank_Rank
Rango del extent objeto.The rank of the extent object.

RequisitosRequirements

Encabezado: amp.hHeader: amp.h

Espacio de nombres: SimultaneidadNamespace: Concurrency

MiembrosMembers

Constructores públicosPublic Constructors

NombreName DescripciónDescription
Constructor de extensiónextent Constructor Inicializa una nueva instancia de la clase extent.Initializes a new instance of the extent class.

Métodos públicosPublic Methods

NOMBREName DescripciónDescription
containscontains Comprueba si el objeto especificado extent tiene el rango especificado.Verifies that the specified extent object has the specified rank.
sizesize Devuelve el tamaño lineal total de la extensión (en unidades de elementos).Returns the total linear size of the extent (in units of elements).
tiletile Genera un tiled_extent objeto con las extensiones de mosaico proporcionadas por las dimensiones especificadas.Produces a tiled_extent object with the tile extents given by specified dimensions.

Operadores públicosPublic Operators

NombreName DescripciónDescription
Operatoroperator- Devuelve un nuevo extent objeto que se crea restando los index elementos de los elementos correspondientes extent .Returns a new extent object that's created by subtracting the index elements from the corresponding extent elements.
operador--operator-- Disminuye cada elemento del extent objeto.Decrements each element of the extent object.
operador% =operator%= Calcula el módulo (resto) de cada elemento del extent objeto cuando ese elemento se divide por un número.Calculates the modulus (remainder) of each element in the extent object when that element is divided by a number.
operador * =operator*= Multiplica cada elemento del extent objeto por un número.Multiplies each element of the extent object by a number.
operador/=operator/= Divide cada elemento del extent objeto por un número.Divides each element of the extent object by a number.
extent:: Operator[]extent::operator[] Devuelve el elemento que se encuentra en el índice especificado.Returns the element that's at the specified index.
operador +operator+ Devuelve un nuevo extent objeto que se crea agregando los index elementos y correspondientes extent .Returns a new extent object that's created by adding the corresponding index and extent elements.
operador + +operator++ Incrementa cada elemento del extent objeto.Increments each element of the extent object.
operador + =operator+= Agrega el número especificado a cada elemento del extent objeto.Adds the specified number to each element of the extent object.
operador =operator= Copia el contenido de otro extent objeto en este.Copies the contents of another extent object into this one.
operador-=operator-= Resta el número especificado de cada elemento del extent objeto.Subtracts the specified number from each element of the extent object.

Constantes públicasPublic Constants

NombreName DescripciónDescription
Rank (constante)rank Constant Obtiene el rango del extent objeto.Gets the rank of the extent object.

Jerarquía de herenciaInheritance Hierarchy

extent

tuvieracontains

Indica si el valor de Índice especificado está incluido en el objeto ' extent '.Indicates whether the specified index value is contained within the `extent' object.

SintaxisSyntax

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

ParámetrosParameters

_Index_Index
Valor index que se va a comprobar.The index value to test.

Valor devueltoReturn Value

true Si el valor de Índice especificado está incluido en el extent objeto; en caso contrario, false .true if the specified index value is contained in the extent object; otherwise, false.

expresaextent

Inicializa una nueva instancia de la clase ' extent '.Initializes a new instance of the `extent' class.

SintaxisSyntax

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ámetrosParameters

_Array_Array
Matriz de _Rank enteros que se utiliza para crear el nuevo extent objeto.An array of _Rank integers that is used to create the new extent object.

_I_I
La longitud de la extensión.The length of the extent.

_I0_I0
La longitud de la dimensión más significativa.The length of the most significant dimension.

_I1_I1
La longitud de la siguiente dimensión más significativa.The length of the next-to-most-significant dimension.

_I2_I2
La longitud de la dimensión menos significativa.The length of the least significant dimension.

_Other_Other
extentObjeto en el que extent se basa el nuevo objeto.An extent object on which the new extent object is based.

ObservacionesRemarks

El constructor predeterminado Inicializa un extent objeto que tiene un rango de tres.The default constructor initializes an extent object that has a rank of three.

Si se utiliza una matriz para construir un extent objeto, la longitud de la matriz debe coincidir con el rango del extent objeto.If an array is used to construct an extent object, the length of the array must match the rank of the extent object.

operador% =operator%=

Calcula el módulo (resto) de cada elemento de la ' extensión ' cuando ese elemento se divide por un número.Calculates the modulus (remainder) of each element in the `extent' when that element is divided by a number.

SintaxisSyntax

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

ParámetrosParameters

_Rhs_Rhs
Número para el que se va a buscar el módulo.The number to find the modulus of.

Valor devueltoReturn Value

Objeto extent.The extent object.

operador * =operator*=

Multiplica cada elemento del objeto ' extent ' por el número especificado.Multiplies each element in the `extent' object by the specified number.

SintaxisSyntax

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

ParámetrosParameters

_Rhs_Rhs
Número que se va a multiplicar.The number to multiply.

Valor devueltoReturn Value

Objeto extent.The extent object.

operador +operator+

Devuelve un nuevo extent objeto creado agregando los index elementos y correspondientes extent .Returns a new extent object created by adding the corresponding index and extent elements.

SintaxisSyntax

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

ParámetrosParameters

_Rhs_Rhs
indexObjeto que contiene los elementos que se van a agregar.The index object that contains the elements to add.

Valor devueltoReturn Value

El nuevo objeto extent.The new extent object.

operador + +operator++

Incrementa cada elemento del objeto ' extent '.Increments each element of the `extent' object.

SintaxisSyntax

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

Valor devueltoReturn Value

Para el operador de prefijo, el extent objeto ( *this ).For the prefix operator, the extent object (*this). Para el operador de sufijo, un nuevo extent objeto.For the suffix operator, a new extent object.

operador + =operator+=

Agrega el número especificado a cada elemento del objeto ' extent '.Adds the specified number to each element of the `extent' object.

SintaxisSyntax

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ámetrosParameters

_Rhs_Rhs
Número, índice o extensión que se va a agregar.The number, index, or extent to add.

Valor devueltoReturn Value

El objeto extent resultante.The resulting extent object.

Operatoroperator-

Crea un nuevo extent objeto restando cada elemento del index objeto especificado del elemento correspondiente de este extent objeto.Creates a new extent object by subtracting each element in the specified index object from the corresponding element in this extent object.

SintaxisSyntax

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

ParámetrosParameters

_Rhs_Rhs
indexObjeto que contiene los elementos que se van a restar.The index object that contains the elements to subtract.

Valor devueltoReturn Value

El nuevo objeto extent.The new extent object.

operador--operator--

Disminuye cada elemento en el objeto ' extent '.Decrements each element in the `extent' object.

SintaxisSyntax

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

Valor devueltoReturn Value

Para el operador de prefijo, el extent objeto ( *this ).For the prefix operator, the extent object (*this). Para el operador de sufijo, un nuevo extent objeto.For the suffix operator, a new extent object.

operador/=operator/=

Divide cada elemento del objeto ' extent ' por el número especificado.Divides each element in the `extent' object by the specified number.

SintaxisSyntax

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

ParámetrosParameters

_Rhs_Rhs
Número por el que se va a dividir.The number to divide by.

Valor devueltoReturn Value

Objeto extent.The extent object.

operador-=operator-=

Resta el número especificado de cada elemento del objeto ' extent '.Subtracts the specified number from each element of the `extent' object.

SintaxisSyntax

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ámetrosParameters

_Rhs_Rhs
Número que se va a restar.The number to subtract.

Valor devueltoReturn Value

El objeto extent resultante.The resulting extent object.

operador =operator=

Copia el contenido de otro objeto ' extent ' en este.Copies the contents of another `extent' object into this one.

SintaxisSyntax

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

ParámetrosParameters

_Other_Other
extentObjeto desde el que se va a copiar.The extent object to copy from.

Valor devueltoReturn Value

Referencia a este extent objeto.A reference to this extent object.

extent:: Operator[]extent::operator []

Devuelve el elemento que se encuentra en el índice especificado.Returns the element that's at the specified index.

SintaxisSyntax

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

ParámetrosParameters

_Index_Index
Entero de 0 a la clasificación menos 1.An integer from 0 through the rank minus 1.

Valor devueltoReturn Value

El elemento que se encuentra en el índice especificado.The element that's at the specified index.

criteriosrank

Almacena el rango del objeto ' extent '.Stores the rank of the `extent' object.

SintaxisSyntax

static const int rank = _Rank;

ajustasize

Devuelve el tamaño lineal total del extent objeto (en unidades de elementos).Returns the total linear size of the extent object (in units of elements).

SintaxisSyntax

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

posicióntile

Genera un objeto tiled_extent con las dimensiones de mosaico especificadas.Produces a tiled_extent object with the specified tile dimensions.

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ámetrosParameters

_Dim0_Dim0
El componente más significativo de la extensión en mosaico.The most significant component of the tiled extent. _Dim1_Dim1
El siguiente componente más significativo de la extensión en mosaico.The next-to-most-significant component of the tiled extent. _Dim2_Dim2
El componente menos significativo de la extensión en mosaico.The least significant component of the tiled extent.

Consulte tambiénSee also

Espacio de nombres de simultaneidad (C++ AMP)Concurrency Namespace (C++ AMP)