_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

Artikel
03/12/2013

Legen Sie Zeichen einer Zeichenfolge mit einem Zeichen fest.Diese sind Versionen von _strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l mit Sicherheitserweiterungen, wie in Sicherheitsfeatures im CRT beschrieben.

Wichtig
_mbsset_s und _mbsset_s_l können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

errno_t _strset_s( char *str, size_t numberOfElements, int c ); errno_t _strset_s_l( char *str, size_t numberOfElements, int c, locale_t locale ); errno_t _wcsset_s( wchar_t *str, size_t numberOfElements, wchar_t c ); errno_t *_wcsset_s_l( wchar_t *str, size_t numberOfElements, wchar_t c, locale_t locale ); errno_t _mbsset_s( unsigned char *str, size_t numberOfElements, unsigned int c ); errno_t _mbsset_s_l( unsigned char *str, size_t numberOfElements, unsigned int c, _locale_t locale );

Parameter

str
Auf NULL endende Zeichenfolge festgelegt werden.
numberOfElements
Die Größe des Puffers str.
c
Zeicheneinstellung.
locale
Zu verwendende Gebietsschema.

Rückgabewert

Null erfolgreich, wenn andernfalls ein Fehlercode.

Diese Funktionen überprüfen Argumente.Wenn str ein NULL-Zeiger ist oder das numberOfElements-Argument kleiner oder gleich 0 ist oder der Block, der übergeben wird, nicht auf NULL endende ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, geben diese Funktionen EINVAL zurück und legen errno auf EINVAL fest.

Hinweise

Die _strset_s-Funktion legt alle Zeichen aus str zu c (konvertiert char), außer das NULL fest._wcsset_s und _mbsset_s sind Breitzeich und Mehrbytezeichen-Versionen von _strset_s.Die Datentypen der Argumente und Rückgabewerte der unterscheiden sich entsprechend.Diese Funktionen verhalten sich andernfalls identisch.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale finden Sie weitere Informationen.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema für dieses Verhalten abhängig; die Versionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter, der in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Die Debugversionen dieser Funktionen füllen zuerst den Puffer mit den Wert aus.Um dieses Verhalten zu deaktivieren, verwenden Sie _CrtSetDebugFillThreshold.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_UNICODE definiert
_tcsset_s	_strset_s	_mbsset_s	_wcsset_s
_tcsset_s_l	_strset_s_l	_mbsset_s_l	_wcsset_s_l

Anforderungen

Routine	Erforderlicher Header
_strset_s	<string.h>
_strset_s_l	<tchar.h>
_wcsset_s	<string.h> oder <wchar.h>
_wcsset_s_l	<tchar.h>
_mbsset_s, _mbsset_s_l	<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_strset_s.c
#include <string.h>
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset_s( string, _countof(string), '*' );
   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.