Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

Initialisieren Sie Zeichen einer Zeichenfolge mit einem angegebenen Zeichen. Sicherere Versionen dieser Funktionen vorhanden sind; finden Sie unter _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l.

Wichtiger Hinweis Wichtig

_mbsnset und _mbsnset_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.

char *_strnset( char *str, int c, size_t count ); char *_strnset_l( char *str, int c, size_t count, locale_t locale ); wchar_t *_wcsnset( wchar_t *str, wchar_t c, size_t count ); wchar_t *_wcsnset_l( wchar_t *str, wchar_t c, size_t count, _locale_t locale ); unsigned char *_mbsnset( unsigned char *str, unsigned int c, size_t count ); unsigned char *_mbsnset_l( unsigned char *str, unsigned int c, size_t count, _locale_t locale );

str

Die zu ändernde Zeichenfolge.

c

Zeicheneinstellung.

count

Zahl festgelegt werden Zeichen.

locale

Das zu verwendende Gebietsschema.

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

Die _strnset-Funktionssätze höchstens die ersten count Zeichen aus str zu c (konvertiert char). Wenn count größer als die Länge von str ist, wird die Länge von str anstelle count verwendet.

_wcsnset und _mbsnset sind Breitzeich und Mehrbytezeichen-Versionen von _strnset. Die Zeichenfolgenargumente und der Rückgabewert von _wcsnset sind Breitzeichen-Zeichenfolgen; die von _mbsnset sind Mehrbyte-Zeichenfolgen. Diese drei Funktionen verhalten sich andernfalls identisch.

_mbsnset ü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, wird von _mbsnset gibt ungültig und legen errno zu EINVAL fest. _strnset und _wcsnset überprüfen nicht ihre Parameter.

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.

Zuordnung generische Textroutinen

TCHAR.H-Routine

_UNICODE & _MBCS nicht definiert.

_MBCS definiert

_UNICODE definiert

_tcsnset

_strnset

_mbsnbset

_wcsnset

_tcsnset_l

_strnset_l

_mbsnbset_l

_wcsnset_l

Routine

Erforderlicher Header

_strnset

<string.h>

_strnset_l

<tchar.h>

_wcsnset

<string.h> oder <wchar.h>

_wcsnset_l

<tchar.h>

_mbsnset , _mbsnset_l

<mbstring.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

// crt_strnset.c
// compile with: /W3
#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 characters of string to be *'s */
   printf( "Before: %s\n", string );
   _strnset( string, '*', 4 ); // C4996
   // Note: _strnset is deprecated; consider using _strnset_s
   printf( "After:  %s\n", string );
}
Vorher: Dies ist ein Test anschließend: **** ist ein Test

Community-Beiträge

HINZUFÜGEN
Anzeigen: