_mbsnbcpy, _mbsnbcpy_l

Copia n byte di una stringa in una stringa di destinazione. Sono disponibili versioni più sicure di queste funzioni. Vedere _mbsnbcpy_s, _mbsnbcpy_s_l.

Sintassi

unsigned char * _mbsnbcpy(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count
);
unsigned char * _mbsnbcpy_l(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char * _mbsnbcpy(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count
); // C++ only
template <size_t size>
unsigned char * _mbsnbcpy_l(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
); // C++ only

Parametri

strDest
Destinazione per la stringa di caratteri da copiare.

strSource
Stringa di caratteri da copiare.

count
Numero di byte da copiare.

locale
Impostazioni locali da usare.

Valore restituito

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

Osservazioni:

La funzione _mbsnbcpy copia count byte da strSource a strDest. Se count supera la dimensione di strDest o le stringhe di origine e destinazione si sovrappongono, il comportamento di _mbsnbcpy è indefinito.

Se strSource o strDest è un puntatore Null, questa funzione richiama il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce NULL e imposta errno su EINVAL.

Il valore di output è interessato dall'impostazione dell'impostazione LC_CTYPE della categoria delle impostazioni locali. Per ulteriori informazioni, vedere setlocale. Le versioni di queste funzioni sono identiche, ad eccezione del fatto che quelle che non hanno il _l suffisso usano le impostazioni locali correnti e le versioni con il _l suffisso usano invece il parametro delle impostazioni locali passato. Per altre informazioni, vedere Locale.

In C++, queste funzioni presentano overload di modello che richiamano le relative controparti più sicure e più recenti. 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

Requisiti

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

Vedi anche

Manipolazione delle stringhe
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt_mbsnccnt_l
_mbsnbset, _mbsnbset_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy_mbsncpy_l