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

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.

Fontes