XCEngine/docs/api/math/vector3/sqrmagnitude.md

# Vector3::SqrMagnitude

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

计算向量长度的平方。比 Magnitude 更快，避免了开方运算。

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

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

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

**线程安全：** ✅

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

**示例：**

```cpp
Vector3 v(1.0f, 2.0f, 2.0f);
float sqlen = v.SqrMagnitude();                    // 9.0f
float sqlen2 = Vector3::SqrMagnitude(v);          // 9.0f
```

## 相关文档

- [Vector3 类总览](vector3.md) - 返回类总览
- [`Magnitude`](magnitude.md) - 计算向量长度