_strninc, _wcsninc, _mbsninc, _mbsninc_l

Article
06/09/2015

Avance un pointeur de chaîne de n caractères.

Important

_mbsninc et _mbsninc_l ne peuvent 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.

char *_strninc(
   const char *str,
   size_t count 
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);

Paramètres

str
Chaîne source.
count
Nombre de caractères à incrémenter un pointeur de chaîne.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Chacune de ces routines retourne un pointeur vers str après que str a été incrémenté par count caractères ou NULL si le pointeur fourni est NULL. Si count est supérieur ou égal au nombre de caractères de str, le résultat est indéfini.

Notes

La fonction _mbsninc incrémente str par count caractères multioctets . _mbsninc identifie des séquences de caractères multioctets selon la page de codes multioctets en cours d'utilisation.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc et _wcsninc sont des versions de _mbsninc traitant des chaînes de caractères sur un seul octet et à caractères élargis respectivement. _wcsninc et _strninc sont fournis uniquement pour ce mappage et ne doivent pas être utilisés sinon. Pour plus d'informations, consultez Utilisation des mappages de texte générique et Mappages de texte générique.

_mbsninc_l est identique sauf qu'il utilise à la place les paramètres régionaux qui sont passés. Pour plus d'informations, consultez Paramètres régionaux.