Freigeben über


_mbsnbcat, _mbsnbcat_l

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.

Wichtiger HinweisWichtig

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.

Siehe auch

Referenz

Zeichenfolgenbearbeitung (CRT)

_mbsnbcmp, _mbsnbcmp_l

_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l

_mbsnbcpy, _mbsnbcpy_l

_mbsnbicmp, _mbsnbicmp_l

_mbsnbset, _mbsnbset_l

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

_mbsnbcat_s, _mbsnbcat_s_l