# shz_sq_memcpy32_xmtrx

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

> Copies bytes from src to dst in 32-byte chunks, using the Store Queues and XMTRX

```c
SHZ_INLINE void* shz_sq_memcpy32_xmtrx( void* SHZ_RESTRICT dst, const void* SHZ_RESTRICT src, size_t bytes) SHZ_NOEXCEPT;
```

Copies `bytes` from `src` to `dst` in 32-byte chunks, using the Store Queues and XMTRX.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `dst` | `void *SHZ_RESTRICT` |  |
| `src` | `const void *SHZ_RESTRICT` |  |
| `bytes` | `size_t` |  |

## Returns

`void *`

## Details

Equiavalent to `shz_sq_memcpy32()`, except copying is done through XMTRX.

## Warnings

- This routine clobbers XMTRX.

## Naming and requirements

- `_xmtrx`: Uses the XMTRX register bank as a 64-byte scratch buffer. Clobbers XMTRX. ([Naming and Suffixes](https://sh4zam.com/concepts/naming-and-suffixes/))
- `sq_`: Writes through the SH4 store queues (burst writes to memory or the PVR). ([Naming and Suffixes](https://sh4zam.com/concepts/naming-and-suffixes/))

## Availability

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