strspn, wcsspn, _mbsspn, _mbsspn_l

Article
06/09/2015

Retourne l'index du premier caractère, dans une chaîne, qui ne fait pas partie d'un jeu de caractères.

Important

_mbsspn et _mbsspn_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.

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 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 représentent exclusivement des caractères dans strCharSet*.* Si str commence par un caractère pas dans strCharSet*,* la fonction retourne 0.

Notes

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

wcsspn et _mbsspn sont des versions à caractères larges et à caractères multi-octets de strspn**.** Les arguments de wcsspn sont des chaînes à caractères larges ; ceux de _mbsspn sont des chaînes de caractères multi-octets. _mbsspn valide ses paramètres. Si str ou strCharSet est NULL, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre . Si l'exécution est autorisée à se poursuivre, _mbspn renvoie 0 et attribue à errno la valeur EINVAL. strspn et wcsspn ne valident pas leurs paramètres. Ces trois fonctions se comportent sinon de façon identique.

La valeur de la sortie est affectée par la valeur du paramètre de la catégorie LC_CTYPE des paramètres régionaux ; consultez setlocale, pour plus d'informations. Les versions de ces fonctions sans le suffixe _l utilisent les paramètres régionaux pour ce comportement dépendant des paramètres régionaux ; les versions avec le suffixe _l sont identiques, sauf qu'elles utilisent à la place les paramètres régionaux transmis. Pour plus d'informations, consultez Paramètres régionaux.

Mappages de routines de texte générique

Routine TCHAR.H	_UNICODE & _MBCS non définis	_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 plus d'informations sur la compatibilité, consultez Compatibilité.

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 );
}