docs/api/math/vector2/sqrmagnitude.md

# Vector2::SqrMagnitude

```cpp
static float SqrMagnitude(const Vector2& v)
float SqrMagnitude() const
```

计算向量长度的平方。比 Magnitude 更快，避免了开方运算。在比较相对长度或进行性能敏感的计算时优先使用。

**静态版本参数：**
- `v` - 要计算长度的向量

**实例版本：** 计算当前向量的长度平方。

**返回：** `float` - 向量长度平方 x * x + y * y

**线程安全：** ✅

**异常：** （无）

**复杂度：** O(1)

**示例：**

```cpp
Vector2 v(3.0f, 4.0f);
float sqlen = v.SqrMagnitude();                    // 25.0f
float sqlen2 = Vector2::SqrMagnitude(v);          // 25.0f
```

## 相关文档

- [Vector2](vector2.md) - 返回类总览
- [Magnitude](magnitude.md) - 向量长度
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			`# Vector2::SqrMagnitude`

			```cpp
			`static float SqrMagnitude(const Vector2& v)`
			`float SqrMagnitude() const`
			```

docs: update math API docs 2026-03-20 02:35:15 +08:00			`计算向量长度的平方。比 Magnitude 更快，避免了开方运算。在比较相对长度或进行性能敏感的计算时优先使用。`
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
			`静态版本参数：`
			- `v` - 要计算长度的向量

			`实例版本：计算当前向量的长度平方。`

			返回： `float` - 向量长度平方 x * x + y * y

docs: update math API docs 2026-03-20 02:35:15 +08:00			`线程安全： ✅`

			`异常：（无）`

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			`复杂度： O(1)`

			`示例：`

			```cpp
			`Vector2 v(3.0f, 4.0f);`
			`float sqlen = v.SqrMagnitude(); // 25.0f`
			`float sqlen2 = Vector2::SqrMagnitude(v); // 25.0f`
			```
docs: update math API docs 2026-03-20 02:35:15 +08:00
			`## 相关文档`

			`- [Vector2](vector2.md) - 返回类总览`
			`- [Magnitude](magnitude.md) - 向量长度`