_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Article
03/26/2013

Définit les caractères d'une chaîne à un seul caractère.Les versions sécurisées de ces fonctions sont disponibles ; consultez _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Important

_mbsset et _mbsset_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

char *_strset(
   char *str,
   int c 
);
char *_strset_l(
   char *str,
   int c,
   locale_t locale
);
wchar_t *_wcsset(
   wchar_t *str,
   wchar_t c 
);
wchar_t *_wcsset_l(
   wchar_t *str,
   wchar_t c,
   locale_t locale
);
unsigned char *_mbsset(
   unsigned char *str,
   unsigned int c 
);
unsigned char *_mbsset_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
);

Paramètres

str
Chaîne terminée par le caractère NULL à définir.
c
Configuration de caractère.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Retourne un pointeur vers une chaîne modifiée.

Notes

La fonction d' _strset définit tous les caractères (à l'exception de le caractère NULL de fin) d' str à c, converti en char._wcsset et _mbsset_l sont à caractères larges et des versions à caractères multioctets d' _strset, et les types de données des arguments et des valeurs de retour varient en conséquence.Ces fonctions se comportent de sinon.

_mbsset valide ses paramètres.Si str est un pointeur null, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer,_mbsset retourne NULL et définit errno à EINVAL._strset et _wcsset ne valident pas leurs paramètres.

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.

Note de sécurité
Ces fonctions peuvent être vulnérables aux menaces de dépassement de mémoire tampon.Les dépassements de mémoire tampon peuvent être utilisés pour les attaques de système car ils peuvent provoquer une élévation de privilège injustifiée.Pour plus d'informations, consultez l' Solutions contre les dépassements de mémoire tampon.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Configuration requise

Routine	En-tête requis
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> ou <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Pour des informations de compatibilité supplémentaires, consultez Compatibilité.

Exemple

// crt_strset.c
// compile with: /W3

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset( string, '*' ); // C4996
   // Note: _strset is deprecated; consider using _strset_s instead
   printf( "After:  %s\n", string );
}