Files
XCEngine/docs/api/containers/array/pushback.md
ssdfasd dc850d7739 docs: 重构 API 文档结构并修正源码准确性
- 重组文档目录结构: 每个模块的概述页移动到模块子目录
- 重命名 index.md 为 main.md
- 修正所有模块文档中的错误:
  - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式
  - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节
  - core: 修复 types 链接错误
  - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI
  - memory: 修复头文件路径, malloc vs operator new, 新增方法文档
  - resources: 修复 Shader/Texture 链接错误
  - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接
- 验证: fix_links.py 确认 0 个断裂引用
2026-03-19 00:22:30 +08:00

44 lines
1.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Array::PushBack()
```cpp
void PushBack(const T& value);
void PushBack(T&& value);
```
在数组末尾添加一个元素。
**拷贝版本(`const T&`**
- 如果容量不足(`Size() >= Capacity()`),先扩容(容量翻倍)
- 在末尾位置拷贝构造 `value`
**移动版本(`T&&`**
- 行为同拷贝版本,但使用移动构造
- 适用于临时对象或右值,避免拷贝开销
**参数:**
- `value` - 要添加的元素(拷贝或移动)
**复杂度:** 均摊 O(1)。每次添加的摊销成本为常数,因为扩容是翻倍策略。
**线程安全:** ❌ 操作期间不可并发访问
**示例:**
```cpp
Containers::Array<std::string> arr;
// 拷贝添加
std::string s = "hello";
arr.PushBack(s); // s 被拷贝
// 移动添加(更高效)
arr.PushBack(std::string("world")); // 直接移动构造
// 临时对象会被隐式移动
arr.PushBack("temporary"); // 字符串字面量构造后移动
```
## 相关文档
- [Array 总览](array.md) - 返回类总览