Files
XCEngine/docs/api/containers/array/iterator.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

46 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::begin() / end()
```cpp
Iterator begin();
Iterator end();
ConstIterator begin() const;
ConstIterator end() const;
```
获取数组的迭代器,用于范围遍历。
**begin()** 返回指向第一个元素的迭代器。如果数组为空,返回值等于 `end()`
**end()** 返回指向"最后一个元素之后"位置的迭代器(哨兵)。这是一个越界位置,不可解引用。
**迭代器类型:** `Iterator = T*`(原始指针),因此支持指针算术运算。
**复杂度:** O(1)
**线程安全:** ❌ 迭代期间不可并发修改数组
**示例:**
```cpp
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
```
## 相关文档
- [Array 总览](array.md) - 返回类总览