_mbsnbcat, _mbsnbcat_l

Připojí maximálně první n bajtů jednoho vícebajtového řetězce k druhému. K dispozici jsou bezpečnější verze těchto funkcí; viz _mbsnbcat_s, _mbsnbcat_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

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

Parametry

dest
Cílový řetězec s vícebajtovými znaky s hodnotou null.

src
Zdrojový řetězec s vícebajtovými znaky s hodnotou null.

count
Počet bajtů od src připojení k dest.

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

Vrácená hodnota

_mbsnbcat vrátí ukazatel na cílový řetězec. Žádná návratová hodnota není vyhrazena k označení chyby.

Poznámky

Funkce _mbsnbcat připojí nejvýše první count bajty src k dest. Pokud bajt bezprostředně před znakem null je dest úvodní bajt, počáteční bajt tohoto bajtu src přepíše tento hlavní bajt. Jinak počáteční bajt src přepsání ukončující znak null znaku dest. Pokud se před připojením bajtů zobrazí srccount bajt null, _mbsnbcat připojí všechny bajty z src, až do znaku null. Je-li count větší než délka src, délka src je použita místo count. Výsledný řetězec se ukončí znakem null. Pokud probíhá kopírování mezi řetězci, které se překrývají, chování není definováno.

Výstupní hodnota je ovlivněna nastavením LC_CTYPE nastavení kategorie národního prostředí. Další informace najdete na webu setlocale. Verze _mbsnbcat funkce používá aktuální národní prostředí pro toto chování závislé na národním prostředí. Verze _mbsnbcat_l je shodná s tím rozdílem, že místo toho používají předaný parametr národního 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.

Pokud dest nebo src je NULL, funkce vygeneruje neplatnou chybu parametru, jak je popsáno v ověření parametru. Pokud je chyba zpracována, funkce vrátí EINVAL a nastaví errno hodnotu EINVAL.

V jazyce C++ mají tyto funkce přetížení šablon, které vyvolávají novější zabezpečené protějšky těchto funkcí. Další informace naleznete v tématu Přetížení šablon zabezpečení.

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
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

Požadavky

Rutina	Požadovaný hlavičkový soubor
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

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

Viz také

Manipulace s řetězci
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbicmp, _mbsnbicmp_l
_mbsnbset, _mbsnbset_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
_mbsnbcat_s, _mbsnbcat_s_l