extent 클래스(C++ AMP)extent Class (C++ AMP)

원점이 0 인 n차원 공간의 경계를 지정 하는 n 정수 값의 벡터를 나타냅니다.Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. 벡터의 값은 가장 중요 한 값부터 최하위 순서로 정렬 됩니다.The values in the vector are ordered from most significant to least significant.

구문Syntax

template <int _Rank>
class extent;

매개 변수Parameters

_Rank_Rank
개체의 순위입니다 extent .The rank of the extent object.

요구 사항Requirements

헤더: amp.hHeader: amp.h

네임스페이스: 동시성Namespace: Concurrency

멤버Members

Public 생성자Public Constructors

NameName 설명Description
익스텐트 생성자extent Constructor extent 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the extent class.

Public 메서드Public Methods

이름Name 설명Description
containscontains 지정 된 개체에 extent 지정 된 순위가 있는지 확인 합니다.Verifies that the specified extent object has the specified rank.
sizesize 범위의 전체 선형 크기 (요소 단위)를 반환 합니다.Returns the total linear size of the extent (in units of elements).
타일tile tiled_extent지정 된 차원에서 제공 하는 타일 익스텐트를 사용 하 여 개체를 생성 합니다.Produces a tiled_extent object with the tile extents given by specified dimensions.

Public 연산자Public Operators

NameName 설명Description
연산자operator- extent index 해당 요소에서 요소를 빼서 만들어진 새 개체를 반환 합니다 extent .Returns a new extent object that's created by subtracting the index elements from the corresponding extent elements.
연산자--operator-- 개체의 각 요소를 감소 시킵니다 extent .Decrements each element of the extent object.
연산자% =operator%= extent해당 요소를 숫자로 나눌 때 개체에 있는 각 요소의 모듈러스 (나머지)를 계산 합니다.Calculates the modulus (remainder) of each element in the extent object when that element is divided by a number.
연산자 * =operator*= 개체의 각 요소 extent 를 숫자로 곱합니다.Multiplies each element of the extent object by a number.
operator/=operator/= 개체의 각 요소 extent 를 숫자로 나눕니다.Divides each element of the extent object by a number.
익스텐트:: operator[]extent::operator[] 지정 된 인덱스에 있는 요소를 반환 합니다.Returns the element that's at the specified index.
연산자 +operator+ extent해당 및 요소를 추가 하 여 만들어진 새 개체를 반환 합니다 index extent .Returns a new extent object that's created by adding the corresponding index and extent elements.
operator + +operator++ 개체의 각 요소를 증가 시킵니다 extent .Increments each element of the extent object.
operator + =operator+= 개체의 각 요소에 지정 된 숫자를 추가 extent 합니다.Adds the specified number to each element of the extent object.
연산자 =operator= 다른 개체의 내용을 extent 여기로 복사 합니다.Copies the contents of another extent object into this one.
연산자-=operator-= 개체의 각 요소에서 지정한 수를 뺍니다 extent .Subtracts the specified number from each element of the extent object.

공용 상수Public Constants

NameName 설명Description
rank 상수rank Constant 개체의 순위를 가져옵니다 extent .Gets the rank of the extent object.

상속 계층 구조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_Index
테스트할 index 값입니다.The index value to test.

Return ValueReturn Value

true 지정 된 인덱스 값이 개체에 포함 되어 있으면 extent 이 고, 그렇지 않으면 false 입니다.true if the specified index value is contained in the extent object; otherwise, false.

됨으로써extent

' 익스텐트 ' 클래스의 새 인스턴스를 초기화 합니다.Initializes a new instance of the `extent' class.

구문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_Array
_Rank새 개체를 만드는 데 사용 되는 정수 배열입니다 extent .An array of _Rank integers that is used to create the new extent object.

_I_I
범위의 길이입니다.The length of the extent.

_I0_I0
가장 중요 한 차원의 길이입니다.The length of the most significant dimension.

_I1_I1
다음으로 중요 한 차원의 길이입니다.The length of the next-to-most-significant dimension.

_I2_I2
최하위 차원의 길이입니다.The length of the least significant dimension.

_Other_Other
extent새 개체의 기반이 되는 개체입니다 extent .An extent object on which the new extent object is based.

설명Remarks

기본 생성자는 차수가 3 인 개체를 초기화 합니다 extent .The default constructor initializes an extent object that has a rank of three.

배열을 사용 하 여 개체를 생성 하는 경우 extent 배열의 길이는 개체의 차수와 일치 해야 합니다 extent .If an array is used to construct an extent object, the length of the array must match the rank of the extent object.

연산자% =operator%=

' 범위 '에서 요소를 숫자로 나눌 때 각 요소의 모듈러스 (나머지)를 계산 합니다.Calculates the modulus (remainder) of each element in the `extent' when that element is divided by a number.

구문Syntax

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

매개 변수Parameters

_Rhs_Rhs
모듈러스를 찾기 위한 숫자입니다.The number to find the modulus of.

Return ValueReturn Value

extent 개체입니다.The extent object.

연산자 * =operator*=

' 익스텐트 ' 개체의 각 요소를 지정 된 수 만큼 곱합니다.Multiplies each element in the `extent' object by the specified number.

구문Syntax

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

매개 변수Parameters

_Rhs_Rhs
곱할 숫자입니다.The number to multiply.

Return ValueReturn Value

extent 개체입니다.The extent object.

연산자 +operator+

extent해당 및 요소를 추가 하 여 만든 새 개체를 반환 합니다 index extent .Returns a new extent object created by adding the corresponding index and extent elements.

구문Syntax

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

매개 변수Parameters

_Rhs_Rhs
index추가할 요소를 포함 하는 개체입니다.The index object that contains the elements to add.

Return ValueReturn Value

extent 개체입니다.The new extent object.

operator + +operator++

' 익스텐트 ' 개체의 각 요소를 증가 시킵니다.Increments each element of the `extent' object.

구문Syntax

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

Return ValueReturn Value

전위 연산자의 경우 extent 개체 ( *this )입니다.For the prefix operator, the extent object (*this). 접미사 연산자의 경우 새 extent 개체입니다.For the suffix operator, a new extent object.

operator + =operator+=

' 익스텐트 ' 개체의 각 요소에 지정한 수를 추가 합니다.Adds the specified number to each element of the `extent' object.

구문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_Rhs
더할 숫자, 인덱스 또는 범위입니다.The number, index, or extent to add.

Return ValueReturn Value

결과 extent 개체입니다.The resulting extent object.

연산자operator-

extent index 이 개체의 해당 요소에서 지정 된 개체의 각 요소를 빼서 새 개체를 만듭니다 extent .Creates a new extent object by subtracting each element in the specified index object from the corresponding element in this extent object.

구문Syntax

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

매개 변수Parameters

_Rhs_Rhs
index뺄 요소를 포함 하는 개체입니다.The index object that contains the elements to subtract.

Return ValueReturn Value

extent 개체입니다.The new extent object.

연산자--operator--

' 익스텐트 ' 개체의 각 요소를 감소 시킵니다.Decrements each element in the `extent' object.

구문Syntax

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

Return ValueReturn Value

전위 연산자의 경우 extent 개체 ( *this )입니다.For the prefix operator, the extent object (*this). 접미사 연산자의 경우 새 extent 개체입니다.For the suffix operator, a new extent object.

operator/=operator/=

' 익스텐트 ' 개체의 각 요소를 지정 된 수 만큼 나눕니다.Divides each element in the `extent' object by the specified number.

구문Syntax

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

매개 변수Parameters

_Rhs_Rhs
나눌 숫자입니다.The number to divide by.

Return ValueReturn Value

extent 개체입니다.The extent object.

연산자-=operator-=

' 익스텐트 ' 개체의 각 요소에서 지정한 수를 뺍니다.Subtracts the specified number from each element of the `extent' object.

구문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_Rhs
뺄 숫자입니다.The number to subtract.

Return ValueReturn Value

결과 extent 개체입니다.The resulting extent object.

연산자 =operator=

다른 ' 익스텐트 ' 개체의 내용을 여기로 복사 합니다.Copies the contents of another `extent' object into this one.

구문Syntax

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

매개 변수Parameters

_Other_Other
extent복사할 개체입니다.The extent object to copy from.

Return ValueReturn Value

이 개체에 대 한 참조 extent 입니다.A reference to this extent object.

익스텐트:: operator[]extent::operator []

지정 된 인덱스에 있는 요소를 반환 합니다.Returns the element that's at the specified index.

구문Syntax

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

매개 변수Parameters

_Index_Index
0에서 순위에서 1을 뺀 값 사이의 정수입니다.An integer from 0 through the rank minus 1.

Return ValueReturn Value

지정 된 인덱스에 있는 요소입니다.The element that's at the specified index.

배열rank

' 익스텐트 ' 개체의 순위를 저장 합니다.Stores the rank of the `extent' object.

구문Syntax

static const int rank = _Rank;

크기가size

extent 개체(요소의 단위에서)의 총 선형 크기 단위를 반환합니다.Returns the total linear size of the extent object (in units of elements).

구문Syntax

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

놓기tile

지정 된 타일 크기를 사용 하 여 tiled_extent 개체를 생성 합니다.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 ;

매개 변수Parameters

_Dim0_Dim0
바둑판식으로 배열 된 범위의 가장 중요 한 구성 요소입니다.The most significant component of the tiled extent. _Dim1_Dim1
바둑판식으로 배열 된 범위에서 다음으로 중요 한 구성 요소입니다.The next-to-most-significant component of the tiled extent. _Dim2_Dim2
바둑판식으로 배열 된 범위의 가장 중요 하지 않은 구성 요소입니다.The least significant component of the tiled extent.

참고 항목See also

동시성 네임 스페이스 (C++ AMP)Concurrency Namespace (C++ AMP)