docs: update containers API docs

docs/api/containers/array/begin-end.md

@@ -0,0 +1,52 @@
+# Array::begin() / end()
+
+```cpp
+Iterator begin();
+Iterator end();
+ConstIterator begin() const;
+ConstIterator end() const;
+```
+
+获取数组的迭代器，用于范围遍历。
+
+**begin()：** 返回指向第一个元素的迭代器。如果数组为空，返回值等于 `end()`。
+
+**end()：** 返回指向"最后一个元素之后"位置的迭代器（哨兵）。这是一个越界位置，不可解引用。
+
+**迭代器类型：** `Iterator = T*`（原始指针），因此支持指针算术运算。
+
+**复杂度：** O(1)
+
+**线程安全：** ❌ 迭代期间不可并发修改数组
+
+**示例：**
+
+```cpp
+#include <XCEngine/Containers/Array.h>
+
+XCEngine::Containers::Array<int> arr = {10, 20, 30, 40, 50};
+
+// 范围 for 循环（推荐）
+for (int val : arr) {
+    printf("%d\n", val);
+}
+
+// 手动迭代器
+for (auto it = arr.begin(); it != arr.end(); ++it) {
+    printf("%d\n", *it);
+}
+
+// 指针算术（因为迭代器就是指针）
+int* ptr = arr.begin();
+ptr += 2;  // 指向第三个元素
+*ptr;       // 30
+
+// 常量迭代器
+for (const auto& val : arr) {
+    printf("%d\n", val);
+}
+```
+
+## 相关文档
+
+- [Array 总览](array.md) - 返回类总览