_mbsnbcat, _mbsnbcat_l

Articolo
06/09/2015

Aggiunge, al massimo, il primo byte n di una stringa di caratteri multibyte ad un altro. Sono disponibili versioni più sicure di queste funzioni; 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 a caratteri multibyte con terminazione null.
src
Stringa di origine con caratteri multibyte con terminazione null.
count
Numero di byte della 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 _mbsnbcat aggiunge, al massimo, il primo byte count src a dest. Se il byte immediatamente prima del carattere null in dest è un byte di apertura, il byte iniziale di src sovrascrive il byte di apertura. In caso contrario, il byte iniziale src sovrascrive il carattere di terminazione null di dest. Se un byte null viene visualizzato in src prima che il byte count vengano aggiunti, _mbsnbcat aggiunge tutti i byte da src fino al carattere null. Se count è maggiore della lunghezza di src, la lunghezza src viene utilizzata al posto 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 di categoria LC_CTYPE delle impostazioni locali; vedere setlocale per ulteriori informazioni. La versione _mbsnbcat della funzione utilizza le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali; la versione _mbsnbcat_l è identica ad eccezione che utilizza il parametro delle impostazioni locali che gli sono state passate. Per ulteriori informazioni, vedere Impostazioni locali.

Nota sulla sicurezza 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 di parametro non valido, come descritto in Convalida dei parametri. Se l'errore viene gestito, la funzione restituisce EINVAL e imposta errno a EINVAL.

In C++, queste funzioni presentano overload dei modelli che richiamano le relative controparti sicure e più recenti. Per ulteriori informazioni, vedere Overload di modelli sicuri.

Mapping di routine su testo generico