| # raw_ref<T> |
| |
| `raw_ref<T>` is a non-null smart pointer for C++ references, providing |
| Use-after-Free (UaF) protection identical to `raw_ptr<T>`. Think of it as a |
| combination of `std::reference_wrapper` and `raw_ptr`. |
| |
| See [raw_ptr.md](./raw_ptr.md) for details on the underlying MiraclePtr |
| protection. |
| |
| ## Usage |
| |
| Use `raw_ref<T>` for class members where you would normally use `T&`. It |
| enforces that the reference is never null. |
| |
| ## Key Differences from Native References |
| |
| ### Rebinding |
| |
| Unlike `T&`, a mutable `raw_ref<T>` can be reassigned: |
| |
| - `const raw_ref<T>`: Reference cannot be rebound. |
| - `const raw_ref<const T>`: Read-only reference; cannot be rebound. |
| |
| ### Use After Move |
| |
| `raw_ref<T>` will safely abort if accessed after being moved. |
| |
| ## Traits |
| |
| `raw_ref<T, Traits>` supports the same `RawPtrTraits` (e.g., `kMayDangle`) as |
| `raw_ptr`. See the [RawPtrTraits section in raw_ptr.md](./raw_ptr.md#RawPtrTraits). |
