Partager via


_mbsnbcat, _mbsnbcat_l

Ajoutez, au plus, les premiers n octets d'une chaîne de caractères multioctets dans une autre. Des versions plus 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 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 null.

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

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

  • locale
    Paramètres régionaux à utiliser.

Valeur de retour

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

Notes

La fonction _mbsnbcat ajoute, au plus, les premiers octets count de src à dest. Si l'octet juste avant le caractère Null dans dest est un octet de tête, l'octet initial de src remplace cet octet de tête. Sinon, l'octet initial de src remplace le caractère null de fin de dest. Si un octet Null apparaît dans src avant que des octets count soient ajoutés, _mbsnbcat ajoute tous les octets de src, jusqu'au caractère Null. Si count est supérieur à la longueur de src, la longueur de src est utilisée au lieu de count. La chaîne résultante est terminée 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 la sortie est affectée par la valeur du paramètre de la catégorie LC_CTYPE des paramètres régionaux ; consultez setlocale, pour plus d'informations. La version _mbsnbcat de cette fonction utilise les paramètres régionaux actuels pour ce comportement dépendant des paramètres régionaux; la version _mbsnbcat_l est identique à part qu'elle utilise les paramètres régionaux passés à place. Pour plus d'informations, consultez Paramètres régionaux.

Security Note Utilisez 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 Solutions contre les dépassements de mémoire tampon.

Si dest ou src est NULL, la fonction générera une erreur de paramètre non valide, comme décrit dans Validation de paramètre. Si l'erreur est gérée, cette fonction retourne EINVAL et affecte errno à 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 Sécuriser les surcharges de modèle.

Mappages de routines de texte générique

Routine Tchar.h

_UNICODE et _MBCS non définis

_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 sur la compatibilité, consultez Compatibilité.

Équivalent .NET Framework

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

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