_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Artykuł
03/26/2013

Zestawy znaków ciągu znakowi.Bezpieczniejsze wersje te funkcje są dostępne; see _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Ważne
_mbsseti _mbsset_l nie można używać w aplikacji, których wykonywanie w Środowisko wykonawcze systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /ZW.

char *_strset(
   char *str,
   int c 
);
char *_strset_l(
   char *str,
   int c,
   locale_t locale
);
wchar_t *_wcsset(
   wchar_t *str,
   wchar_t c 
);
wchar_t *_wcsset_l(
   wchar_t *str,
   wchar_t c,
   locale_t locale
);
unsigned char *_mbsset(
   unsigned char *str,
   unsigned int c 
);
unsigned char *_mbsset_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
);

Parametry

str
Ciąg zakończony zerem, ma zostać ustawiona.
c
Ustawienie znaków.
locale
Ustawienia regionalne używane.

Wartość zwracana

Zwraca wskaźnik do zmienionych ciągu.

Uwagi

_strset Funkcja ustawia wszystkie znaki (z wyjątkiem zakończonych znakiem null) z str do c, konwertowane na char._wcsseti _mbsset_l szerokich znaków i znaków wielobajtowych wersje _strset, oraz typy danych argumentów i wartości zwracane odpowiednio zmienić.Funkcje te działają identycznie w przeciwnym razie.

_mbssetsprawdza poprawność jego parametry.Jeśli str jest pusty wskaźnik, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować,_mbsset zwraca NULL i ustawia errno do EINVAL._strseti _wcsset nie są zgodne z nimi parametrów.

Wartość produkcji jest zależny od ustawienia z LC_CTYPE kategorii ustawienie regionalne tzn. zobacz setLocale, _wsetlocale Aby uzyskać więcej informacji.Wersje te funkcje są identyczne, z tym, że te nie mają _l sufiks Użyj bieżących ustawień regionalnych i tych, które mają _l sufiks zamiast tego użyć parametru ustawień regionalnych, który jest przekazywana.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Uwaga dotycząca zabezpieczeń
Tych funkcji może być narażony na zagrożenia przepełnienie buforu.Przekroczenia buforu może służyć do systemu ataków, ponieważ mogą one powodować nieuzasadnione podniesienie uprawnień.Aby uzyskać więcej informacji, zobacz Unikanie przekroczeniem buforu.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> lub <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz Zgodność.

Przykład

// crt_strset.c
// compile with: /W3

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset( string, '*' ); // C4996
   // Note: _strset is deprecated; consider using _strset_s instead
   printf( "After:  %s\n", string );
}