_mbsnbcat, _mbsnbcat_l

Artikel
02/26/2013

Fügen Sie höchstens die ersten n Bytes aus einer Mehrbyte-Zeichenfolge zu anderen an.Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter _mbsnbcat_s, _mbsnbcat_s_l.

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

unsigned char *_mbsnbcat( unsigned char *dest, const unsigned char *src, size_t count ); unsigned char *_mbsnbcat_l( unsigned char *dest, const unsigned char *src, size_t count, _locale_t locale ); template <size_t size> unsigned char *_mbsnbcat( unsigned char (&dest)[size], const unsigned char *src, size_t count ); // C++ only template <size_t size> unsigned char *_mbsnbcat_l( unsigned char (&dest)[size], const unsigned char *src, size_t count, _locale_t locale ); // C++ only

Parameter

dest
Auf NULL endende Mehrbytezeichenzielzeichenfolge.
src
Auf NULL endende Mehrbytezeichenquellzeichenfolge.
count
Anzahl von Bytes zu dest anzufügen, src.
locale
Zu verwendende Gebietsschema.

Rückgabewert

_mbsnbcat gibt einen Zeiger auf die Zielzeichenfolge zurück.Kein Rückgabewert wird reserviert, um einen Fehler anzugeben.

Hinweise

Die Funktion _mbsnbcat fügt höchstens die ersten count Bytes von src zu dest an.Wenn das Byte direkt vor dem NULL-Zeichen in dest ein führendes Byte ist, überschreibt das ursprüngliche Byte von src dieses führende Byte.Andernfalls überschreibt das ursprüngliche Byte von src das NULL von dest.Wenn ein Nullbyte in src angezeigt wird, bevor count Bytes angefügt werden, fügt _mbsnbcat alle Bytes von src, bis zum NULL-Zeichen an.Wenn count größer als die Länge von src ist, wird die Länge von src anstelle count verwendet.Die Ergebniszeichenfolge wird mit einem NULL-Zeichen beendet.Wenn das Kopieren zwischen Zeichenfolgen stattfindet, die sich überschneiden, wird das Verhalten nicht definiert.

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

Security Note Verwendung mit einer NULL.Die auf NULL endende Zeichenfolge darf die Größe des Zielpuffers nicht überschreiten.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

Wenn dest oder srcNULL ist, generiert die Funktion einen ungültigen Parameterfehler, wie in Parametervalidierung beschrieben.Wenn der Fehler behandelt wird, gibt die Funktion EINVAL zurück und legt errno zu EINVAL fest.

In C++ sind diese Funktionen Vorlagenüberladungen, die aufrufen, das später, speichern Entsprechungen dieser Funktionen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

Anforderungen

Routine	Erforderlicher Header
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

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

.NET Framework-Entsprechung

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