_mbccpy, _mbccpy_l

Kopiuje znak wielobajtowy z jednego ciągu do innego ciągu. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz _mbccpy_s, _mbccpy_s_l.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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

Parametry

dest
Kopiuj miejsce docelowe.

src
Znak wielobajtowy do skopiowania.

locale
Ustawienia regionalne do użycia.

Uwagi

Funkcja _mbccpy kopiuje jeden znak wielobajtowy z src do dest.

Ta funkcja weryfikuje jego parametry. Jeśli _mbccpy jest przekazywany wskaźnik o wartości null dla dest lub src, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Walidacja parametru. Jeśli wykonywanie jest dozwolone do kontynuowania, errno jest ustawiona na EINVALwartość .

_mbccpy używa bieżących ustawień regionalnych dla dowolnego zachowania zależnego od ustawień regionalnych. _mbccpy_l jest identyczny z _mbccpy tą różnicą, że _mbccpy_l używa ustawień regionalnych przekazanych dla dowolnego zachowania zależnego od ustawień regionalnych. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Uwaga zabezpieczeń Użyj ciągu zakończonego wartością null. Ciąg zakończony wartością null nie może przekraczać rozmiaru buforu docelowego. Aby uzyskać więcej informacji, zobacz Unikanie przekroków buforu. Problemy z przepełnieniem buforu są częstą metodą ataku systemowego, co powoduje nieuzasadnione podniesienie uprawnień.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura tchar.h _UNICODE i _MBCS niezdefiniowane _MBCS Zdefiniowane _UNICODE Zdefiniowane
_tccpy Mapy do makra lub funkcji wbudowanej _mbccpy Mapy do makra lub funkcji wbudowanej
_tccpy_l nie dotyczy _mbccpy_l nie dotyczy

Wymagania

Procedura Wymagany nagłówek
_mbccpy <mbctype.h>
_mbccpy_l <mbctype.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

ustawienia regionalne
Interpretacja sekwencji znaków wielobajtowych
_mbclen, mblen, _mblen_l