CKTIS / C
memset — wypełnianie pamięci bajtami
memset z <string.h> wypełnia n bajtów wartością c przekształconą na unsigned char. Działa na bajtach, a nie na wartościach elementów tablicy.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <string.h>
void *memset(void *s, int c, size_t n);memset(s, c, n) zapisuje c po konwersji na unsigned char w pierwszych n bajtach obiektu wskazywanego przez s. Zwraca s; deklarację udostępnia <string.h>.
Obszar musi być zapisywalny i wystarczająco duży. Przekroczenie granic powoduje niezdefiniowane zachowanie. n oznacza bajty, nie elementy: memset(a, 1, sizeof a) nie jest ogólnym sposobem ustawienia elementów tablicy int na 1.
W przykładzie sizeof data obejmuje całą tablicę unsigned char, więc każdy element otrzymuje 7.
Nie używaj zwykłego memset jako gwarantowanego wymazywania sekretów: optymalizator może usunąć nieobserwowalny zapis. C23 udostępnia do tego memset_explicit; sam wybór flagi C23 nie potwierdza dostępności tej funkcji w bibliotece środowiska wykonawczego.
Przykłady
#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;
}
Wynik
7 7 7 7
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.