Partager via


_mbsnbcat, _mbsnbcat_l

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

Routine de Tchar.h

_UNICODE et non définis _MBCS

_MBCS défini

_UNICODE défini

_tcsncat

strncat

_mbsnbcat

wcsncat

_tcsncat_l

_strncat_l

_mbsnbcat_l

_wcsncat_l

Configuration requise

Routine

En-tête requis

_mbsnbcat

<mbstring.h>

_mbsnbcat_l

<mbstring.h>

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' Exemples d'appel de code non managé.

Voir aussi

Référence

Manipulation de chaînes (CRT)

_mbsnbcmp, _mbsnbcmp_l

_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l

_mbsnbcpy, _mbsnbcpy_l

_mbsnbicmp, _mbsnbicmp_l

_mbsnbset, _mbsnbset_l

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

_mbsnbcat_s, _mbsnbcat_s_l