strspn, wcsspn, _mbsspn, _mbsspn_l

Article
03/26/2013

Retourne l'index du premier caractère dans une chaîne qui n'appartient pas à un jeu de caractères.

Important

_mbsspn et _mbsspn_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

size_t strspn(
   const char *str,
   const char *strCharSet 
);
size_t wcsspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbsspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbsspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

Paramètres

str
Chaîne terminée par le caractère NULL à trouver.
strCharSet
Jeu de caractères se terminant par null.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Retourne une valeur entière spécifiant la longueur de la sous-chaîne dans str qui se compose entièrement composée de caractères dans strCharSet*.* Si str commence par un caractère pas dans strCharSet*,* retourne 0 de fonction.

Notes

La fonction d' strspn retourne l'index du premier caractère de str qui n'appartient pas au jeu de caractères dans strCharSet.La recherche ne contient pas les caractères NULL de fin.

wcsspn et _mbsspn sont à caractères larges et des versions à caractères multioctets d' strspn**.** Les arguments d' wcsspn sont des chaînes à caractères larges ; ces d' _mbsspn sont des chaînes de caractères multioctets._mbsspn valide ses paramètres.Si str ou strCharSet estNULL, 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, _mbspn définit errno à EINVAL et retourne 0.strspn et wcsspn ne valident pas leurs paramètres.Ces trois fonctions se comportent de sinon.

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 l' setlocale pour plus d'informations.Les versions de ces fonctions sans suffixe d' _l utilisent les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; les versions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé à la place.Pour plus d'informations, consultez Paramètres régionaux.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_tcsspn	strspn	_mbsspn	wcsspn
N/A	N/A	_mbsspn_l	N/A

Configuration requise

Routine	En-tête requis
strspn	<string.h>
wcsspn	<string.h> ou <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.

Exemple

// crt_strspn.c
// This program uses strspn to determine
// the length of the segment in the string "cabbage"
// consisting of a's, b's, and c's. In other words,
// it finds the first non-abc letter.
//

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

int main( void )
{
   char string[] = "cabbage";
   int  result;
   result = strspn( string, "abc" );
   printf( "The portion of '%s' containing only a, b, or c "
           "is %d bytes long\n", string, result );
}