_mbsnbcat, _mbsnbcat_l

Articolo
03/26/2013

Aggiungere, al massimo, il primo byte di n di una stringa di caratteri multibyte a un altro.Più versioni sicure di queste funzioni sono disponibili, vedere _mbsnbcat_s, _mbsnbcat_s_l.

Importante
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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

Parametri

dest
Stringa di destinazione con caratteri multibyte con terminazione null.
src
Stringa di origine con caratteri multibyte con terminazione null.
count
Numero di byte da src da aggiungere a dest.
locale
Impostazioni locali da utilizzare.

Valore restituito

_mbsnbcat restituisce un puntatore alla stringa di destinazione.Nessun valore restituito è riservato per indicare un errore.

Note

La funzione di _mbsnbcat accodamento, al massimo, il primo byte di count di src a dest.Se il byte immediatamente prima del carattere null in dest è un byte iniziale, il byte iniziale di src sovrascrive il byte iniziali.In caso contrario, il byte iniziale di src sovrascrive il carattere di terminazione null di dest.Se un byte null visualizzato in src prima che i byte di count vengano aggiunti, _mbsnbcat aggiunge tutti i byte di src, fino al carattere null.Se count è maggiore della lunghezza di src, la lunghezza di src viene utilizzata al posto di count.La stringa di risultato termina con un carattere null.Se copiare è compresa tra stringhe che si sovrappongono, il comportamento è definito.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria LC_CTYPE delle impostazioni locali; vedere setlocale per ulteriori informazioni.La versione di _mbsnbcat della funzione utilizza le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali; la versione di _mbsnbcat_l è identica con la differenza che utilizzano il parametro delle impostazioni locali passato.Per ulteriori informazioni, vedere Impostazioni locali.

Security Note Utilizza una stringa con terminazione null.La stringa con terminazione null non deve superare la dimensione del buffer di destinazione.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

Se dest o src è NULL, la funzione genera un errore non valido di parametro, come descritto in Convalida dei parametri.Se l'errore viene gestito, la funzione restituisce EINVAL e imposta errno a EINVAL.

In C++, queste funzioni hanno modelli di overload che invocano le più recenti, controparti sicure di queste.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a Testo generico