docs: update memory and threading API docs

This commit is contained in:
2026-03-20 02:35:24 +08:00
parent c5b17239ca
commit fd792b7df1
103 changed files with 2485 additions and 673 deletions

View File

@@ -0,0 +1,43 @@
# Mutex::lock
```cpp
void lock() const;
```
获取互斥锁const 版本)。如果锁已被其他线程持有,则阻塞当前线程直到锁可用。
该方法是 `std::lockable` 接口的实现,可与 `std::lock_guard``std::unique_lock` 等 RAII 工具配合使用。
**参数:**
**返回:**
**线程安全:**
**复杂度:** 平均 O(1),最坏情况 O(n)n 为竞争线程数
**示例:**
```cpp
#include "XCEngine/Threading/Mutex.h"
#include <mutex>
XCEngine::XCEngine::Threading::Mutex mtx;
int counter = 0;
void Increment() {
mtx.lock();
++counter;
mtx.unlock();
}
// 使用 RAII 自动管理锁
void SafeIncrement() {
std::lock_guard<XCEngine::Threading::Mutex> guard(mtx);
++counter;
}
```
## 相关文档
- [Mutex 总览](mutex.md) - 返回类总览