CKTIS / C
memset — preencher a memória com bytes
memset de <string.h> preenche n bytes com c convertido em unsigned char. Opera sobre bytes, não sobre os valores dos elementos de um array.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <string.h>
void *memset(void *s, int c, size_t n);memset(s, c, n) escreve c, convertido em unsigned char, nos primeiros n bytes do objeto apontado por s. Devolve s; <string.h> fornece a sua declaração.
A região tem de ser gravável e suficientemente grande. Escrever para além dos seus limites provoca comportamento indefinido. n conta bytes, não elementos: memset(a, 1, sizeof a) não é uma forma geral de definir como 1 os elementos de um array de int.
No exemplo, sizeof data abrange todo o array de unsigned char, pelo que cada elemento recebe 7.
Não uses o memset normal para garantir a eliminação de segredos: o optimizador pode remover uma escrita que não seja observável. C23 disponibiliza memset_explicit para este fim; escolher apenas uma opção de compilação C23 não confirma que esta função esteja disponível na biblioteca de execução.
Exemplos
#include <stdio.h>
#include <string.h>
int main(void)
{
unsigned char data[4];
memset(data, 7, sizeof data);
printf("%u %u %u %u\n",
(unsigned int)data[0], (unsigned int)data[1],
(unsigned int)data[2], (unsigned int)data[3]);
return 0;
}
Resultado
7 7 7 7
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.