函式
<memory>

std::declare_no_pointers

void declare_no_pointers (char* p, size_t n);
將記憶體塊宣告為不包含指標
宣告從p開始,跨度為n位元組的記憶體範圍不包含可追溯的指標位置。

這會正式使使用::operator new建立且其地址僅儲存在該範圍內的任何物件失效。請注意,實現寬鬆指標安全性策略的編譯器可能會忽略此宣告。

在垃圾回收的實現中,對此函式的呼叫可能會導致其唯一安全派生的指標(或其整數表示)位於該記憶體範圍內的物件被回收。

必須在包含該範圍的物件銷燬之前,對同一範圍呼叫 undeclare_no_pointers。呼叫 undeclare_no_pointers 會取消註冊該範圍,而不會恢復之前由對declare_no_pointers.

引數

p
指向要宣告的範圍的第一個位元組的指標。
指定的範圍的位元組不得已被先前此函式註冊但未釋放。
n
要宣告的範圍的長度,以位元組為單位。
size_t 是一個無符號整數型別。

返回值



此函式不丟擲異常。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// declare_no_pointers / undeclare_no_pointers
#include <iostream>
#include <memory>

int main() {
  int * foo = new int(1);
  int * bar = new int(2);
  std::declare_no_pointers (reinterpret_cast<char*>(&bar),sizeof(int*));

  std::cout << "*foo: " << *foo << '\n';

  if (std::get_pointer_safety() != std::pointer_safety::strict)
    std::cout << "*bar: " << *bar << '\n';  // invalid if strict safety

  std::undeclare_no_pointers (reinterpret_cast<char*>(&bar),sizeof(int*));

  delete bar;
  delete foo;
  return 0;
}

可能的輸出
*foo: 1
*bar: 2


另見