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.