memset, wmemset

Define um buffer para um caractere especificado.

Sintaxe

void *memset(
   void *dest,
   int c,
   size_t count
);
wchar_t *wmemset(
   wchar_t *dest,
   wchar_t c,
   size_t count
);

Parâmetros

dest
Ponteiro para o destino.

c
Caractere a ser definido.

count
Número de caracteres.

Valor retornado

O valor de dest.

Comentários

Define os primeiros count caracteres de dest para o caractere c.

Observação de segurança Certifique-se de que o buffer de destino tenha espaço suficiente para pelo menos count caracteres. Para obter mais informações, confira Como evitar sobrecargas de buffer.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Rotina	Cabeçalho necessário
memset	<memory.h> ou <string.h>
wmemset	<wchar.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Exemplo

// crt_memset.c
/* This program uses memset to
* set the first four chars of buffer to "*".
*/

#include <memory.h>
#include <stdio.h>

int main( void )
{
   char buffer[] = "This is a test of the memset function";

   printf( "Before: %s\n", buffer );
   memset( buffer, '*', 4 );
   printf( "After:  %s\n", buffer );
}

O exemplo produz essa saída:

Before: This is a test of the memset function
After:  **** is a test of the memset function

Veja um exemplo do uso de wmemset:

// crt_wmemset.c
/* This program uses memset to
* set the first four chars of buffer to "*".
*/

#include <wchar.h>
#include <stdio.h>

int main( void )
{
   wchar_t buffer[] = L"This is a test of the wmemset function";

   wprintf( L"Before: %s\n", buffer );
   wmemset( buffer, L'*', 4 );
   wprintf( L"After:  %s\n", buffer );
}

O exemplo produz essa saída:

Before: This is a test of the wmemset function
After:  **** is a test of the wmemset function

Confira também

Manipulação de buffer
_memccpy
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l