Compartilhar via


Classe extent (C++ AMP)

Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. Os valores no vetor são ordenados do mais significativo para o menos significativo.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
A classificação do objeto extent.

Requirements

Header: amp.h

Namespace: Concurrency

Members

Public Constructors

Name Description
extent Constructor Inicializa uma nova instância da classe extent.

Public Methods

Name Description
contains Verifica se o objeto extent especificado tem a classificação especificada.
size Retorna o tamanho linear total da extensão (em unidades de elementos).
tile Produz um objeto tiled_extent com as extensões de bloco fornecidas por dimensões especificadas.

Public Operators

Name Description
operator- Retorna um novo objeto extent que é criado subtraindo os elementos index dos elementos extent correspondentes.
operator-- Decrementa cada elemento do objeto extent.
operator%= Calcula o módulo (restante) de cada elemento no objeto extent quando esse elemento é dividido por um número.
operator*= Multiplica cada elemento do objeto extent por um número.
operator/= Divide cada elemento do objeto extent por um número.
extent::operator[] Retorna o elemento que está no índice especificado.
operator+ Retorna um novo objeto extent criado adicionando os elementos index e extent correspondentes.
operator++ Incrementa cada elemento do objeto extent.
operator+= Adiciona o número especificado a cada elemento do objeto extent.
operator= Copia o conteúdo de outro objeto extent neste.
operator-= Subtrai o número especificado de cada elemento do objeto extent.

Public Constants

Name Description
rank Constant Armazena a classificação do 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
O index valor a ser testado.

Return Value

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

extensão

Inicializa uma nova instância da classe 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
Uma matriz de inteiros _Rank que é usada para criar o novo objeto extent.

_I
O comprimento da extensão.

_I0
O comprimento da dimensão mais significativa.

_I1
O comprimento da segunda dimensão mais significativa.

_I2
O comprimento da dimensão menos significativa.

_Other
Um objeto extent no qual o novo objeto extent está baseado.

Remarks

O construtor padrão inicializa um objeto extent que tem uma classificação de três.

Se uma matriz for usada para construir um objeto extent, o comprimento da matriz deverá corresponder à classificação do objeto extent.

operator%=

Calcula o módulo (resto) de cada elemento no objeto extent quando esse elemento é dividido por um número.

Syntax

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

Parameters

_Rhs
O número do qual localizar o módulo.

Return Value

O objeto extent.

operator*=

Multiplica cada elemento no objeto extent pelo número especificado.

Syntax

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

Parameters

_Rhs
O número a ser multiplicado.

Return Value

O objeto extent.

operator+

Retorna um novo objeto extent criado adicionando os elementos index e extent correspondentes.

Syntax

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

Parameters

_Rhs
O objeto index que contém os elementos a serem adicionados.

Return Value

O novo objeto extent.

operator++

Incrementa cada elemento do objeto extent.

Syntax

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

Return Value

Para o operador de prefixo, o objeto extent (*this). Para o operador de sufixo, um novo objeto extent.

operator+=

Adiciona o número especificado a cada elemento do 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
O número, o índice ou a extensão a ser adicionado.

Return Value

O tipo do objeto extent resultante.

operator-

Cria um novo objeto extent subtraindo cada elemento no objeto index especificado do elemento correspondente neste objeto extent.

Syntax

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

Parameters

_Rhs
O objeto index que contém os elementos a serem subtraídos.

Return Value

O novo objeto extent.

operator--

Decrementa cada elemento no objeto extent.

Syntax

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

Return Value

Para o operador de prefixo, o objeto extent (*this). Para o operador de sufixo, um novo objeto extent.

operator/=

Divide cada elemento no objeto extent pelo número especificado.

Syntax

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

Parameters

_Rhs
Número pelo qual dividir.

Return Value

O objeto extent.

operator-=

Subtrai o número especificado de cada elemento do 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
O número a ser subtraído.

Return Value

O tipo do objeto extent resultante.

operator=

Copia o conteúdo de outro objeto extent neste.

Syntax

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

Parameters

_Other
O objeto extent do qual copiar.

Return Value

Uma referência a esse objeto extent.

extent::operator []

Retorna o elemento que está no índice especificado.

Syntax

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

Parameters

_Index
Um inteiro que vai de 0 até a classificação menos 1.

Return Value

O elemento que está no índice especificado.

classificar

Armazena a classificação do objeto extent.

Syntax

static const int rank = _Rank;

size

Retorna o tamanho linear total do objeto extent (em unidades de elementos).

Syntax

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

bloco

Produz um objeto tiled_extent com as dimensões de bloco 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
O componente mais significativo da extensão de lado a lado.

_Dim1
O segundo componente mais significativo da extensão de lado a lado.

_Dim2
O componente menos significativo da extensão de lado a lado.

See also

Namespace de simultaneidade (C++ AMP)