parking_lot

文档（同步原语）

文档（核心停车场 API）

文档（类型安全锁 API）

此库提供了比 Rust 标准库中的更小、更快、更灵活的 Mutex、RwLock、Condvar 和 Once 实现，以及支持递归加锁的 ReentrantMutex 类型。它还公开了一个低级 API，用于创建自己的高效同步原语。

在 x86_64 Linux 上进行测试时，发现当无竞争时，parking_lot::Mutex 比标准库中的 std::sync::Mutex 快 1.5 倍，而在多个线程竞争时则快 5 倍。对于 RwLock 的数值取决于读者和写线程的数量，但几乎总是比标准库中的 RwLock 快，在某些情况下甚至快 50 倍。

特性

此库提供的原语与 Rust 标准库中的原语相比具有几个优势

1. Mutex 和 Once 仅需 1 字节存储空间，而 Condvar 和 RwLock 仅需 1 个字节的存储空间。另一方面，在某些平台（如 macOS 和其他一些平台）上，标准库原语需要动态分配的 Box 来持有特定于操作系统的同步原语。特别是 Mutex 的小尺寸特别鼓励使用细粒度锁来提高并行性。
2. 无竞争锁的获取和释放通过快速的内联路径完成，这些路径仅需要一次原子操作。
3. 微竞争（具有短关键区的竞争锁）通过在尝试获取锁时旋转几次来有效地处理。
4. 锁是自适应的，在几次自旋尝试失败后，会挂起一个线程。这使得锁适用于长和短的关键部分。
5. Condvar、RwLock 和 Once 在 Windows XP 上运行，与那些类型的标准库版本不同。
6. RwLock 利用支持该功能的处理器的硬件锁消除，这可以在许多读者的情况下带来巨大的性能提升。这必须通过 hardware-lock-elision 功能来启用。
7. RwLock 使用任务公平锁策略，这避免了读者和写者的饥饿，而标准库版本则没有任何保证。
8. Condvar 保证不会产生虚假唤醒。只有在超时或被通知唤醒时，线程才会被唤醒。
9. Condvar::notify_all 只会唤醒一个线程，并将其余的线程重新排队等待相关的 Mutex。这避免了所有线程同时尝试获取锁的雷鸣 herd 问题。
10. RwLock 支持将写锁原子降级为读锁。
11. Mutex 和 RwLock 允许不带 RAII 守护对象进行原始解锁。
12. Mutex<()> 和 RwLock<()> 允许不带 RAII 守护对象进行原始锁定。
13. Mutex 和 RwLock 支持最终公平性，这允许它们在平均情况下公平，而不牺牲性能。
14. 支持递归锁定的 ReentrantMutex 类型。
15. 一个实验性的死锁检测器，适用于 Mutex、RwLock 和 ReentrantMutex。默认情况下，此功能是禁用的，可以通过 deadlock_detection 功能启用。
16. RwLock 支持将“可升级”的读锁原子升级为写锁。
17. 可选支持 serde。通过 serde 功能启用。注意！此支持仅适用于 Mutex、ReentrantMutex 和 RwLock；Condvar 和 Once 目前不支持。
18. 当启用 send_guard 功能时，锁守护者可以发送到其他线程。

[dependencies]
parking_lot = "0.12"

[dependencies]
parking_lot = { version = "0.12", features = ["nightly"] }