strspn, wcsspn, _mbsspn, _mbsspn_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

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

System_CAPS_ICON_important.jpg Important

_mbsspn et _mbsspn_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans 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.

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

Le strspn fonction retourne l’index du premier caractère dans str qui n’appartient pas au jeu de caractères de strCharSet. La recherche n’inclut pas la fin des caractères null.

wcsspnet _mbsspn sont des versions à caractères larges et à caractères multioctets de strspn . Les arguments de wcsspn sont des chaînes de caractères larges ; ceux de _mbsspn sont des chaînes de caractères multioctets. _mbsspnvalide ses paramètres. Si str ou strCharSet estNULL, le Gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre . Si l’exécution est autorisée à se poursuivre, _mbspn définit errno à EINVAL et retourne 0. strspn et wcsspn ne vérifient pas leurs paramètres. Ces trois fonctions se comportent sinon de façon identique.

La valeur de sortie est affectée par la définition de la LC_CTYPE catégorie de 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 Locale.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcsspnstrspn_mbsspnwcsspn
n/an/a_mbsspn_ln/a
RoutineEn-tête requis
strspn<string.h>
wcsspn<string.h> ou <wchar.h>
_mbsspn, _mbsspn_l<mbstring.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.

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

The portion of 'cabbage' containing only a, b, or c is 5 bytes long  

System::String::SUBSTRING

Manipulation de chaînes
Paramètres régionaux
Interprétation des séquences de caractères multioctets
_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l
strcspn, wcscspn, _mbscspn, _mbscspn_l
strncnt, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Afficher: