Partilhar via


Classe extent (C++ AMP)

Representa um vetor de N valores inteiros que especificam os limites de um espaço de dimensão N cuja origem é 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 extent objeto.

Requirements

Cabeçalho: amp.h

Espaço de Nomes: Concorrência

Members

Construtores Públicos

Name Description
Construtor de extensão Inicializa uma nova instância da classe extent.

Métodos Públicos

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

Operadores Públicos

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

Constantes Públicas

Name Description
Constante de Rank Obtém a classificação do extent objeto.

Hierarquia de herança

extent

contains

Indica se o valor do índice especificado está contido no extent objeto.

Syntax

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

Parameters

_Index
O index valor a testar.

Valor de retorno

true se o valor do índice especificado estiver contido no extent objeto; caso contrário, 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 _Rank inteiros que é usada para criar o novo extent objeto.

_I
O comprimento da área de extensão.

_I0
O comprimento da dimensão mais significativa.

_I1
O comprimento da dimensão próxima à mais significativa.

_I2
O comprimento da dimensão menos significativa.

_Other
Um extent objeto no qual o novo extent objeto é baseado.

Remarks

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

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

operador%=

Calcula o módulo (restante) de cada elemento no momento em extent que esse elemento é dividido por um número.

Syntax

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

Parameters

_Rhs
O número para encontrar o módulo de.

Valor de retorno

O objeto extent.

operador*=

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

Syntax

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

Parameters

_Rhs
O número a multiplicar.

Valor de retorno

O objeto extent.

operator+

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

Syntax

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

Parameters

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

Valor de retorno

O novo extent objeto.

operator++

Incrementa cada elemento do objeto extent.

Syntax

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

Valor de retorno

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 extent objeto.

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, índice ou extensão a adicionar.

Valor de retorno

O objeto resultante extent .

operador-

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

Syntax

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

Parameters

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

Valor de retorno

O novo extent objeto.

operador--

Decrementa cada elemento do objeto extent.

Syntax

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

Valor de retorno

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

operador/=

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

Syntax

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

Parameters

_Rhs
O número pelo qual dividir.

Valor de retorno

O objeto extent.

operator-=

Subtrai o número especificado de cada elemento do extent objeto.

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 subtrair.

Valor de retorno

O objeto resultante extent .

operator=

Copia o conteúdo de outro extent objeto para este.

Syntax

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

Parameters

_Other
O extent objeto do qual copiar.

Valor de retorno

Uma referência a este 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 número inteiro de 0 a ordem menos 1.

Valor de retorno

O elemento que está no índice especificado.

classificar

Armazena a classificação do extent objeto.

Syntax

static const int rank = _Rank;

size

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

Syntax

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

dispor em mosaico

Produz um objeto tiled_extent com as dimensões de tile 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 azulejos.

_Dim1
O segundo componente mais significativo da extensão em mosaico.

_Dim2
O componente menos significativo da extensão da telha.

Consulte também

Namespace de Concorrência (C++ AMP)