_mbsnbcat, _mbsnbcat_l

Artykuł
03/26/2013

Dołączyć, co najwyżej pierwszy n bajtów ciąg znaków wielobajtowych.Bezpieczniejsze wersje te funkcje są dostępne; see _mbsnbcat_s, _mbsnbcat_s_l.

Ważne
Ten interfejs API nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /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
Ciąg zakończony wartością zerową przeznaczenia znaków wielobajtowych.
src
Ciąg zakończony wartością zerową źródła znaków wielobajtowych.
count
Liczba bajtów z src Aby dołączyć do dest.
locale
Ustawienia regionalne używane.

Wartość zwracana

_mbsnbcatZwraca wskaźnik do ciągu docelowego.Nie zwraca żadnej wartości jest zarezerwowany wystąpił błąd.

Uwagi

_mbsnbcat Funkcja dołącza co najwyżej pierwszy count bajtów src do dest.Jeśli bajt bezpośrednio przed znakiem null w dest jest wiodącego bajtu początkowego bajt src zastępuje ten bajt wiodący.W przeciwnym razie bajtu początkowego src zastępuje kończącego znaku null z dest.Jeśli się bajtem null pojawia się w src przed count bajty są dołączane, _mbsnbcat dołącza wszystkie bajty z src, do znaku null.Jeśli count jest większa niż długość src, długość src jest używana zamiast count.Wynikowy ciąg znaków jest zakończony znakiem null.Jeśli kopiowanie odbywa się między ciągami, które nakładają się, zachowanie jest niezdefiniowane.

Wartość produkcji jest zależny od ustawienia z LC_CTYPE kategorii ustawienie regionalne tzn. zobacz setlocale Aby uzyskać więcej informacji._mbsnbcat Wersję tej funkcji używa bieżących ustawień regionalnych tego zachowania zależne od ustawień lokalnych; _mbsnbcat_l wersji jest identyczny z tym, że używają zamiast przekazany parametr ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Uwaga zabezpieczeń ciąg zakończony znakiem null.Ciąg zakończony znakiem null, nie może przekraczać rozmiaru bufora docelowego.Aby uzyskać więcej informacji, zobacz Unikanie przekroczeniem buforu.

Jeśli dest lub src jest NULL, funkcja wygeneruje błąd nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli ten błąd jest obsługiwane, funkcja zwraca EINVAL i ustawia errno do EINVAL.

W języku C++ te funkcje mają overloads szablonu, które wywołują odpowiednikami nowych, bezpiecznych funkcji.Aby uzyskać więcej informacji, zobacz Secure, szablon Overloads.

Tekst rodzajowy rutynowych mapowania