_mbccpy, _mbccpy_l

Kopiert ein Multibytezeichen von einer Zeichenfolge in eine andere Zeichenfolge. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _mbccpy_s, _mbccpy_s_l.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

void _mbccpy(
   unsigned char *dest,
   const unsigned char *src
);
void _mbccpy_l(
   unsigned char *dest,
   const unsigned char *src,
   _locale_t locale
);

Parameter

dest
Kopierziel.

src
Zu kopierendes Multibytezeichen.

locale
Zu verwendendes Gebietsschema.

Hinweise

Die _mbccpy-Funktion kopiert ein Multibytezeichen von src in dest.

Diese Funktion überprüft ihre Parameter. Wenn _mbccpy ein NULL-Zeiger dest für oder src, der ungültige Parameterhandler aufgerufen wird, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL festgelegt.

_mbccpy verwendet das aktuelle Gebietsschema für jedes gebietsschemaabhängige Verhalten. _mbccpy_l ist mit _mbccpy identisch, außer dass _mbccpy_l das Gebietsschema verwendet, das für jedes gebietsschemaabhängige Verhalten übergeben wurde. Weitere Informationen finden Sie unter Locale.

Sicherheitshinweis Verwenden Sie eine mit NULL endende Zeichenfolge. Die mit NULL endende Zeichenfolge darf die Größe des Zielpuffers nicht überschreiten. Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen. Pufferüberlaufprobleme werden häufig bei Systemangriffen eingesetzt, da sie zu einer unbefugten Ausweitung der Berechtigungen führen.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Tchar.h-Routine _UNICODE und _MBCS nicht definiert _MBCS definiert _UNICODE definiert
_tccpy Führt eine Zuordnung zum Makro oder zur Inlinefunktion aus _mbccpy Führt eine Zuordnung zum Makro oder zur Inlinefunktion aus
_tccpy_l Nicht zutreffend _mbccpy_l Nicht zutreffend

Anforderungen

Routine Erforderlicher Header
_mbccpy <mbctype.h>
_mbccpy_l <mbctype.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Gebietsschema
Interpretation von Multibytezeichensequenzen
_mbclen, mblen_mblen_l