CKTIS / C
memcpy — kopiranje bajtova bez preklapanja C23
`memcpy(s1, s2, n)` iz `<string.h>` kopira točno `n` bajtova reprezentacije objekta iz izvora `s2` u zapisivi cilj `s1` i vraća izvornu vrijednost `s1`. Bajtovi se tumače kao `unsigned char`; funkcija ne poznaje elemente, duljine polja ni završne znakove teksta.
Verzija: C23
Sintaksa
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) iz <string.h> kopira točno n bajtova reprezentacije objekta iz izvora s2 u zapisivi cilj s1 i vraća izvornu vrijednost s1. Bajtovi se tumače kao unsigned char; funkcija ne poznaje elemente, duljine polja ni završne znakove teksta.
Primjer kopira cijelu reprezentaciju četveročlanog polja int u odvojeno polje. Izlaz 1 5 13 potvrđuje identitet vraćenog pokazivača i vrijednosti stvarno kopirane u elemente s indeksima 1 i 3.
Izvorno i ciljno područje ne smiju se ni djelomično preklapati — takvo kopiranje ima nedefinirano ponašanje; pri mogućem preklapanju koristi memmove. Oba pokazivača moraju biti valjana i uz n == 0; za pozitivan n cijeli cilj mora biti zapisiv, a oba raspona unutar objekata. memcpy je plitak: kopirani pokazivači označuju iste resurse, ne dodaje \0, a count * sizeof *p zahtijeva provjeru prekoračenja.
Primjeri
#include <stdio.h>
#include <string.h>
int main(void){const int source[]={3,5,8,13};int target[4]={0};void *result=memcpy(target,source,sizeof source);printf("%d %d %d\n",result==target,target[1],target[3]);return 0;}
Rezultat
1 5 13
Primjer kopira cijelu reprezentaciju četveročlanog polja `int` u odvojeno polje. Izlaz `1 5 13` potvrđuje identitet vraćenog pokazivača i vrijednosti stvarno kopirane u elemente s indeksima 1 i 3.