XCEngine/docs/api/containers/array/pushback.md

Array::PushBack()

void PushBack(const T& value);
void PushBack(T&& value);

在数组末尾添加一个元素。

拷贝版本（const T&）：

• 如果容量不足（m_size >= m_capacity），先扩容
• 当容量为0时，首次扩容至4；之后每次扩容翻倍（即 4 → 8 → 16 → ...）
• 在末尾位置拷贝构造 value

移动版本（T&&）：

• 行为同拷贝版本，但使用移动构造
• 适用于临时对象或右值，避免拷贝开销

参数：

• value - 要添加的元素（拷贝或移动）

复杂度： 均摊 O(1)。每次添加的摊销成本为常数，因为扩容是翻倍策略。

线程安全： ❌ 操作期间不可并发访问

示例：

XCEngine::Containers::Array<std::string> arr;

// 拷贝添加
std::string s = "hello";
arr.PushBack(s);           // s 被拷贝

// 移动添加（更高效）
arr.PushBack(std::string("world"));  // 直接移动构造

// 临时对象会被隐式移动
arr.PushBack("temporary"); // 字符串字面量构造后移动

相关文档

• Array 总览 - 返回类总览