CKTIS / C
memset — geheugen vullen met bytes
memset uit <string.h> vult n bytes met c, omgezet naar unsigned char. De functie werkt met bytes, niet met de waarden van arrayelementen.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
void *memset(void *s, int c, size_t n);memset(s, c, n) schrijft c, omgezet naar unsigned char, naar de eerste n bytes van het object waarnaar s wijst. De functie geeft s terug; <string.h> levert de declaratie.
Het gebied moet schrijfbaar en groot genoeg zijn. Schrijven buiten de grenzen ervan leidt tot ongedefinieerd gedrag. n telt bytes, geen elementen: memset(a, 1, sizeof a) is geen algemene manier om de elementen van een int-array op 1 te zetten.
In het voorbeeld omvat sizeof data de volledige unsigned char-array, dus krijgt elk element de waarde 7.
Gebruik gewone memset niet om geheimen gegarandeerd te wissen: de optimizer kan een niet-waarneembare schrijfoperatie verwijderen. C23 biedt hiervoor memset_explicit; alleen een C23-compileroptie kiezen bewijst niet dat deze functie beschikbaar is in de runtimebibliotheek.
Voorbeelden
#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;
}
Resultaat
7 7 7 7
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.