_mbsnbcat _mbsnbcat_l

Článek
03/26/2013

Připojit maximálně první n bajtů jeden řetězec vícebajtových znaků do jiného.Bezpečnější verze tyto funkce jsou k dispozici; see _mbsnbcat_s _mbsnbcat_s_l.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v systému 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
Řetězec zakončený hodnotou Null cílové vícebajtové znaky.
src
Zdroj zakončený vícebajtové znakové řetězce.
count
Počet bajtů od src připojit k dest.
locale
Chcete-li národní prostředí pro použití.

Vrácená hodnota

_mbsnbcatvrací ukazatel na řetězec cílové.Žádné vrácená hodnota je vyhrazena udávající chybu.

Poznámky

_mbsnbcat Funkce připojí nanejvýš první count bajtů src na 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.V opačném případě se úvodní bajt src přepíše ukončující znak null z dest.Je-li nulový bajt se objeví v src před count bajty jsou připojeny, _mbsnbcat připojí všechny bajty z src, až znakem null.Pokud count je větší než délka src, délka src je použito místo count.Výsledný řetězec je ukončen znakem null.Pokud kopírování probíhá mezi řetězce, které se překrývají, chování není definován.

Výstupní hodnota je ovlivněna nastavením LC_CTYPE kategorie nastavení národního prostředí; Viz setlocale pro další informace._mbsnbcat Verze funkce používá aktuální národní prostředí pro toto chování závislé na národním prostředí; _mbsnbcat_l verze je totožný s tím rozdílem, že používají místo něho předán parametr locale.Další informace naleznete v tématu Národní prostředí.

Poznámka: zabezpečení použít řetězec zakončený hodnotou null.Řetězec zakončený hodnotou null, nesmí přesáhnout velikost cílové vyrovnávací paměti.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.

Pokud dest nebo src je NULL, funkce bude generovat chybu neplatného parametru, jak je popsáno v Ověření parametrů.Pokud chyba zpracována, vrátí funkce EINVAL a errno na EINVAL.

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

Mapování rutiny obecného textu