_mbsnbcat, _mbsnbcat_l

Статья
04/10/2013

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

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

unsigned char *_mbsnbcat(
   unsigned char *dest,
   const unsigned char *src,
   size_t count 
);
unsigned char *_mbsnbcat_l(
   unsigned char *dest,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char *_mbsnbcat(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsnbcat_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

Параметры

dest
Завершенная объединения строки назначения многобайтовой кодировки.
src
Объединения завершенной строка источника многобайтовой кодировки.
count
Число байтов из src, добавляемый в dest.
locale
Языковой стандарт, который необходимо использовать.

Возвращаемое значение

_mbsnbcat возвращает указатель на строку назначения.Возвращаемое значение не зарезервировано для отображения ошибки.

Заметки

Функция _mbsnbcat добавляет, по крайней мере, первый байт countsrc имеет значение dest.Если байт немедленно преждe нуля-символа в dest старшего байта, начальный src перезапишет этот старшим.В противном случае начальный байт src перезапишет конечное нуль-символ dest.Если NULL байт отображается в src до того, как были добавлены, байты count _mbsnbcat добавляет все байтов из src, до нуля-символа.Если count больше, чем длина src, то длина src используется вместо count.Результирующая строка, с нулем-символом.Если происходит копирование между строками, которые перекрываются, расширения функциональности не определено.

Выходное значение зависеть на параметром параметра категории LC_CTYPE языкового стандарта; дополнительные сведения см. в разделе setlocale.Версия функции _mbsnbcat используется текущий языковой стандарт для данного расширения функциональности языкового стандарта, элемента. версия _mbsnbcat_l идентичны за исключением того, что они используют параметры языкового стандарта, вместо этого в.Для получения дополнительной информации см. Языковой стандарт.

Использование Security Note объединения завершенной строка.Объединения завершенной строка не должна превышать размер буфера назначения.Дополнительные сведения см. в разделе Как избежать переполнения буфера.

Если dest или src, функция NULL вызовет ошибку недопустимого параметра, как описано в разделе Проверка параметров.Если ошибка обработана, функция EINVAL возвращает и задает для errno значение EINVAL.

В C++, эти функции имеют перегруженные шаблонные версии, которые вызывают более новые и безопасные аналоги этих функций.Для получения дополнительной информации см. Предоставляйте перегруженный шаблона.

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