# shz_sq_memcpy32_1_xmtrx

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

> Copies src to dst in a single 32-byte transaction using the Store Queues and XMTRX

```c
SHZ_INLINE void* shz_sq_memcpy32_1_xmtrx( void* SHZ_RESTRICT dst, const void* SHZ_RESTRICT src) SHZ_NOEXCEPT;
```

Copies `src` to `dst` in a single 32-byte transaction using the Store Queues and XMTRX.

## Parameters

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

## Returns

`void *`

## Details

Equivalent to `shz_sq_memcpy32_1()`, except copying is done through XMTRX.

## Warnings

- This routine clobberx 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_1_xmtrx`](https://sh4zam.com/api/cpp/#shzsq_memcpy32_1_xmtrx)
- **Type-generic form:** none
- **Back-ends:** SH4: dedicated SH4 implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_mem.h:355`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_mem.h#L355)
- **Module:** [Memory](https://sh4zam.com/api/memory/), section "Constant-sized Operations"

## See also

[`shz_memcpy32`](https://sh4zam.com/api/memory/shz_memcpy32/)