strcspn, wcscspn, _mbscspn, _mbscspn_l

Article
03/26/2013

Retourne l'index de la première occurrence d'un caractère dans une chaîne qui appartient à un jeu de caractères.

Important

_mbschr et _mbschr_lne 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 strcspn(
   const char *str,
   const char *strCharSet 
);
size_t wcscspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbscspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbscspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

Paramètres

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

Valeur de retour

Ces fonctions retournent l'index du premier caractère de str qui est dans strCharSet.Si aucun des caractères dans str n'est dans strCharSet, la valeur de retour est la longueur d' str.

Aucune valeur de retour n'est réservée pour indiquer une erreur.

Notes

wcscspn et _mbscspn sont à caractères larges et des versions à caractères multioctets d' strcspn.Les arguments d' wcscspn sont des chaînes à caractères larges ; ces d' _mbscspn sont des chaînes de caractères multioctets.

_mbscspn valide ses paramètres.Si str ou strCharSet 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, la fonction retourne 0 et définit errno à EINVAL.strcspn et wcscspn 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
_tcscspn	strcspn	_mbscspn	wcscspn
n/a	n/a	_mbscspn_l	n/a

Configuration requise

Routine	En-tête requis
strcspn	<string.h>
wcscspn	<string.h> ou <wchar.h>
_mbscspn, _mbscspn_l	<mbstring.h>

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

Exemple

// crt_strcspn.c

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

void test( const char * str, const char * strCharSet )
{
   int pos = strcspn( str, strCharSet );
   printf( "strcspn( \"%s\", \"%s\" ) = %d\n", str, strCharSet, pos );    
}

int main( void )
{
   test( "xyzbxz", "abc" );
   test( "xyzbxz", "xyz" );
   test( "xyzbxz", "no match" );
   test( "xyzbxz", "" );
   test( "", "abc" );
   test( "", "" );
}