_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í src
count
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 definovaný |
_UNICODE definovaný |
---|---|---|---|
_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