_mbccpy, _mbccpy_l

Kopiert ein Multibytezeichen von einer Zeichenfolge in eine andere Zeichenfolge. Sicherere Versionen dieser Funktionen sind verfügbar; siehe _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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

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	–	_mbccpy_l	–

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 Multibyte-Zeichensequenzen
_mbclen, mblen, _mblen_l