Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

memmove — bezpieczne kopiowanie nakładających się bajtów C23

`memmove(s1, s2, n)` z `<string.h>` kopiuje `n` bajtów reprezentacji ze źródła do modyfikowalnego celu i zwraca pierwotne `s1`. W odróżnieniu od `memcpy` wynik jest określony także przy nakładaniu się zakresów: semantyka jest taka, jakby najpierw skopiowano źródło do oddzielnej tymczasowej tablicy `n` bajtów.

Wersja: C23

Składnia

void *memmove(void *s1, const void *s2, size_t n);

memmove(s1, s2, n) z <string.h> kopiuje n bajtów reprezentacji ze źródła do modyfikowalnego celu i zwraca pierwotne s1. W odróżnieniu od memcpy wynik jest określony także przy nakładaniu się zakresów: semantyka jest taka, jakby najpierw skopiowano źródło do oddzielnej tymczasowej tablicy n bajtów.

Przykład przesuwa cztery pierwsze bajty napisu "ABCDE" o jedną pozycję w prawo w tym samym buforze. Zakresy celowo się nakładają, a wynik 1 AABCD potwierdza zarówno zwrócony wskaźnik text + 1, jak i zachowanie oryginalnych bajtów mimo nadpisywania do przodu.

Bezpieczeństwo dla overlap nie naprawia złych granic: oba zakresy n bajtów muszą mieścić się w dostępnych obiektach, cel musi być zapisywalny, a wskaźniki pozostają wymagane nawet dla n == 0. Funkcja kopiuje bajty, nie elementy ani własność zasobów, i sama nie dodaje terminatora \0; przesuwając fragment tekstu, uwzględnij terminator jawnie, jeśli ma być częścią wyniku.

Przykłady

#include <stdio.h>
#include <string.h>
int main(void){char text[]="ABCDE";void *result=memmove(text+1,text,4);printf("%d %s\n",result==text+1,text);return 0;}

Wynik

1 AABCD

Przykład przesuwa cztery pierwsze bajty napisu `"ABCDE"` o jedną pozycję w prawo w tym samym buforze. Zakresy celowo się nakładają, a wynik `1 AABCD` potwierdza zarówno zwrócony wskaźnik `text + 1`, jak i zachowanie oryginalnych bajtów mimo nadpisywania do przodu.

Źródła