CKTIS / C
memcpy — kopiranje neprekrivajočih se bajtov C23
`memcpy(s1, s2, n)` iz `<string.h>` kopira natančno `n` bajtov predstavitve objekta iz vira `s2` v zapisljiv cilj `s1` in vrne prvotno vrednost `s1`. Bajti se razumejo kot `unsigned char`; funkcija ne pozna elementov, dolžin tabel ali zaključnih znakov besedila.
Različica: C23
Sintaksa
void *memcpy(void * restrict s1, const void * restrict s2, size_t n);memcpy(s1, s2, n) iz <string.h> kopira natančno n bajtov predstavitve objekta iz vira s2 v zapisljiv cilj s1 in vrne prvotno vrednost s1. Bajti se razumejo kot unsigned char; funkcija ne pozna elementov, dolžin tabel ali zaključnih znakov besedila.
Primer kopira celotno predstavitev štirielementne tabele int v ločeno tabelo. Izhod 1 5 13 potrdi istovetnost vrnjenega kazalca in vrednosti, dejansko kopirane v elementa z indeksoma 1 in 3.
Izvorno in ciljno območje se ne smeta niti delno prekrivati — tako kopiranje ima nedoločeno vedenje; ob možnem prekrivanju uporabite memmove. Oba kazalca morata biti veljavna tudi pri n == 0; pri pozitivnem n mora biti ves cilj zapisljiv in oba obsega znotraj objektov. memcpy je plitek: kopirani kazalci kažejo na iste vire, ne doda \0, count * sizeof *p pa zahteva preverjanje prekoračitve.
Primeri
#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
Primer kopira celotno predstavitev štirielementne tabele `int` v ločeno tabelo. Izhod `1 5 13` potrdi istovetnost vrnjenega kazalca in vrednosti, dejansko kopirane v elementa z indeksoma 1 in 3.