WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen