Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

memmove — cópia C23 de bytes segura com sobreposição

`memmove(s1, s2, n)` de `<string.h>` copia `n` bytes de representação da origem para o destino modificável e devolve o `s1` original. Ao contrário de `memcpy`, o resultado está definido quando os intervalos se sobrepõem: a semântica é como copiar primeiro os bytes da origem para um array temporário separado de `n` bytes.

Versão: C23

Sintaxe

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

memmove(s1, s2, n) de <string.h> copia n bytes de representação da origem para o destino modificável e devolve o s1 original. Ao contrário de memcpy, o resultado está definido quando os intervalos se sobrepõem: a semântica é como copiar primeiro os bytes da origem para um array temporário separado de n bytes.

O exemplo desloca os primeiros quatro bytes de "ABCDE" uma posição para a direita no mesmo buffer. Os intervalos sobrepõem-se de propósito e a saída 1 AABCD confirma tanto o ponteiro devolvido text + 1 como a preservação dos bytes originais apesar da escrita para a frente.

A segurança perante sobreposição não corrige limites errados: os dois intervalos de n bytes têm de caber em objetos acessíveis, o destino tem de ser gravável e os ponteiros continuam obrigatórios mesmo com n == 0. A função copia bytes, não elementos nem propriedade de recursos, e não acrescenta \0; ao mover parte de uma string inclui explicitamente o terminador se fizer parte do resultado.

Exemplos

#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;}

Resultado

1 AABCD

O exemplo desloca os primeiros quatro bytes de `"ABCDE"` uma posição para a direita no mesmo buffer. Os intervalos sobrepõem-se de propósito e a saída `1 AABCD` confirma tanto o ponteiro devolvido `text + 1` como a preservação dos bytes originais apesar da escrita para a frente.

Fontes