_mbsnbcat, _mbsnbcat_l

Aggiunge al massimo i primi n byte di una stringa di caratteri multibyte a un'altra. Sono disponibili versioni più sicure di queste funzioni; vedere _mbsnbcat_s, _mbsnbcat_s_l.

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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 di caratteri multibyte con terminazione Null.

src
Stringa di origine di caratteri multibyte con terminazione Null.

count
Numero di byte src da aggiungere a dest.

locale
Impostazioni locali da usare.

Valore restituito

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

Osservazioni:

La funzione _mbsnbcat aggiunge a dest, al massimo, i primi count byte di src. Se il byte immediatamente prima del carattere Null in dest è un byte di apertura, il byte iniziale di src sovrascrive questo byte di apertura. In caso contrario, il byte iniziale di src sovrascrive il carattere di terminazione Null di dest. Se un byte null viene visualizzato in src prima che count byte vengano aggiunti, _mbsnbcat aggiunge tutti i byte da src fino al carattere null. Se count è maggiore della lunghezza di src, la lunghezza di src viene usata invece di count. La stringa risultante termina con un carattere Null. Se la copia avviene tra stringhe che si sovrappongono, il comportamento non è definito.

Il valore di output è interessato dall'impostazione dell'impostazione LC_CTYPE della categoria delle impostazioni locali. Per ulteriori informazioni, vedere setlocale. La versione _mbsnbcat della funzione usa le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali. La versione _mbsnbcat_l è identica, ad eccezione del fatto che usa il parametro delle impostazioni locali passato. Per altre informazioni, vedere Locale.

Nota sulla sicurezza Usare una stringa con terminazione Null. Le dimensioni della stringa con terminazione Null non devono essere superiori a quelle del buffer di destinazione. Per altre informazioni, vedere Evitare sovraccarichi del buffer.

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

In C++ queste funzioni presentano overload di modello che richiamano le relative controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

Requisiti

Ciclo	Intestazione obbligatoria
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

Manipolazione delle stringhe
_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