Bagikan melalui


Extent Class (C++ AMP)

Mewakili vektor nilai bilangan bulat N yang menentukan batas ruang N-dimensi yang memiliki asal 0. Nilai dalam vektor diurutkan dari yang paling signifikan hingga yang paling tidak signifikan.

Syntax

template <int _Rank>
class extent;

Parameters

_Rank
Peringkat dari objek extent.

Requirements

Header: amp.h

Namespace: Concurrency

Members

Konstruktor Publik

Name Description
extent Constructor Menginisialisasi instans baru dari kelas extent.

Metode Publik

Name Description
contains Memverifikasi bahwa objek yang ditentukan extent memiliki peringkat yang ditentukan.
size Mengembalikan ukuran linier total dari ruang lingkup (dalam satuan elemen).
tile Menghasilkan objek tiled_extent dengan batas petak yang ditentukan oleh dimensi tertentu.

Operator Publik

Name Description
operator- Mengembalikan objek baru extent yang dibuat dengan mengurangi elemen index dari extent elemen yang sesuai.
operator-- Mengurangi setiap elemen objek extent.
operator%= Menghitung modulus (sisa) dari setiap elemen dalam objek extent ketika elemen tersebut dibagi dengan angka.
operator*= Mengalikan setiap elemen objek extent dengan angka.
operator/= Membagi setiap elemen objek extent dengan angka.
extent::operator[] Mengembalikan elemen yang ada di indeks yang telah ditentukan.
operator+ Mengembalikan objek baru extent yang dibuat dengan menambahkan elemen index dan extent yang sesuai.
operator++ Menambahkan setiap elemen objek extent.
operator+= Menambahkan angka yang ditentukan ke setiap elemen objek extent.
operator= Menyalin isi objek lain extent ke dalam objek ini.
operator-= Mengurangi angka yang ditentukan dari setiap elemen objek extent.

Konstanta Umum

Name Description
konstanta peringkat Mendapatkan peringkat objek extent.

Hierarki Pewarisan

extent

contains

Menunjukkan apakah nilai indeks yang ditentukan terkandung dalam extent objek.

Syntax

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

Parameters

_Index
Nilai index yang akan diuji.

Mengembalikan Nilai

true jika nilai indeks yang ditentukan terkandung dalam extent objek; jika tidak, false.

extent

Menginisialisasi instans baru dari kelas 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
Larik bilangan bulat _Rank yang digunakan untuk membuat objek baru extent.

_I
Panjang jangkauan.

_I0
Panjang dimensi yang paling signifikan.

_I1
Panjang dimensi terpenting kedua.

_I2
Panjang dimensi yang paling rendah signifikansinya.

_Other
Objek extent yang menjadi dasar objek baru extent .

Remarks

Konstruktor default menginisialisasi extent objek yang memiliki peringkat tiga.

Jika array digunakan untuk membuat extent objek, panjang array harus cocok dengan peringkat extent objek.

operator%=

Menghitung modulus (sisa) dari setiap elemen di saat elemen tersebut extent dibagi dengan angka.

Syntax

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

Parameters

_Rhs
Angka untuk menghitung modulus dari sebuah bilangan.

Mengembalikan Nilai

Objek extent.

operator*=

Mengalikan setiap elemen dalam objek extent dengan bilangan yang ditentukan.

Syntax

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

Parameters

_Rhs
Angka yang akan dikalikan.

Mengembalikan Nilai

Objek extent.

operator+

Mengembalikan objek baru extent yang dibuat dengan menambahkan elemen index dan extent yang saling berkorespondensi.

Syntax

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

Parameters

_Rhs
Objek index yang berisi elemen yang akan ditambahkan.

Mengembalikan Nilai

Objek baru extent .

operator++

Menambahkan setiap elemen objek extent.

Syntax

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

Mengembalikan Nilai

Untuk operator awalan extent , objek (*this). Untuk operator akhiran, objek extent baru.

operator+=

Menambahkan angka yang ditentukan ke setiap elemen objek 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
Jumlah, indeks, atau luas untuk ditambahkan.

Mengembalikan Nilai

Objek extent yang dihasilkan.

operator-

Membuat objek baru extent dengan mengurangi setiap elemen dalam objek yang ditentukan index dari elemen yang sesuai dalam objek ini extent .

Syntax

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

Parameters

_Rhs
Objek index yang berisi elemen yang akan dikurangi.

Mengembalikan Nilai

Objek baru extent .

operator--

Mengurangi setiap elemen dalam extent objek.

Syntax

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

Mengembalikan Nilai

Untuk operator awalan extent, objek (*this). Untuk operator sufiks, objek baru extent.

operator/=

Membagi setiap elemen dalam extent objek dengan angka yang ditentukan.

Syntax

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

Parameters

_Rhs
Angka yang akan dibagi.

Mengembalikan Nilai

Objek extent.

operator-=

Mengurangi angka yang ditentukan dari setiap elemen objek 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
Angka yang akan dikurangi.

Mengembalikan Nilai

Objek yang extent dihasilkan.

operator=

Menyalin isi objek lain extent ke dalam objek ini.

Syntax

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

Parameters

_Other
Objek extent yang akan disalin.

Mengembalikan Nilai

Referensi ke objek ini extent .

extent::operator []

Mengembalikan elemen yang ada di indeks yang telah ditentukan.

Syntax

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

Parameters

_Index
Bilangan bulat dari 0 hingga peringkat minus 1.

Mengembalikan Nilai

Elemen pada indeks yang ditentukan.

pangkat

Menyimpan peringkat objek extent.

Syntax

static const int rank = _Rank;

size

Mengembalikan ukuran extent linier total objek (dalam satuan elemen).

Syntax

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

petak

Menghasilkan objek tiled_extent dengan ukuran ubin yang ditentukan.

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
Komponen paling signifikan dari tingkat petak peta.

_Dim1
Komponen paling signifikan kedua dari cakupan ubin.

_Dim2
Komponen kurang signifikan dari rentang pengubinan.

Baca juga

Namespace Konkurensi (C++ AMP)