# shz_dcache_alloc_line

Source: https://sh4zam.com/api/memory/shz_dcache_alloc_line/

> Intrinsic around the SH4 MOVCA.L instruction

```c
SHZ_INLINE void shz_dcache_alloc_line(void* src) SHZ_NOEXCEPT;
```

Intrinsic around the SH4 `MOVCA.L` instruction.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `src` | `void *` |  |

## Returns

Nothing (`void`).

## Details

Preallocates the cache-line containing `src`.

Zero-initializes all 32-bytes within the `src` cache-line, setting the valid bit to `1`.

## Availability

- **C++ equivalent:** [`shz::dcache_alloc_line`](https://sh4zam.com/api/cpp/#shzdcache_alloc_line)
- **Type-generic form:** none
- **Back-ends:** SH4: dedicated SH4 implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_mem.h:365`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_mem.h#L365)
- **Module:** [Memory](https://sh4zam.com/api/memory/), section "Constant-sized Operations"