CKTIS / C
memset — riempire la memoria con byte
memset di <string.h> riempie n byte con c convertito in unsigned char. Opera sui byte, non sui valori degli elementi di un array.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <string.h>
void *memset(void *s, int c, size_t n);memset(s, c, n) scrive c, convertito in unsigned char, nei primi n byte dell’oggetto puntato da s. Restituisce s; <string.h> ne fornisce la dichiarazione.
L’area deve essere scrivibile e sufficientemente grande. Scrivere oltre i suoi limiti causa un comportamento indefinito. n conta i byte, non gli elementi: memset(a, 1, sizeof a) non è un metodo generale per impostare a 1 gli elementi di un array di int.
Nell’esempio, sizeof data comprende l’intero array di unsigned char, quindi ogni elemento riceve 7.
Non usare il normale memset per garantire la cancellazione dei segreti: l’ottimizzatore potrebbe eliminare una scrittura non osservabile. C23 fornisce memset_explicit a questo scopo; la sola selezione di un’opzione del compilatore C23 non dimostra che la funzione sia disponibile nella libreria di runtime.
Esempi
#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;
}
Risultato
7 7 7 7
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.