函数
<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


另见