Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

_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.

Remarque importante 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

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.

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

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

Routine

En-tête requis

_mbsnbcat

<mbstring.h>

_mbsnbcat_l

<mbstring.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft