_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Artikel
03/12/2013

Legt Zeichen einer Zeichenfolge mit einem Zeichen fest.Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Wichtig
_mbsset und _mbsset_l können in Anwendungen nicht verwendet werden, die in Windows-Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /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 );

Parameter

str
Auf NULL endende Zeichenfolge festgelegt werden.
c
Zeicheneinstellung.
locale
Zu verwendende Gebietsschema.

Rückgabewert

Gibt einen Zeiger auf die geänderten Zeichenfolge zurück.

Hinweise

Die _strset-Funktion legt alle Zeichen (außer dem NULL) von str zu c fest, konvertiert in char._wcsset und _mbsset_l sind Breitzeich und Mehrbytezeichen-Versionen von _strset, und die Datentypen der Argumente und Rückgabewerte der unterscheiden sich entsprechend.Diese Funktionen verhalten sich andernfalls identisch.

_mbsset überprüft seine Parameter.Wenn str ein NULL-Zeiger ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt _mbssetNULL zurück und legt errno zu EINVAL fest._strset und _wcsset überprüfen nicht ihre Parameter.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale, _wsetlocale finden Sie weitere Informationen.Die Versionen dieser Funktionen sind identisch, nur die, die nicht die _l Suffixverwendung das aktuelle Gebietsschema und die verfügen, die das _l Suffix stattdessen den Gebietsschemaparameter verwendet werden, der übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Sicherheitshinweis
Diese Funktionen sind möglicherweise für Pufferüberlaufbedrohungen anfällig.Pufferüberläufe können für Systemangriffe verwendet werden, da sie eine unbefugte Ausweitung seine Berechtigungen ausweitet verursachen können.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_UNICODE definiert
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Anforderungen

Routine	Erforderlicher Header
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> oder <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität.

Beispiel

// 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 );
}

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufzurufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.