Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri