_mbsnbcpy, _mbsnbcpy_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Copie n octets d'une chaîne dans une chaîne de destination. Des versions plus sécurisées de ces fonctions sont disponibles, consultez la page _mbsnbcpy_s, _mbsnbcpy_s_l.

System_CAPS_ICON_important.jpg Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime. Pour plus d’informations, consultez fonctions CRT non prises en charge avec /ZW.

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  

Paramètres

strDest
Destination de la chaîne de caractères à copier.

strSource
Chaîne de caractères à copier.

count
Nombre d'octets à copier.

locale
Paramètres régionaux à utiliser.

_mbsnbcpy retourne un pointeur désignant la chaîne de caractères de destination. Aucune valeur de retour n'est réservée pour indiquer une erreur.

La fonction _mbsnbcpy copie count octets de strSource vers strDest. Si count est supérieur à la taille de strDest ou que les chaînes source et de destination se chevauchent, le comportement de _mbsnbcpy n'est pas défini.

Si strSource ou strDest est un pointeur null, cette fonction appelle le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à continuer, cette fonction retourne NULL et définit à errno à EINVAL.

La valeur de sortie est affectée par la définition de la LC_CTYPE catégorie de paramètres régionaux ; consultez setlocale, _wsetlocale pour plus d’informations. Les versions de ces fonctions sont identiques, à ceci près que celles qui n'ont pas le suffixe _l utilisent les paramètres régionaux actifs et celles qui ont le suffixe _l utilisent plutôt les paramètres régionaux qui sont passés. Pour plus d’informations, consultez Locale.

System_CAPS_ICON_important.jpg Important

Ces fonctions peuvent être vulnérables aux menaces de dépassement de mémoire tampon. Les dépassements de mémoire tampon peuvent servir à exécuter du code arbitraire émanant d'une personne malveillante, ce qui peut se traduire par une élévation de privilèges injustifiée et compromettre le système. Pour plus d’informations, consultez Solutions contre les dépassements de mémoire tampon.

En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et plus sécurisés de ces fonctions. Pour plus d'informations, consultez Secure Template Overloads.

Mappages de routines de texte générique

Routine Tchar.h_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcsncpystrncpy_mbsnbcpywcsncpy
_tcsncpy_l_strncpy_l_mbsnbcp_l_wcsncpy_l
RoutineEn-tête requis
_mbsnbcpy<mbstring.h>
_mbsnbcpy_l<mbstring.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Manipulation de chaînes
_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

Afficher: