_mbccpy, _mbccpy_l

Copier un caractère multioctet d’une chaîne vers une autre chaîne. Des versions plus sécurisées de ces fonctions sont disponibles ; voir _mbccpy_s, _mbccpy_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 dans les applications de la plateforme Windows universelle.

Syntaxe

void _mbccpy(
   unsigned char *dest,
   const unsigned char *src
);
void _mbccpy_l(
   unsigned char *dest,
   const unsigned char *src,
   _locale_t locale
);

Paramètres

dest
Destination de la copie.

src
Caractère multioctet à copier.

locale
Paramètres régionaux à utiliser.

Notes

La fonction _mbccpy copie un caractère multioctet depuis src vers dest.

Cette fonction valide ses paramètres. Si _mbccpy un pointeur Null est passé pour dest ou src, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à se poursuivre, errno prend la valeur EINVAL.

_mbccpy utilise les paramètres régionaux actuels pour le comportement dépendant des paramètres régionaux. _mbccpy_l est identique à _mbccpy, à ceci près que _mbccpy_l utilise les paramètres régionaux passés pour tout comportement dépendant des paramètres régionaux. Pour plus d’informations, consultez Locale.

Remarque relative à la sécurité Utilisez une chaîne se terminant par un caractère Null. La chaîne ne doit pas dépasser la taille de la mémoire tampon de destination. Pour plus d’informations, consultez Éviter les dépassements de mémoire tampon. Les dépassements de mémoire tampon sont une méthode fréquente d'attaque du système, ce qui provoque une élévation des privilèges injustifiée.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routine de texte générique

Routine Tchar.h	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tccpy	Mappe à la macro ou à la fonction inline	_mbccpy	Mappe à la macro ou à la fonction inline
_tccpy_l	n/a	_mbccpy_l	n/a

Spécifications

Routine	En-tête requis
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Paramètres régionaux
Interprétation des séquences de caractères multioctets
_mbclen, mblen, _mblen_l