_mbsnbcat, _mbsnbcat_l

Article
03/26/2013

Ajoutez, au plus, les premiers octets d' n d'une chaîne de caractères multioctets à un autre.Les versions sécurisées de ces fonctions sont disponibles ; consultez _mbsnbcat_s, _mbsnbcat_s_l.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.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 null.
src
Chaîne à caractères multioctets se terminant par null source.
count
Nombre d'octets d' src à ajouter à dest.
locale
Paramètres régionaux à utiliser.

Valeur de retour

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

Notes

La fonction d' _mbsnbcat ajoute, au plus, les premiers octets d' count d' src à dest.Si l'octet juste avant le caractère Null dans dest est un octet de tête, l'octet initial d' src remplace l'octet de tête.Sinon, l'octet initial d' src remplace le caractère NULL de fin d' dest.Si un octet null apparaît dans src avant que les octets d' count soient ajoutés, _mbsnbcat ajoute tous les octets d' src, jusqu'au caractère Null.Si count est supérieur à la longueur d' src, la longueur d' src est utilisée à la place d' count.La chaîne résultante est terminée avec un caractère Null.Si copier nécessaire entre les chaînes qui se chevauchent, le comportement est pas défini.

La valeur de sortie est affectée par la configuration de la définition de catégorie d' LC_CTYPE des paramètres régionaux ; consultez l' setlocale pour plus d'informations.La version d' _mbsnbcat de la fonction utilise les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; la version d' _mbsnbcat_l est identique à la différence qu'ils utilisent le paramètre de paramètres régionaux passé à la place.Pour plus d'informations, consultez Paramètres régionaux.

Utilisation deSecurity Note une chaîne terminée par le caractère NULL.La chaîne terminée par le caractère NULL ne doit pas dépasser la taille de la mémoire tampon de destination.Pour plus d'informations, consultez l' 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 des paramètres.Si l'erreur est gérée, la fonction retourne EINVAL et définit errno à EINVAL.

En C++, ces fonctions ont des surcharges de modèle qui appellent le plus récent, fixent des équivalents de ces fonctions.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

Mappages de routines de texte générique