interior_ptr(C++/CLI)

내부 포인터는 개체 자체가 아닌 참조 형식 내부에 대한 포인터를 선언합니다. 내부 포인터는 참조 핸들, 값 형식, boxed 형식 핸들, 관리되는 형식의 멤버 또는 관리되는 배열의 요소를 가리킬 수 있습니다.

모든 런타임

(이 언어 기능에는 모든 런타임에 적용되는 설명이 없습니다.)

Windows 런타임

(이 언어 기능에는 Windows 런타임에만 적용되는 설명이 없습니다.)

요구 사항

컴파일러 옵션: /ZW

공용 언어 런타임

다음 구문 예제는 내부 포인터를 보여 줍니다.

구문

cli::interior_ptr<cv_qualifier type> var = &initializer;

매개 변수

cv_qualifier
const 또는 volatile 한정자입니다.

type
‘이니셜라이저’의 형식입니다.

var
interior_ptr 변수의 이름입니다.

initializer
참조 형식의 멤버, 관리되는 배열의 요소 또는 네이티브 포인터에 할당할 수 있는 다른 모든 개체입니다.

설명

네이티브 포인터는 개체의 인스턴스를 이동시키는 가비지 수집기로부터 도출되는 관리되는 힙에서 위치를 변경하는 항목을 추적할 수 없습니다. 포인터가 인스턴스를 제대로 참조하려면 런타임은 포인터를 새로 위치가 지정된 개체로 업데이트해야 합니다.

interior_ptr은 네이티브 포인터 기능의 상위 집합을 나타냅니다. 따라서 네이티브 포인터에 할당할 수 있으면 interior_ptr에도 할당할 수 있습니다. 내부 포인터는 네이티브 포인터로서 비교 및 포인터 산술을 포함한 동일한 일련의 작업을 수행할 수 있습니다.

내부 포인터를 스택에만 선언할 수 있습니다. 내부 포인터를 클래스의 멤버로 선언할 수 없습니다.

내부 포인터가 스택에만 존재하므로 내부 포인터의 주소는 관리되지 않는 포인터를 생성합니다.

interior_ptr 조건문에서 사용할 수 있는 암시적 변환bool이 있습니다.

가비지 수집된 힙에서 이동할 수 없는 개체를 가리키는 내부 포인터를 선언하는 방법에 대한 자세한 내용은 pin_ptr을 참조하세요.

interior_ptr은 cli 네임스페이스에 있습니다. 자세한 내용은 Platform, default 및 cli 네임스페이스를 참조하세요.

내부 포인터에 대한 자세한 내용은 다음을 참조하십시오.

• 방법: 내부 포인터 및 관리되는 배열 선언 및 사용(C++/CLI)

• 방법: interior_ptr 키워드를 사용하여 값 형식 선언(C++/CLI)

• 방법: 내부 포인터 및 네이티브 포인터를 사용하여 함수 오버로드(C++/CLI)

• 방법: const 키워드를 사용하여 내부 포인터 선언(C++/CLI)

요구 사항

컴파일러 옵션: /clr

예제

다음 샘플에서는 참조 형식으로 내부 포인터를 선언하고 사용하는 방법을 보여 줍니다.

// interior_ptr.cpp
// compile with: /clr
using namespace System;

ref class MyClass {
public:
   int data;
};

int main() {
   MyClass ^ h_MyClass = gcnew MyClass;
   h_MyClass->data = 1;
   Console::WriteLine(h_MyClass->data);

   interior_ptr<int> p = &(h_MyClass->data);
   *p = 2;
   Console::WriteLine(h_MyClass->data);

   // alternatively
   interior_ptr<MyClass ^> p2 = &h_MyClass;
   (*p2)->data = 3;
   Console::WriteLine((*p2)->data);
}

1
2
3

참고 항목

.NET 및 UWP용 구성 요소 확장