# %memcpy() function

The %memcpy() function copies the number
of characters specified by number from memory area *s2* into *s1*.

## Syntax

```
var = (char*)%memcpy(s1, s2, length)
```

## Parameter(s)

| var | Pointer to s1. |
| --- | --- |
| s1 | Can be a FlashBASIC string or a pointer to a character. If s1 is a D3 string, the value returned by this function has no meaning. |
| s2 | Can be a FlashBASIC string or a pointer to a character. |
| length | Number of bytes to copy. |
Note: If the string contains a segment mark (x’ff’), the
data is truncated.

## Example(s)

```
* Read 1024 bytes from device
* and copy them in a D3 buffer
precision 0
char buffer[1024]
p=(char*)%malloc(1024)
n=%read(fd, (char*)p, 1024)
%memcpy(buffer, p+32, n-32)
```
In this example, note the operation on pointers, allowed
because of the statement precision 0. This allows
reading data from a device, and copy only the portion after a fixed
size header (32 bytes in this example).

## See also

- [%memxcpy() function](https://d3codex.com/pickbasic-flashbasic/percent-memxcpy-function/)
- [FlashBASIC C functions overview](https://d3codex.com/pickbasic-flashbasic/flashbasic-c-functions-overview/)
- [cfunction statement](https://d3codex.com/pickbasic-flashbasic/cfunction-statement/)

---
Source: https://d3codex.com/pickbasic-flashbasic/percent-memcpy-function/ - part of the D3Codex reference.