_mbsnbcat_s, _mbsnbcat_s_l
Ajoute à une chaîne de caractères multioctets, au plus, les premiers octets d' n d'une autre chaîne de caractères multioctets.Ce sont des versions de _mbsnbcat, _mbsnbcat_l qui ont des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité du CRT.
Important
Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.
errno_t _mbsnbcat_s(
unsigned char *dest,
size_t sizeInBytes,
const unsigned char *src,
size_t count
);
errno_t _mbsnbcat_s_l(
unsigned char *dest,
size_t sizeInBytes,
const unsigned char *src,
size_t count,
_locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
unsigned char (&dest)[size],
const unsigned char *src,
size_t count
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_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.sizeInBytes
Taille de la mémoire tampon d' dest en octets.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
Zéro si l'opération a réussi ; sinon, le code d'erreur.
Conditions d'erreur
Dest |
sizeInBytes |
src |
Valeur de retour |
---|---|---|---|
NULL |
any |
any |
EINVAL |
Any |
<= 0 |
any |
EINVAL |
Any |
any |
NULL |
EINVAL |
Si les conditions d'erreur l'une des cas, 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.
Notes
La fonction d' _mbsnbcat_s ajoute à dest, au plus, les premiers octets d' count d' src.Si l'octet qui précède immédiatement le caractère Null dans dest est un octet de tête, il est remplacé par l'octet initial d' src.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_s 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 effectuée par 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 setlocale, _wsetlocale pour plus d'informations.Les versions de ces fonctions sont identiques, mais que celles qui n'ont pas l'utilisation de suffixe d' _l les paramètres régionaux et ceux qui font utiliser le suffixe d' _l à la place le paramètre de paramètres régionaux qui est passé.Pour plus d'informations, consultez Paramètres régionaux.
En C++, l'utilisation de ces fonctions est simplifiée par des surcharges de modèle ; les surcharges peuvent également déduire la longueur de la mémoire tampon automatiquement et éviter ainsi le besoin de spécifier un argument de taille, et peuvent utiliser automatiquement les plus récentes, plus sécurisées fonctions pour substituer les fonctions plus anciennes et inférieur sécurisées.Pour plus d'informations, consultez Surcharges sécurisées de modèle.
Les versions debug de ces fonctions exécutent d'abord mémoire tampon de 0xFD.Pour désactiver ce comportement, utilisez _CrtSetDebugFillThreshold.
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 |
_mbsnbcat_s |
||
_tcsncat_s_l |
_strncat_s_l |
_mbsnbcat_s_l |
_wcsncat_s_l |
Configuration requise
Routine |
En-tête requis |
---|---|
_mbsnbcat_s |
<mbstring.h> |
_mbsnbcat_s_l |
<mbstring.h> |
Pour plus d'informations de 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 code non managé.
Voir aussi
Référence
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l
strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l