_mbccpy, _mbccpy_l

Zkopíruje vícebajtový znak z jednoho řetězce do druhého. K dispozici jsou bezpečnější verze těchto funkcí; viz _mbccpy_s, _mbccpy_s_l.

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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

Parametry

dest
Zkopírujte cíl.

src
Vícebajtový znak ke zkopírování.

locale
Národní prostředí, které se má použít.

Poznámky

Funkce _mbccpy zkopíruje jeden vícebajtový znak z src do dest.

Tato funkce ověří své parametry. Pokud _mbccpy se předá ukazatel null pro dest nebo src, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je povoleno pokračovat provádění, errno je nastaveno na EINVAL.

_mbccpy používá aktuální národní prostředí pro jakékoli chování závislé na národním prostředí. _mbccpy_l je shodný s tím rozdílem _mbccpy , že _mbccpy_l používá národní prostředí předávané pro jakékoli chování závislé na národním prostředí. Další informace naleznete v tématu Národní prostředí.

Poznámka zabezpečení – Použijte řetězec ukončený hodnotou null. Řetězec ukončený hodnotou null nesmí překročit velikost cílové vyrovnávací paměti. Další informace najdete v tématu Zabránění přetečení vyrovnávací paměti. Problémy s přetečením vyrovnávací paměti jsou častou metodou útoku na systém, což vede k neoprávněnému zvýšení oprávnění.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS Definovány	_UNICODE Definovány
_tccpy	Mapy na makro nebo vloženou funkci	_mbccpy	Mapy na makro nebo vloženou funkci
_tccpy_l	–	_mbccpy_l	–

Požadavky

Rutina	Požadovaný hlavičkový soubor
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Viz také

Národní prostředí
Interpretace vícebajtových sekvencí znaků
_mbclen, mblen, _mblen_l