_mbccpy, _mbccpy_l

Копирует многобайтовый символ из одной строки в другую. Доступны более безопасные версии этих функций; see _mbccpy_s, _mbccpy_s_l.

Важно!

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

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

Параметры

dest
Место назначения копирования.

src
Многобайтовый символ для копирования.

locale
Используемый языковой стандарт.

Замечания

Функция _mbccpy копирует один многобайтовый символ из src в dest.

Эта функция проверяет свои параметры. Если _mbccpy передается указатель null для dest или srcвызывается недопустимый обработчик параметров, как описано в разделе проверки параметров. Если выполнение может быть продолжено, параметр errno устанавливается в значение EINVAL.

Функция_mbccpy использует текущий языковой стандарт для любого поведения, зависящего от языкового стандарта. Функция _mbccpy_l идентична функции _mbccpy, но в функции _mbccpy_l для любого поведения, зависящего от языкового стандарта, используется переданный в параметре языковой стандарт. Дополнительные сведения см. в разделе Locale.

Примечание о безопасности. Следует использовать строку, оканчивающуюся нуль-символом. Длина строки, завершающейся нуль-символом, не должна превышать размер буфера назначения. Дополнительные сведения см. в разделе "Избегание переполнения буфера". Проблемы переполнения буфера — это распространенный метод атак на системы, который приводит к несанкционированному повышению уровня прав.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tccpy	Сопоставляется макросу или встроенной функции	_mbccpy	Сопоставляется макросу или встроенной функции
_tccpy_l	Недоступно	_mbccpy_l	Недоступно

Требования

Маршрут	Обязательный заголовок
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Локаль
Интерпретация последовательностей многобайтовых символов
_mbclen, mblen, _mblen_l