Freigeben über


_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

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.

Wichtiger HinweisWichtig

_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.

SicherheitshinweisSicherheitshinweis

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.

Siehe auch

Referenz

Zeichenfolgenbearbeitung (CRT)

Gebietsschema

Interpretation von Mehrbytezeichen-Sequenzen

_mbsnbset, _mbsnbset_l

memset, wmemset

strcat, wcscat, _mbscat

strcmp, wcscmp, _mbscmp

überprüfte, wcscpy, _mbscpy

_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l