War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
Exportieren (0) Drucken
Alle erweitern
CAB
Uhr
EOF
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

_mbsnbset_s, _mbsnbset_s_l

Legt die ersten n Bytes einer Mehrbyte-Zeichenfolge zu einem angegebenen Zeichen fest. Diese Versionen von _mbsnbset, _mbsnbset_l haben Sicherheitserweiterungen, wie in Sicherheitsfeatures im CRT beschrieben.

Wichtiger Hinweis Wichtig

Dieses API kann nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausführt werden. Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

errno_t _mbsnbset_s( unsigned char *str, size_t size, unsigned int c, size_t count ); errno_t _mbsnbset_s_l( unsigned char *str, size_t size, unsigned int c, size_t count, _locale_t locale ); template <size_t size> errno_t _mbsnbset_s( unsigned char (&str)[size], unsigned int c, size_t count ); // C++ only template <size_t size> errno_t _mbsnbset_s_l( unsigned char (&str)[size], unsigned int c, size_t count, _locale_t locale ); // C++ only

str

Die zu ändernde Zeichenfolge.

size

Die Größe des Zeichenfolgenpuffers.

c

Einzelbyte- oder Mehrbytezeicheneinstellung.

count

Die Anzahl der zu setzenden Bytes.

locale

Das zu verwendende Gebietsschema.

Null wenn erfolgreich, andernfalls ein Fehlercode.

_mbsnbset_s und _mbsnbset_s_l funktioniert Satz höchstens die ersten count Bytes von str zu c. Wenn count größer als die Länge von str ist, wird die Länge von str anstelle count verwendet. Wenn c ein Mehrbytezeichen ist und nicht in das letzte Byte vollständig festgelegt werden, die von count angegeben wird, wird das letzte Byte mit einem Leerzeichen aufgefüllt. _mbsnbset_s und _mbsnbset_s_l platzieren ein abschließendes NULL-Zeichen nicht am Ende von str.

_mbsnbset_s und _mbsnbset_s_l ähneln _mbsnset, außer dass sie legen count Bytes statt count Zeichen aus c fest.

Wenn strNULL ist, oder count null ist, generiert diese Funktion eine ungültige Parameterausnahme, wie in Parametervalidierung beschrieben. Wenn die Ausführung fortgesetzt werden darf, wird errno auf EINVAL gesetzt, und die Funktion gibt NULL zurück. Wenn c kein gültiges Mehrbytezeichen ist, wird errno zu EINVAL festgelegt und ein Leerzeichen wird stattdessen verwendet.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale, _wsetlocale finden Sie weitere Informationen. Die _mbsnbset_s-Version dieser Funktion verwendet das aktuelle Gebietsschema für dieses Verhalten abhängig; die _mbsnbset_s_l-Version ist identisch, allerdings verwendet stattdessen den Gebietsschemaparameter, der übergeben wird. Weitere Informationen finden Sie unter Gebietsschema.

In C++ wird die Verwendung dieser Funktionen durch Vorlagenüberladungen vereinfacht; die Überladungen können Pufferlänge automatisch ableiten und die Anforderung insofern vermeiden, ein Größenargument anzugeben. Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

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

Zuordnung generische Textroutinen

Tchar.h-Routine

_UNICODE und _MBCS undefiniert

_MBCS definiert

_UNICODE definiert

_tcsnset_s

_strnset_s

_mbsnbset_s

_wcsnset_s

_tcsnset_s_l

_strnset_s _l

_mbsnbset_s_l

_wcsnset_s_l

Routine

Erforderlicher Header

_mbsnbset_s

<mbstring.h>

_mbsnbset_s_l

<mbstring.h>

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität.

// crt_mbsnbset_s.c
#include <mbstring.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 bytes of string to be *'s */
   printf( "Before: %s\n", string );
   _mbsnbset_s( string, sizeof(string), '*', 4 );
   printf( "After:  %s\n", string );
}

            
              Vorher: Dies ist ein Test anschließend: **** ist ein Test
            
          

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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft