CKTIS / C
memset — Speicher mit Bytes füllen
memset aus <string.h> füllt n Bytes mit c, umgewandelt in unsigned char. Die Funktion arbeitet mit Bytes, nicht mit den Werten von Arrayelementen.
Version: 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) schreibt c, umgewandelt in unsigned char, in die ersten n Bytes des von s bezeichneten Objekts. Die Funktion gibt s zurück; ihre Deklaration wird von <string.h> bereitgestellt.
Der Speicherbereich muss beschreibbar und groß genug sein. Ein Schreiben über seine Grenzen hinaus führt zu undefiniertem Verhalten. n zählt Bytes, keine Elemente: memset(a, 1, sizeof a) ist keine allgemeine Möglichkeit, die Elemente eines int-Arrays auf 1 zu setzen.
Im Beispiel umfasst sizeof data das gesamte unsigned char-Array, daher erhält jedes Element den Wert 7.
Verwende gewöhnliches memset nicht zum garantiert sicheren Löschen von Geheimnissen: Der Optimierer kann einen nicht beobachtbaren Schreibvorgang entfernen. C23 stellt dafür memset_explicit bereit; allein die Auswahl eines C23-Compiler-Flags belegt nicht, dass diese Funktion in der Laufzeitbibliothek verfügbar ist.
Beispiele
#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;
}
Ergebnis
7 7 7 7
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.