Nous recommandons d’utiliser Visual Studio 2017

_mbsnbcat, _mbsnbcat_l

 

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

Ajoute, au plus, le premier n octets d’une chaîne de caractères multioctets à un autre. Des versions plus sécurisées de ces fonctions sont disponibles. consultez la page _mbsnbcat_s, _mbsnbcat_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 *_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  

Paramètres

dest
Chaîne de destination à caractères multioctets se terminant par un caractère null.

src
Chaîne source à caractères multioctets se terminant par un caractère null.

count
Nombre d'octets de src à ajouter à dest.

locale
Paramètres régionaux à utiliser.

_mbsnbcatRetourne un pointeur vers la chaîne de destination. Aucune valeur de retour n'est réservée pour indiquer une erreur.

Le _mbsnbcat fonction ajoute au maximum, la première count octets de src à dest. Si l’octet qui précède immédiatement le caractère null dans dest est un octet de tête, l’octet initial de src remplace cet octet de tête. Dans le cas contraire, l'octet initial de src remplace le caractère null de fin de dest. Si un octet null apparaît dans src avant count octets sont ajoutés, _mbsnbcat ajoute tous les octets à partir de src, jusqu’au caractère null. Si la valeur count est supérieure à la longueur de src, la longueur de src est utilisée à la place de count. La chaîne qui en résulte se termine par un caractère null. Si la copie se produit entre des chaînes qui se chevauchent, le comportement est indéfini.

La valeur de sortie est affectée par la définition de la LC_CTYPE catégorie de paramètres régionaux ; consultez setlocale pour plus d’informations. Le _mbsnbcat version de la fonction utilise les paramètres régionaux actuels pour ce comportement dépendant des paramètres régionaux ; la _mbsnbcat_l version est identique, sauf qu’ils utilisent les paramètres régionaux passés à la place. Pour plus d’informations, consultez Locale.

Note de sécurité utilisent une chaîne terminée par null. La chaîne ne doit pas dépasser la taille de la mémoire tampon de destination. Pour plus d’informations, consultez Solutions contre les dépassements de mémoire tampon.

Si dest ou src est NULL, la fonction génère une erreur de paramètre non valide, comme décrit dans Validation de paramètre. Si l'erreur est gérée, la fonction retourne EINVAL et attribue à errno la valeur EINVAL.

En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et 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
_tcsncatstrncnt_mbsnbcatwcsncat
_tcsncat_l_strncat_l_mbsnbcat_l_wcsncat_l
RoutineEn-tête requis
_mbsnbcat<mbstring.h>
_mbsnbcat_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
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbicmp, _mbsnbicmp_l
_mbsnbset, _mbsnbset_l
strncnt, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
_mbsnbcat_s, _mbsnbcat_s_l

Afficher: