CKTIS / C
memset — vyplnění paměti bajty
memset z <string.h> vyplní n bajtů hodnotou c převedenou na unsigned char. Pracuje s bajty, nikoli s hodnotami prvků pole.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
void *memset(void *s, int c, size_t n);memset(s, c, n) zapíše c, převedené na unsigned char, do prvních n bajtů objektu, na který ukazuje s. Vrací s; deklaraci poskytuje <string.h>.
Oblast musí být zapisovatelná a dostatečně velká. Zápis za její hranice způsobuje nedefinované chování. n udává počet bajtů, nikoli prvků: memset(a, 1, sizeof a) není obecný způsob, jak nastavit prvky pole int na 1.
V příkladu zahrnuje sizeof data celé pole unsigned char, takže každý prvek dostane hodnotu 7.
Nepoužívejte běžné memset k zaručenému mazání tajných údajů: optimalizátor může odstranit zápis, který není pozorovatelný. C23 pro tento účel poskytuje memset_explicit; samotná volba přepínače překladače pro C23 nepotvrzuje, že je tato funkce dostupná v běhové knihovně.
Příklady
#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;
}
Výsledek
7 7 7 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.