# shz_quat_normalize_safe

Source: https://sh4zam.com/api/quat/shz_quat_normalize_safe/

```c
SHZ_INLINE shz_quat_t shz_quat_normalize_safe(shz_quat_t quat) SHZ_NOEXCEPT;
```

SAFELY returns the normalized form of the given quaternion.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `quat` | `shz_quat_t` |  |

## Returns

`shz_quat_t`

## Details

Returns the identity quaternion when magnitude is 0.0f.

## Naming and requirements

- `_safe`: Guards degenerate input (zero-length vectors, zero denominators) at a small cost. ([Naming and Suffixes](https://sh4zam.com/concepts/naming-and-suffixes/))

## Availability

- **C++ equivalent:** [`shz::quat::normalized_safe`](https://sh4zam.com/api/cpp/quat/#normalized_safe)
- **Type-generic form:** none
- **Back-ends:** SH4: shared C implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_quat.h:196`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_quat.h#L196)
- **Module:** [Quaternion](https://sh4zam.com/api/quat/), section "Modifiers"