_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. Consultez _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 Solutions contre 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 routines de texte générique
Routine Tchar.h | _UNICODE et _MBCS non définis |
_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