_mbsnbcat, _mbsnbcat_l

Článek
06/09/2015

Připojí maximálně prvních n bajtů jednoho řetězec vícebajtových znaků k jinému.Bezpečnější verze těchto funkcí jsou k dispozici; viz _mbsnbcat_s, _mbsnbcat_s_l.

Důležité
Toto API nelze použít v aplikacích, které jsou spuštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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

Parametry

dest
Cílový řetězec vícebajtového znaku zakončeného hodnotou Null.
src
Zdrojový řetězec vícebajtového znaku zakončeného hodnotou Null.
count
Počet bajtů od z src pro připojení k dest.
locale
Použité národní prostředí.

Vrácená hodnota

_mbsnbcat vrací ukazatel na cílový řetězec.Není rezervována žádná vrácená hodnota pro indikaci chyby.

Poznámky

Funkce _mbsnbcat připojí maximálně prvních count znaků src k dest.Pokud bajt, který bezprostředně předchází znak null v dest je vedoucí bajt úvodní bajt src přepíše tento úvodní bajt.Jinak úvodní bajt src přepíše ukončující znak null proměnné dest.Pokud se objeví nulový bajt v src předtím, než jsou bajty count připojeny, _mbsnbcat připojí všechny bajty z src, až po znak null.Pokud je count větší než délka src, délka src se použije namísto count.Výsledný řetězec je ukončen znakem null.Pokud ke kopírování dojde mezi řetězci, které se překrývají, chování není definováno.

Výstupní hodnota je ovlivněna nastavením kategorie LC_CTYPE národního prostředí; viz setlocale pro další informace.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 stejná s tím rozdílem, že používá předaný parametr národního prostředí.Další informace naleznete v tématu Národní prostředí.

Bezpečnostní poznámka Použijte řetězec zakončený hodnotou null.Řetězec zakončený hodnotou null nesmí překročit velikost cílové vyrovnávací paměti.Další informace naleznete v tématu Předcházení přetečení vyrovnávací paměti.

Pokud dest nebo src je NULL, funkce generuje chybu neplatného parametru, jak je popsáno v Ověření parametru.Pokud je chyba zpracována, vrátí funkce EINVAL a nastaví errno na 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í zabezpečení šablony.

Rutinní mapování obecného textu