_mbccpy, _mbccpy_l

Статья
06/09/2015

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

Важно!

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

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 используется языковой стандарт, переданный для любого поведения, зависящего от языкового стандарта. Для получения дополнительной информации см. Языковой стандарт.

Примечание о безопасности Следует использовать строку, оканчивающуюся символом null. Завершающаяся нулевым символом строка не должна превышать размер буфера назначения. Дополнительные сведения см. в разделе Как избежать переполнения буфера. Ошибки переполнения буфера — частый метод атаки системы, в результате которого происходит несанкционированное получение прав.

Универсальное текстовое сопоставление функций

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

Требования

Подпрограмма	Обязательный заголовок
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

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

Эквивалент в .NET Framework

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

Языковой стандарт

Интерпретация последовательностей в многобайтной кодировке

_mbclen, mblen, _mblen_l

Поделиться через