8.6 `PhantomPinned` 标记类型

06-PhantomPinned 标记类型 — Comprehensive Rust

  1分钟内可阅读完  

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/unsafe-deep-dive/pinning/phantompinned.html

8.6 PhantomPinned 标记类型

定义

1
2
3
4
5

// Copyright 2026 Google LLC
// SPDX-License-Identifier: Apache-2.0
pub struct PhantomPinned;

impl !Unpin for PhantomPinned {}

用法

1
2
3
4
5
6
7

// Copyright 2026 Google LLC
// SPDX-License-Identifier: Apache-2.0
pub struct DynamicBuffer {
    data: Vec<u8>,
    cursor: std::ptr::NonNull<u8>,
    _pin: std::marker::PhantomPinned,
}

PhantomPinned 是一种标记类型。

若类型包含 PhantomPinned，默认不会实现 Unpin。

当 DynamicBuffer 被 Pin 包装时，这会产生强制 pinning 的效果。

最后修改 August 11, 2026: 更新 (70a5af133)